Utiliser des supports de stockage dans les Applications de Conteneur Azure

Lorsque vous configurez un stockage à portée de réplica à l’aide de l’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
   

Pour obtenir un exemple complet, consultez la spécification YAML.

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 à portée de réplica et le monter dans un conteneur, déployez une nouvelle révision de votre conteneur d'application à l'aide de Azure Portal.

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.

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

Installez la dernière version de Azure CLI et mettez à jour l’extension Container Apps :

az extension add --name containerapp --upgrade

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

   Authentification par identité managée (recommandée)

   Pour utiliser l’identité managée assignée par le système de l’environnement, activez-la d’abord :

   az containerapp env identity assign --name my-env --resource-group my-group \
       --system-assigned
   

   Accordez à l’identité le rôle Storage File Data SMB MI Admin sur votre compte de stockage et activez Managed Identity for SMB comme décrit dans les prérequis. Puis créez la définition de stockage :

   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-identity system \
       --azure-file-share-name <STORAGE_SHARE_NAME> \
       --access-mode ReadWrite
   

   Remplacez <STORAGE_ACCOUNT_NAME> et <STORAGE_SHARE_NAME> avec les noms de votre compte de stockage et de partage de fichiers. La valeur system sélectionne l’identité gérée assignée par le système de l’environnement.

   Pour utiliser une identité managée attribuée par l’utilisateur à la place, assignez-la à l’environnement :

   az containerapp env identity assign --name my-env --resource-group my-group \
       --user-assigned <MANAGED_IDENTITY_RESOURCE_ID>
   

   Accordez à cette identité le même rôle sur le compte de stockage. Dans la commande de stockage, remplacez --azure-file-identity system par --azure-file-identity <MANAGED_IDENTITY_RESOURCE_ID>, en utilisant l'ID complet de la ressource Azure de l'identité, et non son identifiant client ou son identifiant principal.

   Ne pas combiner --azure-file-identity avec --azure-file-account-key ou --azure-file-key-vault-secret-url. Ces modes d’authentification sont mutuellement exclusifs.

   Authentification par clé de compte de stockage (alternative)

   Si vous ne pouvez pas utiliser l’authentification d’identité gérée, vous pouvez utiliser une clé de compte de stockage à la place :

   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 Utilisez les paramètres mountOptions dans Azure Files.
     • La liste secrets est une liste de secrets à monter dans le volume. Pour davantage d’informations, reportez-vous à Montage des secrets dans un volume.
   • Pour chaque conteneur du modèle pour lequel vous souhaitez monter le stockage Azure Files, définissez un montage de volume dans le tableau volumeMounts de la définition de la 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. Si vous ne spécifiez pas cette valeur, la racine du volume est montée. Pour plus d’informations, voir Sous-chemin.
   • 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
   

Pour obtenir un exemple complet, consultez la spécification YAML.

