Tutorial: Criar uma montagem de volume do Azure Files em Aplicativos de Contêiner do Azure

Aprenda a gravar no armazenamento permanente em um aplicativo de contêiner usando uma montagem de armazenamento do Azure Files. Para obter mais informações sobre montagens de armazenamento, consulte Usar montagens de armazenamento em Aplicativos de Contêiner do Azure.

Neste tutorial, irá aprender a:

• Criar um ambiente de aplicativos de contêiner
• Criar uma conta de Armazenamento do Azure
• Definir um compartilhamento de arquivos na conta de armazenamento
• Vincular o ambiente ao compartilhamento de arquivos de armazenamento
• Monte o compartilhamento de armazenamento em um contêiner individual
• Verifique a montagem do armazenamento exibindo o log de acesso ao site

Nota

Os Aplicativos de Contêiner do Azure dão suporte à montagem de compartilhamentos de arquivos usando protocolos SMB e NFS. Este tutorial demonstra a montagem de um compartilhamento de Arquivos do Azure usando o protocolo SMB. Para saber mais sobre como montar compartilhamentos NFS, consulte Usar montagens de armazenamento em Aplicativos de Contêiner do Azure.

Pré-requisitos

• Instale a versão mais recente da CLI do Azure.

Configurar o ambiente

Os comandos a seguir ajudam a definir variáveis e garantir que sua extensão Container Apps esteja atualizada.

1. Entre na CLI do Azure.

   Bash

   az login
   

   PowerShell

   az login
   

2. Configure variáveis de ambiente usadas em vários comandos a serem seguidos.

   Bash

   RESOURCE_GROUP="my-container-apps-group"
   ENVIRONMENT_NAME="my-storage-environment"
   LOCATION="canadacentral"
   

   PowerShell

   $RESOURCE_GROUP="my-container-apps-group"
   $ENVIRONMENT_NAME="my-storage-environment"
   $LOCATION="canadacentral"
   

3. Certifique-se de ter a versão mais recente da extensão CLI do Azure Container Apps.

   Bash

   az extension add -n containerapp --upgrade
   

   PowerShell

   az extension add -n containerapp --upgrade
   

4. Registre o Microsoft.App namespace.

   Bash

   az provider register --namespace Microsoft.App
   

   PowerShell

   az provider register --namespace Microsoft.App
   

5. Registre o Microsoft.OperationalInsights provedor para o espaço de trabalho do Azure Monitor Log Analytics se você não o tiver usado antes.

   Bash

   az provider register --namespace Microsoft.OperationalInsights
   

   PowerShell

   az provider register --namespace Microsoft.OperationalInsights
   

Criar um ambiente

As etapas a seguir criam um grupo de recursos e um ambiente de Aplicativos de Contêiner.

