Início Rápido: Usar a Configuração de Aplicativos do Azure nos Aplicativos de Contêiner do Azure

Neste início rápido, você usará a Configuração de Aplicativos do Azure em um aplicativo em execução nos Aplicativos de Contêiner do Azure. Dessa forma, você pode centralizar o armazenamento e o gerenciamento da configuração de seus aplicativos nos Aplicativos de Contêiner. Este início rápido aproveita o aplicativo ASP.NET Core criado no Início Rápido: Criar um aplicativo ASP.NET Core com a Configuração de Aplicativos. Você colocará o aplicativo em contêiner e o implantará nos Aplicativos de Contêiner do Azure. Conclua o início rápido antes de continuar.

Dica

Ao seguir este início rápido, de preferência registre todos os novos recursos em um único grupo de recursos, para que você possa reagrupá-los em um único local e excluí-los mais rapidamente depois, se você não precisar mais deles.

Pré-requisitos

• Um aplicativo usando um repositório da Configuração de Aplicativos. Se você não tiver uma, crie uma instância usando o Início Rápido: Criar um aplicativo ASP.NET Core com a Configuração de Aplicativos.
• Uma instância dos Aplicativos de Contêiner do Azure. Se você não tiver uma, crie uma instância usando o portal do Azure ou a CLI.
• Docker Desktop
• A CLI do Azure

---

Conectar a Configuração de Aplicativos do Azure ao aplicativo de contêiner

No portal do Azure, navegue até a instância do Aplicativo de Contêiner. Siga o início rápido do Conector de Serviço para Aplicativos de Contêiner do Azure para criar uma conexão de serviço com seu repositório da Configuração de Aplicativos usando as configurações abaixo.

• Na guia Básico:

  • selecione Configuração de Aplicativos para Tipo de serviço

  • escolha seu repositório da Configuração de Aplicativos para "Configuração de Aplicativos"

    

• Na guia Autenticação:

  • escolha o tipo de autenticação Cadeia de conexão e Somente Leitura para "Permissões para cadeia de conexão
  • expanda o menu Avançado. Nas informações de Configuração, deve haver uma variável de ambiente já criada chamada "AZURE_APPCONFIGURATION_CONNECTIONSTRING". Edite a variável de ambiente selecionando o ícone à direita e altere o nome para ConnectionStrings__AppConfig. Precisamos fazer essa alteração, pois ConnectionStrings__AppConfig é o nome da variável de ambiente que o aplicativo criado no início rápido do ASP.NET Core procurará. Essa é a variável de ambiente que contém a cadeia de conexão para a Configuração de Aplicativos. Se você usou outro aplicativo para seguir este início rápido, use o nome da variável de ambiente correspondente. Em seguida, selecione Concluído.

• Use valores padrão para todo o resto.

Depois de concluída, uma variável de ambiente chamada ConnectionStrings__AppConfig será adicionada ao contêiner do Aplicativo de Contêiner. Seu valor é uma referência do segredo do Aplicativo de Contêiner, a cadeia de conexão do repositório da Configuração de Aplicativos.

Compilar um contêiner

1. Execute o comando dotnet publish para compilar o aplicativo no modo de versão e criar os ativos na pasta publicada.

   dotnet publish -c Release -o published
   

2. Crie um arquivo chamado Dockerfile no diretório que contém o arquivo .csproj, abra-o em um editor de texto e insira o conteúdo a seguir. Um Dockerfile é um arquivo de texto que não tem uma extensão e que é usado para criar uma imagem de contêiner.

   FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
   WORKDIR /app
   COPY published/ ./
   ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
   

3. Compile o contêiner executando o comando a seguir.

   docker build --tag aspnetapp .
   

Cria uma instância do Registro de Contêiner do Azure

Criar um ACR (Registro de Contêiner do Azure). O ACR permite que você compile, armazene e gerencie as imagens de contêiner.

Portal

1. Para criar o registro de contêiner, siga o início rápido do Registro de Contêiner do Azure.
2. Depois que a implantação for concluída, abra a instância do ACR e, no menu à esquerda, selecione Configurações > Chaves de acesso.
3. Anote o valor do Servidor de logon listado nesta página. Você usará essas informações em uma etapa posterior.
4. Alterne o Usuário administrador para Habilitado. Essa opção permite conectar o ACR aos Aplicativos de Contêiner do Azure usando credenciais de usuário administrador. Como alternativa, você pode deixá-lo desabilitado e configurar o aplicativo de contêiner para efetuar pull de imagens do registro com uma identidade gerenciada.

CLI do Azure

1. Crie uma instância do ACR usando o comando a seguir. Ele cria um registro de camada básica chamado myregistry com o usuário administrador habilitado que permite que o aplicativo de contêiner se conecte ao registro usando credenciais de usuário administrador. Para saber mais, confira Início rápido do Registro de Contêiner do Azure.

   az acr create 
   --resource-group AppConfigTestResources \
   --name myregistry \
   --admin-enabled true \
   --sku Basic
   

2. Na saída do comando, anote o valor do servidor de logon do ACR listado após loginServer.

