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.
   • 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.
   • 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 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"
               }
             ]
           }
         ],
         "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.
   • 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.

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