1. Crie um grupo de recursos.

   Bash

   az group create \
     --name $RESOURCE_GROUP \
     --location $LOCATION \
     --query "properties.provisioningState"
   

   PowerShell

   az group create `
     --name $RESOURCE_GROUP `
     --location $LOCATION `
     --query "properties.provisioningState"
   

   Uma vez criado, o comando retorna uma mensagem "Succeeded".

   No final deste tutorial, você pode excluir o grupo de recursos para remover todos os serviços criados durante este artigo.

2. Crie um ambiente de aplicativos de contêiner.

   Bash

   az containerapp env create \
     --name $ENVIRONMENT_NAME \
     --resource-group $RESOURCE_GROUP \
     --location "$LOCATION" \
     --query "properties.provisioningState"
   

   PowerShell

   az containerapp env create `
     --name $ENVIRONMENT_NAME `
     --resource-group $RESOURCE_GROUP `
     --location "$LOCATION" `
     --query "properties.provisioningState"
   

   Uma vez criado, o comando retorna uma mensagem "Succeeded".

   As montagens de armazenamento são associadas a um ambiente de Aplicativos de Contêiner e configuradas em aplicativos de contêiner individuais.

Configurar uma conta de armazenamento

Em seguida, crie uma conta de armazenamento e estabeleça um compartilhamento de arquivos para montar no aplicativo de contêiner.

1. Defina um nome de conta de armazenamento.

   Este comando gera um sufixo aleatório para o nome da conta de armazenamento para garantir exclusividade.

   Bash

   STORAGE_ACCOUNT_NAME="myacastorageaccount$RANDOM"
   

   PowerShell

   $STORAGE_ACCOUNT_NAME="myacastorageaccount$(Get-Random -Maximum 10000)"
   

2. Criar uma conta de Armazenamento do Azure.

   Bash

   az storage account create \
     --resource-group $RESOURCE_GROUP \
     --name $STORAGE_ACCOUNT_NAME \
     --location "$LOCATION" \
     --kind StorageV2 \
     --sku Standard_LRS \
     --enable-large-file-share \
     --query provisioningState
   

   PowerShell

   az storage account create `
     --resource-group $RESOURCE_GROUP `
     --name $STORAGE_ACCOUNT_NAME `
     --location "$LOCATION" `
     --kind StorageV2 `
     --sku Standard_LRS `
     --enable-large-file-share `
     --query provisioningState
   

   Uma vez criado, o comando retorna uma mensagem "Succeeded".

3. Defina um nome de compartilhamento de arquivos.

   Bash

   STORAGE_SHARE_NAME="myfileshare"
   

   PowerShell

   $STORAGE_SHARE_NAME="myfileshare"
   

4. Crie o compartilhamento de arquivos do Armazenamento do Azure.

   Bash

   az storage share-rm create \
     --resource-group $RESOURCE_GROUP \
     --storage-account $STORAGE_ACCOUNT_NAME \
     --name $STORAGE_SHARE_NAME \
     --quota 1024 \
     --enabled-protocols SMB \
     --output table
   

   PowerShell

   az storage share-rm create `
     --resource-group $RESOURCE_GROUP `
     --storage-account $STORAGE_ACCOUNT_NAME `
     --name $STORAGE_SHARE_NAME `
     --quota 1024 `
     --enabled-protocols SMB `
     --output table
   

5. Obtenha a chave da conta de armazenamento.

   Bash

   STORAGE_ACCOUNT_KEY=`az storage account keys list -n $STORAGE_ACCOUNT_NAME --query "[0].value" -o tsv`
   

   PowerShell

   $STORAGE_ACCOUNT_KEY=$(az storage account keys list -n $STORAGE_ACCOUNT_NAME --query "[0].value" -o tsv)
   

   A chave da conta de armazenamento é necessária para criar o link de armazenamento em seu ambiente de Aplicativos de Contêiner.

6. Defina o nome da montagem de armazenamento.

   Bash

   STORAGE_MOUNT_NAME="mystoragemount"
   

   PowerShell

   $STORAGE_MOUNT_NAME="mystoragemount"
   

   Esse valor é o nome usado para definir o link de montagem de armazenamento do seu ambiente de Aplicativos de Contêiner para sua conta de Armazenamento do Azure.

Criar o suporte de armazenamento

Agora você pode atualizar a configuração do aplicativo de contêiner para suportar a montagem de armazenamento.

1. Crie o link de armazenamento no ambiente.

   Bash

   az containerapp env storage set \
     --access-mode ReadWrite \
     --azure-file-account-name $STORAGE_ACCOUNT_NAME \
     --azure-file-account-key $STORAGE_ACCOUNT_KEY \
     --azure-file-share-name $STORAGE_SHARE_NAME \
     --storage-name $STORAGE_MOUNT_NAME \
     --name $ENVIRONMENT_NAME \
     --resource-group $RESOURCE_GROUP \
     --output table
   

   PowerShell

   az containerapp env storage set `
     --access-mode ReadWrite `
     --azure-file-account-name $STORAGE_ACCOUNT_NAME `
     --azure-file-account-key $STORAGE_ACCOUNT_KEY `
     --azure-file-share-name $STORAGE_SHARE_NAME `
     --storage-name $STORAGE_MOUNT_NAME `
     --name $ENVIRONMENT_NAME `
     --resource-group $RESOURCE_GROUP `
     --output table
   

   Este comando cria um link entre o ambiente do aplicativo contêiner e o compartilhamento de arquivos criado com o az storage share-rm comando.

   Agora que a conta de armazenamento e o ambiente estão vinculados, você pode criar um aplicativo de contêiner que usa a montagem de armazenamento.

