Utiliser des montages de stockage dans Azure Container Apps

Quand vous configurez un stockage à l’échelle du réplica à l’aide d’Azure CLI, vous devez utiliser une définition YAML pour créer ou mettre à jour votre application conteneur.

1. Pour mettre à jour une application conteneur existante pour utiliser le stockage à portée de réplique, exportez la spécification de votre application vers un fichier YAML nommé app.yaml.

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

2. Apportez les modifications suivantes à la spécification de votre application conteneur.

   • Ajoutez un tableau volumes à la section template de votre définition d’application conteneur et définissez un volume. Si vous disposez déjà d’un tableau volumes, ajoutez un nouveau volume au tableau.
     • name correspond à un identificateur pour le volume.
     • Utilisez EmptyDir comme storageType.
   • Pour chaque conteneur du modèle où vous souhaitez monter le volume, définissez un montage de volume dans le tableau volumeMounts de la définition de conteneur.
     • volumeName correspond au nom défini dans le tableau volumes.
     • mountPath correspond au chemin dans le conteneur où monter le volume.

   properties:
     managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
     configuration:
       activeRevisionsMode: Single
     template:
       containers:
       - image: <IMAGE_NAME1>
         name: my-container-1
         volumeMounts:
         - mountPath: /myempty
           volumeName: myempty
       - image: <IMAGE_NAME_2>
         name: my-container-2
         volumeMounts:
         - mountPath: /myempty
           volumeName: myempty
       volumes:
       - name: myempty
         storageType: EmptyDir
   

3. Mettez à jour votre application conteneur à l’aide du fichier YAML.

   az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
       --yaml app.yaml
   

Consultez la spécification YAML pour obtenir un exemple complet.

Pour créer un volume à l’échelle d’un réplica et le monter dans un conteneur, apportez les changements suivants à la ressource d’applications conteneur dans un modèle ARM :

• Ajoutez un tableau volumes à la section template de votre définition d’application conteneur et définissez un volume. Si vous disposez déjà d’un tableau volumes, ajoutez un nouveau volume au tableau.
  • name correspond à un identificateur pour le volume.
  • Utilisez EmptyDir comme storageType.
• Pour chaque conteneur du modèle où vous souhaitez monter le volume, définissez un montage de volume dans le tableau volumeMounts de la définition de conteneur.
  • volumeName correspond au nom défini dans le tableau volumes.
  • mountPath correspond au chemin dans le conteneur où monter le volume.

Exemple d’extrait de modèle ARM :

