Usar montagens de armazenamento em Aplicativos de Contêiner do Azure

Ao configurar o armazenamento com escopo de réplica usando a CLI do Azure, você deve usar uma definição de YAML para criar ou atualizar seu aplicativo de contêiner.

1. Para atualizar um aplicativo contêiner existente para usar o armazenamento com escopo de réplica, exporte a especificação do seu aplicativo para um arquivo YAML chamado app.yaml.

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

2. Faça as seguintes alterações na especificação do seu aplicativo de contêiner.

   • Adicione uma volumes matriz à template seção de sua definição de aplicativo de contêiner e defina um volume. Se você já tiver uma volumes matriz, adicione um novo volume à matriz.
     • O name é um identificador para o volume.
     • Use EmptyDir como o storageTypearquivo .
   • Para cada contêiner no modelo que você deseja montar o volume, defina uma montagem de volume na volumeMounts matriz da definição de contêiner.
     • O volumeName é o nome definido na volumes matriz.
     • O mountPath é o caminho no contêiner para montar o 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. Atualize seu aplicativo de contêiner usando o arquivo YAML.

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

Consulte a especificação YAML para obter um exemplo completo.

Para criar um volume com escopo de réplica e montá-lo em um contêiner, faça as seguintes alterações no recurso de aplicativos de contêiner em um modelo ARM:

• Adicione uma volumes matriz à template seção de sua definição de aplicativo de contêiner e defina um volume. Se você já tiver uma volumes matriz, adicione um novo volume à matriz.
  • O name é um identificador para o volume.
  • Use EmptyDir como o storageTypearquivo .
• Para cada contêiner no modelo que você deseja montar o volume, defina uma montagem de volume na volumeMounts matriz da definição de contêiner.
  • O volumeName é o nome definido na volumes matriz.
  • O mountPath é o caminho no contêiner para montar o volume.

Exemplo de trecho de modelo 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"
        }
      ]
    }
  }
}

Consulte a especificação da API do modelo ARM para obter um exemplo completo.

Para criar um volume com escopo de réplica e montá-lo em um contêiner, implante uma nova revisão do seu aplicativo de contêiner usando o portal do Azure.

1. No portal do Azure, navegue até seu aplicativo de contêiner.

2. Selecione Gerenciamento de revisão no menu à esquerda.

3. Selecione Criar nova revisão.

4. Selecione o recipiente onde deseja montar o volume.

5. No painel de contexto Editar um contêiner, selecione a guia Montagens de volume.

6. Na seção Armazenamento efêmero, crie um novo volume com as seguintes informações.

   • Nome do volume: um nome para o volume efêmero.
   • Caminho de montagem: o caminho absoluto no contêiner para montar o volume.

7. Selecione Salvar para salvar as alterações e sair do painel de contexto.

8. Selecione Criar para criar a nova revisão.

Ao configurar um aplicativo de contêiner para montar um volume de Arquivos do Azure usando a CLI do Azure, você deve usar uma definição de YAML para criar ou atualizar seu aplicativo de contêiner.

Para obter um tutorial passo a passo sobre como montar um compartilhamento de arquivos SMB, consulte Criar uma montagem de armazenamento do Azure Files em Aplicativos de Contêiner do Azure.

1. Adicione uma definição de armazenamento ao seu ambiente de Aplicativos de Contêiner.

   • 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
   

   Substitua <STORAGE_ACCOUNT_NAME> e <STORAGE_ACCOUNT_KEY> pelo nome e chave da sua conta de armazenamento. Substitua <STORAGE_SHARE_NAME> pelo nome do compartilhamento de arquivos na conta de armazenamento.

   Valores válidos para --access-mode are ReadWrite e ReadOnly.

2. Para atualizar um aplicativo de contêiner existente para montar um compartilhamento de arquivos, exporte a especificação do seu aplicativo para um arquivo YAML chamado app.yaml.

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

3. Faça as seguintes alterações na especificação do seu aplicativo de contêiner.

   • Adicione uma volumes matriz à template seção de sua definição de aplicativo de contêiner e defina um volume. Se você já tiver uma volumes matriz, adicione um novo volume à matriz.
     • O name é um identificador para o volume.
     • Para storageType, use AzureFile para SMB ou NfsAzureFile para NFS. Esse valor deve corresponder ao tipo de armazenamento definido no ambiente.
     • Para storageName, use o nome do armazenamento definido no ambiente.
   • Para cada contêiner no modelo que você deseja montar o armazenamento de Arquivos do Azure, defina uma montagem de volume na volumeMounts matriz da definição de contêiner.
     • O volumeName é o nome definido na volumes matriz.
     • O mountPath é o caminho no contêiner para montar o 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. Atualize seu aplicativo de contêiner usando o arquivo YAML.

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

Consulte a especificação YAML para obter um exemplo completo.

Os seguintes trechos de modelo ARM demonstram como adicionar um compartilhamento do Azure Files a um ambiente de Aplicativos de Contêiner e usá-lo em um aplicativo de contêiner.

1. Adicione um storages recurso filho ao ambiente 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. Atualize o recurso do aplicativo de contêiner para adicionar um volume e uma montagem 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"
           }
         ]
       }
     }
   }
   

   • Adicione uma volumes matriz à template seção de sua definição de aplicativo de contêiner e defina um volume. Se você já tiver uma volumes matriz, adicione um novo volume à matriz.
     • O name é um identificador para o volume.
     • Para storageType, use AzureFile para SMB ou NfsAzureFile para NFS. Esse valor deve corresponder ao tipo de armazenamento definido no ambiente.
     • Para storageName, use o nome do armazenamento definido no ambiente.
   • Para cada contêiner no modelo que você deseja montar o armazenamento de Arquivos do Azure, defina uma montagem de volume na volumeMounts matriz da definição de contêiner.
     • O volumeName é o nome definido na volumes matriz.
     • O mountPath é o caminho no contêiner para montar o volume.

Consulte a especificação da API do modelo ARM para obter um exemplo completo.