Utilizar montagens de armazenamento nas Aplicações de Contentor Azure

Quando configura armazenamento com escopo de réplica usando a CLI do Azure, deve usar uma definição YAML para criar ou atualizar a sua aplicação container.

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 storageType.
   • Para cada contentor no template onde pretende montar o volume, defina uma montagem de volume na matriz da definição do contentor.
     • 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 a sua aplicação container usando o ficheiro YAML.

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

Para um exemplo completo, veja a especificação YAML.

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 storageType.
• Para cada contentor no template onde pretende montar o volume, defina uma montagem de volume na matriz da definição do contentor.
  • O volumeName é o nome definido na volumes matriz.
  • O mountPath é o caminho no contêiner para montar o volume.

Exemplo de um fragmento 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"
        }
      ]
    }
  }
}

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, implemente uma nova revisão da sua aplicação em contêiner usando o portal do Azure.

1. No portal do Azure, vai à tua aplicação container.

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

3. Selecione Criar nova revisão.

4. Selecione o contentor onde deseja montar o volume.

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

6. Na secção de armazenamento efémero , crie um novo volume com a seguinte informação:

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

Quando configura uma aplicação container para montar um volume Ficheiros do Azure usando CLI do Azure, deve usar uma definição YAML para criar ou atualizar a sua aplicação container.

Para um tutorial passo a passo sobre como montar uma partilha de ficheiros SMB, veja Criar uma montagem de armazenamento Ficheiros do Azure em Azure Container Apps.

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

   • PME
   • 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 são 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.
     • O mountOptions é uma cadeia de opções de montagem separada por vírgula. Para obter mais informações, consulte utilizar as definições de mountOptions no Ficheiros do Azure.
     • A secrets lista é uma lista de segredos para montar no volume. Para mais informações, consulte Montar segredos num volume.
   • Para cada contentor no modelo que pretende montar o armazenamento Ficheiros do Azure, defina um ponto de montagem no array volumeMounts da definição do contentor.
     • O volumeName é o nome definido na volumes matriz.
     • O mountPath é o caminho no contêiner para montar o volume.
     • O subPath é o caminho no volume a ser montado. Se não especificares este valor, a raiz do volume é montada. Para mais informações, consulte (#sub-caminho).
   • PME
   • 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 a sua aplicação container usando o ficheiro YAML.

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

Para um exemplo completo, veja a especificação YAML.

Os seguintes excertos de modelos ARM demonstram como adicionar uma partilha Ficheiros do Azure a um ambiente Container Apps e utilizá-la numa aplicação container.

1. Adicione um storages recurso filho ao ambiente Container Apps.

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

   • PME
   • 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 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.
     • O mountOptions é uma cadeia de opções de montagem separada por vírgula. Para mais informações, consulte Utilizar as definições de mountOptions em Ficheiros do Azure.
     • A secrets lista é uma lista de segredos para montar no volume. Para mais informações, consulte Montar segredos num volume.
   • Para cada contentor no modelo em que pretende montar o armazenamento Ficheiros do Azure, defina uma montagem de volume na definição do contentor no array volumeMounts.
     • O volumeName é o nome definido na volumes matriz.
     • O mountPath é o caminho no contêiner para montar o volume.
     • O subPath (opcional) é o caminho no volume a ser montado. Se não especificar, a raiz de volume fica montada. Para mais informações, consulte (#sub-caminho).

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

Para configurar uma montagem de volume para armazenamento Ficheiros do Azure no portal Azure, adicione uma partilha de ficheiros ao seu ambiente Container Apps e depois adicione uma montagem de volume à sua aplicação container criando uma nova revisão.

1. No portal do Azure, navegue até ao seu ambiente de Aplicações Container.

2. No painel de navegação, em Definições, selecione Montagens de Volume.

3. Selecione Adicionar.

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

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

   • PME
   • 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 para a conta de armazenamento.
   • Compartilhamento de arquivos: o nome do compartilhamento de arquivos.
   • Modo de acesso: O modo de acesso para o compartilhamento de arquivos. Os valores válidos são Leitura/Gravação e Leitura apenas.

6. Selecione Adicionar para sair do painel de contexto.

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

8. Vai à tua aplicação de contentores.

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 , defina os seguintes valores.

    • Volume type: Azure file volume.
    • Nome: insira um nome de volume.
    • Nome do compartilhamento de arquivos: selecione o compartilhamento de arquivos criado anteriormente.
    • Opções de montagem: Opcionalmente, insira uma cadeia de opções de montagem separada por vírgula. Para obter mais informações, consulte Utilizar as definições mountOptions no Ficheiros do Azure.

14. Selecione Adicionar para sair do painel de contexto.

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

16. Selecione o contentor onde deseja montar o volume.

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

18. Em Nome do volume, selecione o volume criado anteriormente.

19. Em Caminho de montagem, insira o caminho absoluto no contenedor para montar o volume.

20. Em Subcaminho (opcional), insira o caminho no volume a ser montado. Se não especificares este valor, a raiz do volume é montada. Para mais informações, consulte (#sub-caminho).

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

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