3. Recupere o nome de usuário e a senha do ACR executando az acr credential show --name myregistry. Você precisará desses valores mais tarde.

Enviar a imagem por push ao Registro de Contêiner do Azure

Envie por push a imagem do Docker para o ACR criado anteriormente.

1. Use o comando az acr login para fazer logon no registro.

   az acr login --name myregistry
   

   O comando retorna Login Succeeded quando o logon for bem-sucedido.

2. Use docker tag para marcar os detalhes apropriados da imagem.

   docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
   

   Dica

   Para examinar a lista de imagens e tags existentes do Docker, execute docker image ls. Neste cenário, você deverá ver pelo menos duas imagens: aspnetapp e myregistry.azurecr.io/aspnetapp.

3. Use docker push para efetuar push da imagem para o registro de contêiner. Este exemplo cria o repositório aspnetapp no ACR que contém a imagem aspnetapp. No exemplo abaixo, substitua os espaços reservados <login-server<image-name> e <tag> pelo valor do servidor de logon do ACR, o nome da imagem e a tag da imagem.

   Método:

   docker push <login-server>/<image-name>:<tag>
   

   Exemplo:

   docker push myregistry.azurecr.io/aspnetapp:v1
   

4. Abra seu Registro de Contêiner do Azure no portal do Azure e confirme que, em Repositórios, você pode ver seu novo repositório.

   

Adicionar sua imagem de contêiner aos Aplicativos de Contêiner do Azure

Atualize seu Aplicativo de Contêiner para carregar a imagem de contêiner do ACR.

1. No portal do Azure, abra a instância dos Aplicativos de Contêiner do Azure.

2. No menu à esquerda, em Aplicativo, selecione Contêineres.

3. Selecione Editar e implantar.

4. Em Imagem de contêiner, clique no nome da imagem de contêiner existente.

5. Atualize as seguintes configurações:

   Configuração	Valor sugerido	Descrição
   Origem da imagem	Registro de Contêiner do Azure	Selecione Registro de Contêiner do Azure como a origem da imagem.
   Autenticação	Credenciais de Administrador	Use a opção de credencial de usuário administrador que foi habilitada anteriormente no registro de contêiner. Se você não habilitou o usuário administrador, mas configurou para usar uma identidade gerenciada, deverá inserir manualmente a imagem e a tag no formulário.
   Registro	myregistry.azurecr.io	Selecione o Registro de Contêiner do Azure que você criou anteriormente.
   Imagem	aspnetapp	Selecione a imagem do Docker que você criou e efetuou push para o ACR anteriormente.
   Tag de imagem	v1	Selecione sua tag de imagem da lista.

6. Selecione Salvar e, em seguida, Criar para implantar a atualização no Aplicativo de Contêiner do Azure.

Navegue até a URL do Aplicativo de Contêiner do Azure

No portal do Azure, na instância dos Aplicativos de Contêiner do Azure, vá para a guia Visão geral e abra a URL do Aplicativo.

A página da Web tem esta aparência:

Limpar os recursos

Se não deseja continuar usando os recursos criados neste artigo, exclua o grupo de recursos que você criou aqui para evitar encargos.

Importante

A exclusão de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos contidos nele são excluídos permanentemente. Não exclua acidentalmente grupo de recursos ou recursos incorretos. Se tiver criado os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que você deseja manter, exclua cada um individualmente do respectivo painel em vez de excluir o grupo de recursos.

1. Entre no portal do Azure e selecione Grupos de recursos.
2. Na caixa Filtrar por nome..., digite o nome do seu grupo de recursos.
3. Na lista de resultados, selecione o nome do grupo de recursos para conferir uma visão geral.
4. Selecione Excluir grupo de recursos.
5. Você receberá uma solicitação para confirmar a exclusão do grupo de recursos. Insira o nome do grupo de recursos para confirmar e selecione Excluir.

Após alguns instantes, o grupo de recursos e todos os recursos dele são excluídos.

Próximas etapas

Neste início rápido, você:

• Configuração de Aplicativos do Azure Conectados aos Aplicativos de Contêiner do Azure
• Docker usado para criar uma imagem de contêiner de um aplicativo ASP.NET Core com configurações da Configuração de Aplicativos
• Criada uma instância do Registro de Contêiner do Azure
• Push efetuado da imagem para uma instância do Registro de Contêiner do Azure
• Adicionada a imagem de contêiner para os Aplicativos de Contêiner do Azure
• Navegado até a URL da instância dos Aplicativos de Contêiner do Azure atualizada com as configurações do seu repositório da Configuração de Aplicativos.

A identidade gerenciada permite que um recurso do Azure acesse outro sem que você mantenha segredos. Você pode simplificar o acesso dos Aplicativos de Contêiner a outros recursos do Azure. Para obter mais informações, veja como acessar a Configuração de Aplicativos usando a identidade gerenciada e como [acessar o Registro de Contêiner usando a identidade gerenciada].

Para saber como configurar seu aplicativo Web ASP.NET Core para atualizar dinamicamente as configurações, passe para o próximo tutorial.

Habilitar configuração dinâmica