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 YAML para criar ou atualizar seu aplicativo de contêiner.

1. Para atualizar um aplicativo de contêiner existente para usar o armazenamento com escopo de réplica, exporte a especificação do 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 aplicativo de contêiner.

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

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

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

Confira a especificação da API de modelo do 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 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 esquerdo.

3. Selecione Criar nova revisão.

4. Selecione o contêiner no qual você deseja montar o volume.

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

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

   • 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 Contexto.

8. Depois, selecione Criar para criar o grupo.

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 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 de Arquivos do Azure nos Aplicativos de Contêiner do Azure.

1. Adicione uma definição de armazenamento em seu ambiente dos 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 pela chave de sua conta de armazenamento. Substitua <STORAGE_SHARE_NAME> pelo nome do compartilhamento de arquivos na conta de armazenamento.

   Os valores válidos para --access-mode são ReadWrite e ReadOnly.

2. Para atualizar um aplicativo de contêiner existente para montar um compartilhamento de arquivo, exporte a especificação do 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 aplicativo de contêiner.

   • Adicione uma matriz volumes à seção template da definição do aplicativo de contêiner e defina um volume. Se você já tiver uma matriz volumes, 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 que você definiu no ambiente.
     • A mountOptions é uma string separada por vírgulas de opções de montagem. Para obter mais informações, consulte Configurações de mountOptions no Azure Files.
     • A lista secrets é uma lista de segredos a serem montados no volume. Para obter mais informações, consulte Montagem de segredos em um volume.
   • Para cada contêiner no modelo que você deseja montar o armazenamento de Arquivos do Azure, defina uma montagem de volume na matriz volumeMounts à definição de contêiner.
     • O volumeName nome é definido na matriz volumes.
     • É mountPath o caminho no contêiner para montar o volume.
     • É subPath o caminho no volume a ser montado. Se não for especificado, a raiz do volume será montada. Para obter mais informações, consulte (#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. 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 snippets do modelo do ARM a seguir demonstram como adicionar um compartilhamento de Arquivos do Azure a um ambiente de Aplicativos de Contêiner e usá-lo em um aplicativo de contêiner.

1. Adicione um recurso filho storages ao ambiente de Aplicativos de Contêiner.

   • 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",
                 "subPath": "my-sub-path"
               }
             ]
           }
         ],
         "scale": {
           "minReplicas": 1,
           "maxReplicas": 3
         },
         "volumes": [
           {
             "name": "azure-files-volume",
             "storageType": "AzureFile",
             "storageName": "myazurefiles"
           }
         ]
       }
     }
   }
   

   • Adicione uma matriz volumes à seção template da definição do aplicativo de contêiner e defina um volume. Se você já tiver uma matriz volumes, 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 que você definiu no ambiente.
     • A mountOptions é uma string separada por vírgulas de opções de montagem. Para obter mais informações, consulte Configurações de mountOptions no Azure Files.
     • A lista secrets é uma lista de segredos a serem montados no volume. Para obter mais informações, consulte Montagem de segredos em um volume.
   • Para cada contêiner no modelo que você deseja montar o armazenamento de Arquivos do Azure, defina uma montagem de volume na matriz volumeMounts à definição de contêiner.
     • O volumeName nome é definido na matriz volumes.
     • É mountPath o caminho no contêiner para montar o volume.
     • O subPath (opcional) é o caminho no volume a ser montado. Se não for especificado, a raiz do volume será montada. Para obter mais informações, consulte (#sub-path).

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

Para configurar uma montagem de volume para o armazenamento de Arquivos do Azure no portal do Azure, adicione um compartilhamento de arquivos ao seu ambiente dos Aplicativos de Contêiner e adicione uma montagem de volume ao seu aplicativo de contêiner criando uma nova revisão.

1. No portal do Azure, navegue até a instância do Aplicativo de Contêiner.

2. No painel de navegação, em Configurações, selecione Arquivos do Azure.

3. Selecione Adicionar.

4. Selecione SMB (Server Message Block) ou NFS (Network File System), dependendo do protocolo usado pelo seu compartilhamento de arquivos.

5. No painel de contexto Adicionar compartilhamento de arquivos, insira as seguintes informações:

   • SMB
   • NFS

   • Nome: um nome para o compartilhamento de arquivos.
   • Nome da conta de armazenamento: o nome da conta de armazenamento que contém o compartilhamento de arquivos.
   • Chave da conta de armazenamento: a chave de acesso da conta de armazenamento.
   • Compartilhamento de arquivo: o nome do compartilhamento de arquivo.
   • Modo de acesso: o modo de acesso ao compartilhamento de arquivos. Valores válidos são Leitura/Gravação e Somente leitura.

6. Selecione Adicionar para sair do painel Contexto.

7. Selecione Salvar para confirmar as alterações.

8. Navegue até seu aplicativo de contêiner.

9. No painel de navegação, em Aplicativo, selecione Revisões e réplicas.

10. Selecione Criar nova revisão.

11. Na página Criar e implantar nova revisão, selecione a guia Volumes.

12. Selecione Adicionar.

13. No painel de contexto Adicionar volume, configure o seguinte.

    • Tipo de volume: Volume de arquivo do Azure.
    • Nome: insira um nome para o volume.
    • Nome do compartilhamento de arquivos: selecione o compartilhamento de arquivos que você criou anteriormente.
    • Opções de montagem: opcionalmente, insira uma cadeia de caracteres separada por vírgula das opções de montagem. Para obter mais informações, consulte Configurações de mountOptions no Azure Files.

14. Selecione Adicionar para sair do painel Contexto.

15. Na página Criar e implantar nova revisão, selecione a guia Contêiner.

16. Selecione o contêiner no qual você deseja montar o volume.

17. No painel Contexto Editar um contêiner, selecione a guia Montagens de volume.

18. Em Nome do volume, selecione o volume que você criou anteriormente.

19. Em Caminho de montagem, insira o caminho absoluto dentro do contêiner onde o volume será montado.

20. No ub-caminho (opcional), insira o caminho no volume a ser montado. Se não for especificado, a raiz do volume será montada. Para obter mais informações, consulte (#sub-path).

21. Selecione Salvar para salvar as alterações e sair do painel Contexto.

22. Depois, selecione Criar para criar o grupo.