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 um contêiner e o implantará nos Aplicativos de Contêiner do Azure. Conclua o início rápido antes de continuar.

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

1. No portal do Azure, navegue até a instância do Aplicativo de Contêiner.

2. Acompanhe o início rápido do Conector de Serviço para Aplicativos de Contêiner do Azure a fim de criar uma conexão de serviço para seu repositório da Configuração de Aplicativos usando as configurações a seguir.

   1. Na guia Básico:

      • Em Tipo de serviço, selecione Configuração de Aplicativos

      • Em Configuração de Aplicativos, selecione o repositório da Configuração de Aplicativos.

        

   2. Na guia Autenticação:

      • Selecione o tipo de autenticação Identidade gerenciada atribuída pelo sistema
      • Expanda o menu Avançado
      • Atribua à sua identidade a função Leitor de Dados da Configuração de Aplicativos
      • Em Informações de configuração, você encontra uma variável de ambiente chamada AZURE_APPCONFIGURATION_ENDPOINT. Selecione o ícone de lápis à direita e edite o nome da variável de ambiente para que ela corresponda ao nome da variável no aplicativo do qual você carrega o ponto de extremidade da Configuração de Aplicativos. Se você criou seu aplicativo com base no início rápido do ASP.NET Core, o nome da variável é Endpoints:AppConfiguration. Ao editar o nome da variável, substitua os dois-pontos por sublinhados duplos para que ele se torne Endpoints__AppConfiguration. Se estiver trabalhando com outro aplicativo, insira o nome da variável de ambiente correspondente e selecione Concluído.

   3. Use valores padrão para todo o resto.

   Quando a conexão é criada, uma variável de ambiente chamada Endpoints__AppConfiguration é adicionada ao contêiner do recurso do Aplicativo de Contêiner. O valor dela é uma referência do segredo do Aplicativo de Contêiner, o ponto de extremidade 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.

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.

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.

Conteúdo relacionado

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, confira 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.