Les extraits de code arm suivants montrent comment ajouter un partage Azure Files à un environnement Container Apps et l’utiliser dans une application conteneur. Pour l’authentification par identité gérée pour SMB, activez ou attribuez l’identité dans l’environnement et remplissez les conditions préalables du compte de stockage avant de déployer la définition de stockage.

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

   • SMB
   • NFS

   Authentification par identité managée (recommandée)

   Premièrement, activez une identité gérée sur la Microsoft.App/managedEnvironments ressource, pas sur la Microsoft.App/containerApps ressource. Pour activer l’identité affectée par le système de l’environnement, ajoutez la propriété de niveau supérieur identity suivante à votre ressource d’environnement :

   {
     "identity": {
       "type": "SystemAssigned"
     }
   }
   

   Fusionnez ce fragment dans votre ressource d’environnement existante, en conservant son autre configuration. Utilisez une version d’API d’environnement qui prend en charge les identités gérées, telles que 2026-03-02-preview. Pour le schéma des ressources, voir Microsoft.App/managedEnvironments.

   Activez l’identité gérée pour SMB (SMBOAuth) sur le compte de stockage et attribuez à l’identité d’environnement le rôle Storage File Data SMB MI Admin dans le périmètre du compte de stockage, comme décrit dans les prérequis.

   Ensuite, utilisez la version 2026-03-02-preview API pour la ressource de stockage. Définissez properties.azureFile.identity sur system pour sélectionner l’identité assignée par le système de l’environnement :

   {
     "type": "Microsoft.App/managedEnvironments/storages",
     "apiVersion": "2026-03-02-preview",
     "name": "[concat(parameters('environment_name'), '/myazurefiles')]",
     "properties": {
       "azureFile": {
         "accountName": "[parameters('storage_account_name')]",
         "identity": "system",
         "shareName": "[parameters('storage_share_name')]",
         "accessMode": "ReadWrite"
       }
     }
   }
   

   Pour utiliser une identité managée attribuée par l’utilisateur à la place, ajoutez-la à la propriété de niveau supérieur identity de l’environnement :

   {
     "identity": {
       "type": "UserAssigned",
       "userAssignedIdentities": {
         "[parameters('managed_identity_resource_id')]": {}
       }
     }
   }
   

   Définissez le paramètre managed_identity_resource_id comme un string contenant l'ID complet de la ressource Azure de l'identité. Dans la ressource de stockage, définissez properties.azureFile.identity sur [parameters('managed_identity_resource_id')] au lieu de system. Accordez à cette identité le même rôle sur le compte de stockage.

   Préserver les identités déjà attribuées à l’environnement. Si vous activez les deux types d’identité, utilisez SystemAssigned,UserAssigned pour le/la identity.type de l’environnement et conservez ses entrées userAssignedIdentities.

   N’incluez pas accountKey ou accountKeyVaultProperties lorsque vous utilisez l’authentification par identité managée. Pour le schéma des ressources de stockage, voir Microsoft.App/managedEnvironments/storages.

   Authentification par clé de compte de stockage (alternative)

   Pour utiliser une clé de compte de stockage à la place, définissez accountKey et omettez identity. Définissons le storage_account_key paramètre modèle comme un secureString.

   {
     "type": "Microsoft.App/managedEnvironments/storages",
     "apiVersion": "2022-03-01",
     "name": "[concat(parameters('environment_name'), '/myazurefiles')]",
     "properties": {
       "azureFile": {
         "accountName": "[parameters('storage_account_name')]",
         "accountKey": "[parameters('storage_account_key')]",
         "shareName": "[parameters('storage_share_name')]",
         "accessMode": "ReadWrite"
       }
     }
   }
   

   Ces extraits de stockage supposent que l’environnement et le partage de fichiers existent déjà. Si vous les déployez dans le même modèle, ajoutez les ressources d’environnement et de partage de fichiers au tableau dependsOn de la ressource de stockage. Pour l’authentification d’identité gérée, ajoutez aussi une dépendance à l’attribution du rôle si vous la créez dans ce modèle. Une dépendance de déploiement n’élimine pas les délais de propagation de l’attribution de rôle.

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

   L’authentification SMB est configurée dans la définition de stockage de l’environnement. La configuration du volume au niveau de l’application est la même pour l’identité gérée et l’authentification par clé de compte de stockage. Si vous déployez la ressource de stockage et l’application conteneur dans le même modèle, ajoutez la ressource de stockage au tableau dependsOn de l’application conteneur.

   • 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 Utilisez les paramètres mountOptions dans Azure Files.
     • La liste secrets est une liste de secrets à monter dans le volume. Pour davantage d’informations, reportez-vous à Montage des secrets dans un volume.
   • Pour chaque conteneur du modèle pour lequel vous souhaitez monter le stockage Azure Files, définissez un montage de volume dans le tableau volumeMounts de la définition de la 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. Si vous ne le spécifiez pas, la racine du volume est montée. Pour plus d’informations, voir Sous-chemin.

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

Pour configurer un montage de volume pour Azure Files stockage 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 nouvelle révision. Pour les nouveaux montages SMB, sélectionnez authentification d’identité managée.

1. Dans le portail Azure, accédez à votre environnement Container Apps.

2. Pour l’authentification d’identité gérée SMB, sélectionnez Paramètres>Identité et activez une identité assignée par le système ou ajoutez une identité assignée par l’utilisateur à l’environnement. Complétez les paramètres du compte de stockage et l’attribution des rôles décrits dans les prérequis Azure Files avant d’ajouter le partage.

3. Dans le volet de navigation, sous Paramètres, sélectionnez Montages de volume.

4. Sélectionnez Ajouter.

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

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

   • SMB
   • NFS

   • Nom : Un nom pour la définition de stockage de l’environnement.
   • Nom du compte de stockage : nom du compte de stockage qui contient le partage de fichiers.
   • Authentification: Sélectionnez identité managée (recommandée).
   • Identité : Sélectionnez l’identité assignée au système de l’environnement ou une identité affectée par l’utilisateur à l’environnement à partir de la liste des identités gérées. Sélectionnez l’identité qui a le rôle Storage File Data SMB MI Admin sur le compte de stockage.
   • Nom du partage de fichiers : Le nom du partage de fichiers SMB.
   • Mode d’accès : mode d’accès pour le partage de fichiers. Les valeurs valides sont Lecture/écriture et Lecture seule.

   Pour utiliser l’authentification par clé de compte de stockage à la place, sélectionnez Clé de compte de stockage sous Authentification et saisissez la clé d’accès du compte de stockage. Choisissez une méthode d’authentification pour la définition de stockage.

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

8. Sélectionnez Enregistrer pour valider les modifications.

9. Accédez à votre application conteneur.

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

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

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

13. Sélectionnez Ajouter.

14. Dans le volet de contexte Ajouter un volume, définissez les valeurs suivantes.

    • Volume type : Azure volume de fichiers.
    • 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 Utilisez les paramètres mountOptions dans Azure Files.

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

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

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

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

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

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

21. Dans Sous-chemin (facultatif), entrez le chemin dans le volume à monter. Si vous ne spécifiez pas cette valeur, la racine du volume est montée. Pour plus d’informations, voir Sous-chemin.

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

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