{
  "apiVersion": "2022-03-01",
  "type": "Microsoft.App/containerApps",
  "name": "[parameters('containerappName')]",
  "location": "[parameters('location')]",
  "properties": {

    ...

    "template": {
      "revisionSuffix": "myrevision",
      "containers": [
        {
          "name": "main",
          "image": "[parameters('container_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        },
        {
          "name": "sidecar",
          "image": "[parameters('sidecar_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "myempty",
          "storageType": "EmptyDir"
        }
      ]
    }
  }
}

Consultez la spécification de l’API de modèle ARM pour obtenir un exemple complet.

Pour créer un volume à l’échelle d’un réplica et le monter dans un conteneur, déployez une nouvelle révision de votre application conteneur à l’aide du portail Azure.

1. Dans le portail Azure, accédez à votre application conteneur.

2. Sélectionnez Gestion des révisions dans le menu de gauche.

3. Sélectionnez Créer une révision.

4. Sélectionnez le conteneur où vous souhaitez monter le volume.

5. Dans le volet Modifier un conteneur, sélectionnez l’onglet Montages de volume.

6. Sous la section stockage éphémère , créez un volume avec les informations suivantes.

   • Nom du volume : nom du volume éphémère.
   • Chemin d’accès du montage : chemin d’accès absolu dans le conteneur pour monter le volume.

7. Sélectionnez Enregistrer pour enregistrer les modifications et quitter le volet contextuel.

8. Sélectionnez Créer pour créer la nouvelle révision.

Quand vous configurez une application conteneur afin de monter un volume Azure Files à l’aide d’Azure CLI, vous devez utiliser une définition YAML pour créer ou mettre à jour votre application conteneur.

Pour obtenir un didacticiel pas à pas sur le montage d’un partage de fichiers SMB, consultez Créer un montage de stockage Azure Files dans Azure Container Apps.

1. Ajoutez une définition de stockage à votre environnement Container Apps.

   • SMB
   • NFS

   az containerapp env storage set --name my-env --resource-group my-group \
       --storage-name mystorage \
       --storage-type AzureFile \
       --azure-file-account-name <STORAGE_ACCOUNT_NAME> \
       --azure-file-account-key <STORAGE_ACCOUNT_KEY> \
       --azure-file-share-name <STORAGE_SHARE_NAME> \
       --access-mode ReadWrite
   

   Remplacez <STORAGE_ACCOUNT_NAME> et <STORAGE_ACCOUNT_KEY> par le nom et la clé de votre compte de stockage. Remplacez <STORAGE_SHARE_NAME> par le nom du partage de fichiers dans le compte de stockage.

   Les valeurs valides pour --access-mode sont ReadWrite et ReadOnly.

2. Pour mettre à jour une application conteneur existante pour monter un partage de fichiers, exportez la spécification de votre application vers un fichier YAML nommé app.yaml.

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

3. Apportez les modifications suivantes à la spécification de votre application conteneur.

   • Ajoutez un tableau volumes à la section template de votre définition d’application conteneur et définissez un volume. Si vous disposez déjà d’un tableau volumes, ajoutez un nouveau volume au tableau.
     • name correspond à un identificateur pour le volume.
     • Pour storageType, utilisez AzureFile pour SMB, ou NfsAzureFile pour NFS. Cette valeur doit correspondre au type de stockage que vous avez défini dans l’environnement.
     • Pour storageName, utilisez le nom du stockage que vous avez défini dans l’environnement.
     • mountOptions est une chaîne de caractères séparée par des virgules d’options de montage. Pour plus d’informations, consultez Utiliser les paramètres mountOptions dans Azure Files.
     • La liste secrets est une liste de secrets à monter dans le volume. Pour plus d’informations, consultez Monter des secrets dans un volume.
   • Pour chaque conteneur du modèle où vous souhaitez monter le stockage Azure Files, définissez un montage de volume dans le tableau volumeMounts de la définition de conteneur.
     • volumeName correspond au nom défini dans le tableau volumes.
     • mountPath correspond au chemin dans le conteneur où monter le volume.
     • subPath est le chemin d’accès dans le volume à monter. S’il n’est pas spécifié, la racine du volume est montée. Pour plus d’informations, consultez (#sub-path).
   • SMB
   • NFS

   properties:
     managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
     configuration:
     template:
       containers:
       - image: <IMAGE_NAME>
         name: my-container
         volumeMounts:
         - volumeName: azure-files-volume
           mountPath: /my-files
           subPath: my-sub-path
       volumes:
       - name: azure-files-volume
         storageType: AzureFile
         storageName: mystorage
   

4. Mettez à jour votre application conteneur à l’aide du fichier YAML.

   az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
       --yaml app.yaml
   

Consultez la spécification YAML pour obtenir un exemple complet.

Les extraits de modèle ARM suivants montrent comment ajouter un partage Azure Files à un environnement Container Apps afin de l’utiliser dans une application conteneur.

1. Ajoutez une ressource enfant storages à l’environnement Container Apps.

   • SMB
   • NFS

   {
     "type": "Microsoft.App/managedEnvironments",
     "apiVersion": "2022-03-01",
     "name": "[parameters('environment_name')]",
     "location": "[parameters('location')]",
     "properties": {
       "daprAIInstrumentationKey": "[parameters('dapr_ai_instrumentation_key')]",
       "appLogsConfiguration": {
         "destination": "log-analytics",
         "logAnalyticsConfiguration": {
           "customerId": "[parameters('log_analytics_customer_id')]",
           "sharedKey": "[parameters('log_analytics_shared_key')]"
         }
       }
     },
     "resources": [
       {
         "type": "storages",
         "name": "myazurefiles",
         "apiVersion": "2022-03-01",
         "dependsOn": [
           "[resourceId('Microsoft.App/managedEnvironments', parameters('environment_name'))]"
         ],
         "properties": {
           "azureFile": {
             "accountName": "[parameters('storage_account_name')]",
             "accountKey": "[parameters('storage_account_key')]",
             "shareName": "[parameters('storage_share_name')]",
             "accessMode": "ReadWrite"
           }
         }
       }
     ]
   }
   

2. Mettez à jour la ressource d’application conteneur pour ajouter un volume et un montage de volume.

   • SMB
   • NFS

   {
     "apiVersion": "2023-05-01",
     "type": "Microsoft.App/containerApps",
     "name": "[parameters('containerappName')]",
     "location": "[parameters('location')]",
     "properties": {
   
       ...
   
       "template": {
         "revisionSuffix": "myrevision",
         "containers": [
           {
             "name": "main",
             "image": "[parameters('container_image')]",
             "resources": {
               "cpu": 0.5,
               "memory": "1Gi"
             },
             "volumeMounts": [
               {
                 "mountPath": "/myfiles",
                 "volumeName": "azure-files-volume",
                 "subPath": "my-sub-path"
               }
             ]
           }
         ],
         "scale": {
           "minReplicas": 1,
           "maxReplicas": 3
         },
         "volumes": [
           {
             "name": "azure-files-volume",
             "storageType": "AzureFile",
             "storageName": "myazurefiles"
           }
         ]
       }
     }
   }
   

   • Ajoutez un tableau volumes à la section template de votre définition d’application conteneur et définissez un volume. Si vous disposez déjà d’un tableau volumes, ajoutez un nouveau volume au tableau.
     • name correspond à un identificateur pour le volume.
     • Pour storageType, utilisez AzureFile pour SMB, ou NfsAzureFile pour NFS. Cette valeur doit correspondre au type de stockage que vous avez défini dans l’environnement.
     • Pour storageName, utilisez le nom du stockage que vous avez défini dans l’environnement.
     • mountOptions est une chaîne de caractères séparée par des virgules d’options de montage. Pour plus d’informations, consultez Utiliser les paramètres mountOptions dans Azure Files.
     • La liste secrets est une liste de secrets à monter dans le volume. Pour plus d’informations, consultez Monter des secrets dans un volume.
   • Pour chaque conteneur du modèle où vous souhaitez monter le stockage Azure Files, définissez un montage de volume dans le tableau volumeMounts de la définition de conteneur.
     • volumeName correspond au nom défini dans le tableau volumes.
     • mountPath correspond au chemin dans le conteneur où monter le volume.
     • subPath (facultatif) est le chemin d’accès dans le volume à monter. S’il n’est pas spécifié, la racine du volume est montée. Pour plus d’informations, consultez (#sub-path).

Consultez la spécification de l’API de modèle ARM pour obtenir un exemple complet.

Pour configurer un montage de volume pour le stockage Azure Files dans le portail Azure, ajoutez un partage de fichiers à votre environnement Container Apps, puis ajoutez un montage de volume à votre application conteneur en créant une révision.

1. Dans le Portail Azure, accédez à votre instance d’application conteneur.

2. Dans le volet de navigation, sous Paramètres, sélectionnez Azure Files.

3. Sélectionnez Ajouter.

4. Sélectionnez SMB (Server Message Block) ou Network File System (NFS), selon le protocole utilisé par votre partage de fichiers.

5. Dans le volet Contextuel Ajouter un partage de fichiers , entrez les informations suivantes :

   • SMB
   • NFS

   • Nom : nom du partage de fichiers.
   • Nom du compte de stockage : nom du compte de stockage qui contient le partage de fichiers.
   • Clé de compte de stockage : clé d’accès pour le compte de stockage.
   • Partage de fichiers : nom du partage de fichiers.
   • Mode d’accès : mode d’accès pour le partage de fichiers. Les valeurs valides sont Lecture/écriture et Lecture seule.

6. Sélectionnez Ajouter pour quitter le volet contextuel.

7. Sélectionnez Enregistrer pour valider les modifications.

8. Accédez à votre application conteneur.

9. Dans le volet de navigation, sous Application, sélectionnez Révisions et réplicas.

10. Sélectionnez Créer une révision.

11. Dans la page Créer et déployer une nouvelle révision , sélectionnez l’onglet Volumes .

12. Sélectionnez Ajouter.

13. Dans le volet Ajouter un volume, définissez les éléments suivants.

    • Type de volume: volume de fichiers Azure.
    • Nom : entrez un nom de volume.
    • Nom du partage de fichiers : sélectionnez le partage de fichiers que vous avez créé précédemment.
    • Options de montage : Si vous le souhaitez, entrez une chaîne séparée par des virgules d’options de montage. Pour plus d’informations, consultez Utiliser les paramètres mountOptions dans Azure Files.

14. Sélectionnez Ajouter pour quitter le volet contextuel.

15. Dans la page Créer et reployer une nouvelle révision , sélectionnez l’onglet Conteneur .

16. Sélectionnez le conteneur dans lequel vous souhaitez monter le volume.

17. Dans le volet Modifier un conteneur, sélectionnez l’onglet Montages de volume.

18. Sous Nom du volume, sélectionnez le volume que vous avez créé précédemment.

19. Dans Chemin de montage, saisissez le chemin d’accès absolu dans le conteneur pour monter le volume.

20. Dans Sous-chemin (facultatif), entrez le chemin dans le volume à monter. S’il n’est pas spécifié, la racine du volume est montée. Pour plus d’informations, consultez (#sub-path).

21. Sélectionnez Enregistrer pour enregistrer les modifications et quitter le volet contextuel.

22. Sélectionnez Créer pour créer la nouvelle révision.