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 afin d’utiliser le stockage à l’échelle du réplica, 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 nouvelle révision.

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

5. Dans le volet contextuel 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 de volume : nom du volume éphémère.
   • Chemin de montage : chemin d’accès absolu dans le conteneur pour monter le volume.

7. Sélectionnez Enregistrer pour enregistrer les changements 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 accéder à un tutoriel 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 afin de 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.
   • 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.
   • 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
       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"
               }
             ]
           }
         ],
         "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.
   • 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.

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