2. Defina o nome do aplicativo de contêiner.

   Bash

   CONTAINER_APP_NAME="my-container-app"
   

   PowerShell

   $CONTAINER_APP_NAME="my-container-app"
   

3. Crie o aplicativo de contêiner.

   Bash

   az containerapp create \
     --name $CONTAINER_APP_NAME \
     --resource-group $RESOURCE_GROUP \
     --environment $ENVIRONMENT_NAME \
     --image nginx \
     --min-replicas 1 \
     --max-replicas 1 \
     --target-port 80 \
     --ingress external \
     --query properties.configuration.ingress.fqdn
   

   PowerShell

   az containerapp create `
     --name $CONTAINER_APP_NAME `
     --resource-group $RESOURCE_GROUP `
     --environment $ENVIRONMENT_NAME `
     --image nginx `
     --min-replicas 1 `
     --max-replicas 1 `
     --target-port 80 `
     --ingress external `
     --query properties.configuration.ingress.fqdn
   

   Este comando exibe a URL do seu novo aplicativo de contêiner.

4. Copie o URL e cole no navegador da Web para navegar até o site.

   Quando a página carregar, você verá a mensagem "Bem-vindo ao nginx!". Mantenha este separador do navegador aberto. Você retornará ao site durante as etapas de verificação de montagem de armazenamento.

   Agora que você confirmou que o aplicativo contêiner está configurado, você pode atualizá-lo com uma definição de montagem de armazenamento.

5. Exporte a configuração do aplicativo contêiner.

   Bash

   az containerapp show \
     --name $CONTAINER_APP_NAME \
     --resource-group $RESOURCE_GROUP \
     --output yaml > app.yaml
   

   PowerShell

   az containerapp show `
     --name $CONTAINER_APP_NAME `
     --resource-group $RESOURCE_GROUP `
     --output yaml > app.yaml
   

   Nota

   Embora esta aplicação não tenha segredos, muitas aplicações apresentam segredos. Por padrão, quando você exporta a configuração de um aplicativo, os valores para segredos não são incluídos no YAML gerado.

   Se não precisar de alterar valores secretos, pode remover a secrets secção e os seus segredos permanecem inalterados. Como alternativa, se você precisar alterar o valor de um segredo, certifique-se de fornecer o name e value para todos os segredos no arquivo antes de tentar atualizar o aplicativo. Omitir um segredo da secrets seção exclui o segredo.

6. Abra app.yaml em um editor de código.

7. Substitua template a volumes: null definição na seção por uma volumes: definição que faça referência ao volume de armazenamento. A seção de modelo deve ter a seguinte aparência:

   template:
     volumes:
     - name: my-azure-file-volume
       storageName: mystoragemount
       storageType: AzureFile
     containers:
     - image: nginx
       name: my-container-app
       volumeMounts:
       - volumeName: my-azure-file-volume
         mountPath: /var/log/nginx
       resources:
         cpu: 0.5
         ephemeralStorage: 3Gi
         memory: 1Gi
     initContainers: null
     revisionSuffix: ''
     scale:
       maxReplicas: 1
       minReplicas: 1
       rules: null
   

   A nova template.volumes seção inclui as seguintes propriedades.

   Property	Description
   name	Esse valor corresponde ao volume criado chamando o az containerapp env storage set comando.
   storageName	Esse valor define o nome usado pelos contêineres no ambiente para acessar o volume de armazenamento.
   storageType	Esse valor determina o tipo de volume de armazenamento definido para o ambiente. Nesse caso, uma montagem do Azure Files é declarada.

   A volumes seção define volumes no nível do aplicativo que seu contêiner de aplicativo ou contêineres de sidecar podem referenciar por meio de uma volumeMounts seção associada a um contêiner.

