Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aprenda a gravar no armazenamento permanente em um aplicativo de contêiner usando uma montagem de armazenamento dos Arquivos do Azure. Para obter mais informações sobre montagens de armazenamento, consulte Usar montagens de armazenamento em Aplicativos de Contêiner do Azure.
Neste tutorial, você aprenderá como:
- Crie um ambiente de Aplicativos do Contêiner
- Criar uma conta de Armazenamento do Azure
- Definir um compartilhamento de arquivo na conta de armazenamento
- Vincular o ambiente ao compartilhamento de arquivos de armazenamento
- Montar o compartilhamento de armazenamento em um contêiner individual
- Verificar a montagem de armazenamento exibindo o log de acesso do site
Observação
Os Aplicativos de Contêiner do Azure dão suporte à montagem de compartilhamentos de arquivos por meio dos 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 definem variáveis de ambiente e garantem que sua extensão de Aplicativos de Contêiner esteja atualizada.
Entre na CLI do Azure.
az login
Configure variáveis de ambiente usadas em vários comandos a seguir.
RESOURCE_GROUP="my-container-apps-group" ENVIRONMENT_NAME="my-storage-environment" LOCATION="canadacentral"
Verifique se você tem a versão mais recente da extensão da CLI do Azure de Aplicativos de Contêiner.
az extension add -n containerapp --upgrade
Registre o namespace
Microsoft.App
.az provider register --namespace Microsoft.App
Registre o provedor
Microsoft.OperationalInsights
para o workspace do Azure Monitor Log Analytics se você não o tiver usado antes.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.
Crie um grupo de recursos.
az group create \ --name $RESOURCE_GROUP \ --location $LOCATION \ --query "properties.provisioningState"
Depois de criado, o comando retorna uma mensagem "Êxito".
Ao final deste tutorial, você pode excluir o grupo de recursos para remover todos os serviços criados durante este artigo.
Criar um ambiente dos Aplicativos de Contêiner.
az containerapp env create \ --name $ENVIRONMENT_NAME \ --resource-group $RESOURCE_GROUP \ --location "$LOCATION" \ --query "properties.provisioningState"
Depois de criado, o comando retorna uma mensagem "Êxito".
As montagens de armazenamento são associadas a um ambiente de Aplicativos de Contêiner e são configuradas em cada aplicativo de contêiner individual.
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.
Defina um nome de conta de armazenamento.
Esse comando gera um sufixo aleatório para o nome da conta de armazenamento para garantir a exclusividade.
STORAGE_ACCOUNT_NAME="myacastorageaccount$RANDOM"
Crie uma conta de armazenamento do Azure.
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
Depois de criado, o comando retorna uma mensagem "Êxito".
Defina um nome de compartilhamento de arquivo.
STORAGE_SHARE_NAME="myfileshare"
Crie o compartilhamento de arquivos do Armazenamento do Azure.
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
Obtenha a chave da conta de armazenamento.
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. Os Aplicativos de Contêiner não dão suporte ao acesso baseado em identidade aos compartilhamentos de arquivos do Azure.
Defina o nome da montagem de armazenamento.
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 a montagem de armazenamento
Agora você pode atualizar a configuração do aplicativo de contêiner para dar suporte à montagem de armazenamento.
Crie o link de armazenamento no ambiente.
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
Esse comando cria um link entre o ambiente do aplicativo de 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.
Defina o nome do aplicativo de contêiner.
CONTAINER_APP_NAME="my-container-app"
Crie o aplicativo de contêiner.
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
Esse comando exibe a URL do novo aplicativo de contêiner.
Copie a URL e cole no navegador da Web para navegar até o site.
Depois que a página for carregada, você verá a mensagem "Bem-vindo ao nginx!". Deixe esta guia do navegador aberta. Você retornará ao site durante as etapas de verificação de montagem de armazenamento.
Agora que você confirmou que o aplicativo de contêiner está configurado, você pode atualizar o aplicativo para incluir uma definição de ponto de montagem de armazenamento.
Exporte a configuração do aplicativo de contêiner.
az containerapp show \ --name $CONTAINER_APP_NAME \ --resource-group $RESOURCE_GROUP \ --output yaml > app.yaml
Observação
Embora este aplicativo não tenha segredos, muitos aplicativos têm segredos. Por padrão, quando você exporta a configuração de um aplicativo, os valores dos segredos não são incluídos no YAML gerado.
Se você não precisar alterar valores secretos, poderá remover a
secrets
seção e seus segredos permanecerão sem alterações. Alternativamente, se você precisar alterar o valor de um segredo, certifique-se de fornecer tantoname
quantovalue
para todos os segredos no arquivo antes de tentar atualizar o aplicativo. Omitir um segredo dasecrets
seção exclui o segredo.Abra app.yaml em um editor de código.
Substitua a
volumes: null
definição natemplate
seção por umavolumes:
definição que referencia o volume de armazenamento. A seção de modelo deve ser semelhante à seguinte:template: containers: - image: nginx imageType: ContainerImage name: my-container-app resources: cpu: 0.5 ephemeralStorage: 2Gi memory: 1Gi volumeMounts: - volumeName: my-azure-file-volume mountPath: /var/log/nginx initContainers: null revisionSuffix: '' scale: cooldownPeriod: 300 maxReplicas: 1 minReplicas: 1 pollingInterval: 30 rules: null serviceBinds: null terminationGracePeriodSeconds: null volumes: - name: my-azure-file-volume storageName: mystoragemount storageType: AzureFile
A nova
template.volumes
seção inclui as propriedades a seguir.Propriedade Descrição name
Esse valor corresponde ao volume criado chamando o az containerapp env storage set
comando.storageName
Esse valor define o nome usado por 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 de Arquivos do Azure é declarada. A seção
volumes
define volumes no nível do aplicativo que os contêineres de sidecar ou contêineres de sidecar do aplicativo podem referenciar por meio de uma seçãovolumeMounts
associada a um contêiner.Adicione uma
volumeMounts
seção aonginx
contêiner nacontainers
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:Propriedade Descrição volumeName
Esse valor deve corresponder ao nome definido na volumes
definição.mountPath
Esse valor define o caminho no contêiner em que o armazenamento está montado. Atualize o aplicativo de contêiner com a nova configuração de montagem de armazenamento.
az containerapp update \ --name $CONTAINER_APP_NAME \ --resource-group $RESOURCE_GROUP \ --yaml app.yaml \ --output table
Verificar a montagem de armazenamento
Agora que a montagem de armazenamento está estabelecida, você pode manipular arquivos no Armazenamento do Azure do seu contêiner. Use os comandos a seguir para observar a montagem de armazenamento no trabalho.
Abra um shell interativo dentro do aplicativo de contêiner para executar comandos dentro do contêiner em execução.
az containerapp exec \ --name $CONTAINER_APP_NAME \ --resource-group $RESOURCE_GROUP
Esse comando pode demorar um pouco 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. Para obter mais informações, consulte Conectar-se a um console de contêiner nos Aplicativos de Contêiner do Azure.
Altere para a pasta nginx /var/log/nginx.
cd /var/log/nginx
Retorne 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.
Retorne ao terminal e liste os valores da
/var/log/nginx
pasta.ls
Observe como os arquivos access.log e error.log aparecem nesta pasta. Esses arquivos são gravados na montagem dos Arquivos do Azure no compartilhamento de Armazenamento do Azure criado nas etapas anteriores.
Exiba o conteúdo do arquivo access.log .
cat access.log
Saia do shell interativo do contêiner para retornar à sessão do terminal local.
exit
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.
echo $STORAGE_ACCOUNT_NAME
Navegue até o portal do Azure e abra a conta de armazenamento criada neste procedimento.
Em Armazenamento de Dados , selecione Compartilhamentos de arquivos.
Selecione myshare para exibir os arquivos access.log e error.log .
Limpar os recursos
Se você não quiser continuar a usar esse aplicativo, execute o comando a seguir para excluir o grupo de recursos junto com todos os recursos criados neste artigo.
az group delete \
--name $RESOURCE_GROUP