8. Adicione uma volumeMounts seção ao nginx contêiner na containers seção .

   containers:
     - image: nginx
       name: my-container-app
       volumeMounts:
       - volumeName: my-azure-file-volume
         mountPath: /var/log/nginx
   

   A nova volumeMounts seção inclui as seguintes propriedades:

   Property	Description
   volumeName	Esse valor deve corresponder ao volumes nome definido na definição.
   mountPath	Esse valor define o caminho no contêiner onde o armazenamento é montado.

9. Atualize o aplicativo contêiner com a nova configuração de montagem de armazenamento.

   Bash

   az containerapp update \
     --name $CONTAINER_APP_NAME \
     --resource-group $RESOURCE_GROUP \
     --yaml app.yaml \
     --output table
   

   PowerShell

   az containerapp update `
     --name $CONTAINER_APP_NAME `
     --resource-group $RESOURCE_GROUP `
     --yaml app.yaml `
     --output table
   

Verifique a montagem de armazenamento

Agora que a montagem de armazenamento está estabelecida, você pode manipular arquivos no Armazenamento do Azure a partir do seu contêiner. Use os comandos a seguir para observar a montagem de armazenamento no trabalho.

1. Abra um shell interativo dentro do aplicativo de contêiner para executar comandos dentro do contêiner em execução.

   Bash

   az containerapp exec \
     --name $CONTAINER_APP_NAME \
     --resource-group $RESOURCE_GROUP
   

   PowerShell

   az containerapp exec `
     --name $CONTAINER_APP_NAME `
     --resource-group $RESOURCE_GROUP
   

   Este comando pode levar um momento para abrir o shell remoto. Quando o shell estiver pronto, você poderá interagir com a montagem de armazenamento por meio de comandos do sistema de arquivos.

2. Mude para a pasta nginx /var/log/nginx .

   Bash

   cd /var/log/nginx
   

   PowerShell

   cd /var/log/nginx
   

3. Volte ao navegador e navegue até o site e atualize a página algumas vezes.

   As solicitações feitas ao site criam uma série de entradas de fluxo de log.

4. Volte ao seu terminal e liste os /var/log/nginx valores da pasta.

   Bash

   ls
   

   PowerShell

   ls
   

   Observe como os arquivos access.log e error.log aparecem nesta pasta. Esses arquivos são gravados na montagem Arquivos do Azure em seu compartilhamento de Armazenamento do Azure criado nas etapas anteriores.

5. Exiba o conteúdo do arquivo access.log .

   Bash

   cat access.log
   

   PowerShell

   type access.log
   

6. Saia do shell interativo do contêiner para retornar à sessão do terminal local.

   Bash

   exit
   

   PowerShell

   exit
   

7. Agora, você pode exibir os arquivos no portal do Azure para verificar se eles existem em sua conta de Armazenamento do Azure. Imprima o nome da sua conta de armazenamento gerada aleatoriamente.

   Bash

   echo $STORAGE_ACCOUNT_NAME
   

   PowerShell

   echo $STORAGE_ACCOUNT_NAME
   

8. Navegue até o portal do Azure e abra a conta de armazenamento criada neste procedimento.

9. Em Armazenamento de Dados, selecione Compartilhamentos de arquivos.

10. Selecione myshare para visualizar os arquivos access.log e error.log .

Clean up resources (Limpar recursos)

Se você não vai continuar a usar este aplicativo, execute o seguinte comando para excluir o grupo de recursos junto com todos os recursos criados neste artigo.

Bash

az group delete \
  --name $RESOURCE_GROUP

PowerShell

az group delete `
  --name $RESOURCE_GROUP

Próximos passos

Conectar aplicativos de contêiner juntos