Migrar software personalizado para o Serviço de Aplicativo do Azure usando um contêiner personalizado

O Serviço de Aplicativo do Azure fornece pilhas de aplicativos predefinidas, como ASP.NET ou Node.js, no Windows. Essas pilhas de aplicativos são executadas no IIS. O ambiente Windows pré-configurado bloqueia o sistema operacional de:

• Acesso administrativo.
• Instalações de software.
• Alterações no cache de assembly global.

Para obter mais informações, consulte a funcionalidade do sistema operacional no Serviço de Aplicativo.

É possível implantar uma imagem do Windows configurada de maneira personalizada do Visual Studio para fazer as alterações necessárias ao seu SO. Isso facilita a migração de um aplicativo local que requer uma configuração personalizada de so e software. Este tutorial demonstra como migrar para o Serviço de Aplicativo um aplicativo ASP.NET que usa fontes personalizadas instaladas na biblioteca de fontes do Windows. Implante uma imagem do Windows configurada de forma personalizada do Visual Studio para o Registro de Contêiner do Azure e, em seguida, execute-o no Serviço de Aplicativo.

Pré-requisitos

• Criar uma conta do Docker Hub.
• Instalar o Docker for Windows.
• Configurar o Docker para executar contêineres do Windows.
• Instale o Visual Studio 2022 com as cargas de trabalho de desenvolvimento do ASP.NET e para a Web e desenvolvimento do Azure. Se você já tiver o Visual Studio 2022 instalado:
  • Instale as atualizações mais recentes no Visual Studio selecionando Ajuda>Verificar Atualizações.
  • Adicione as cargas de trabalho no Visual Studio selecionando Ferramentas>Obter Ferramentas e Recursos.

Configure o aplicativo localmente

Baixar o exemplo

Nesta etapa, você deve configurar o projeto local do .NET.

• Baixar o projeto de exemplo.
• Extraia (descompacte) o arquivo custom-font-win-container-master.zip.

O projeto de amostra contém um aplicativo ASP.NET simples que usa uma fonte personalizada que está instalada na biblioteca de fontes do Windows. Não é necessário instalar fontes. No entanto, a amostra é um exemplo de aplicativo integrado ao sistema operacional subjacente. Para migrar esse aplicativo para o Serviço de Aplicativo, você refaz a arquitetura do código para remover a integração ou migra o código no estado em que se encontra em um contêiner personalizado do Windows.

Instalar a fonte

No Windows Explorer, acesse custom-font-win-container-master/CustomFontSample, clique com o botão direito do mouse FrederickatheGreat-Regular.ttf e selecione Instalar.

Essa fonte está publicamente disponível no Google Fonts.

Executar o aplicativo

Abra o arquivo custom-font-win-container-master/CustomFontSample.sln no Visual Studio.

Selecione Ctrl+F5 para executar o aplicativo sem depuração. O aplicativo é exibido no navegador padrão.

Como o aplicativo usa uma fonte instalada, o aplicativo não pode ser executado na área restrita do Serviço de Aplicativo. No entanto, você pode implantá-lo usando um contêiner do Windows, pois pode instalar a fonte no contêiner do Windows.

Configurar o contêiner do Windows

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto CustomFontSample e selecione Adicionar>Suporte de orquestração de contêiner.

Selecione Docker Compose>OK.

Seu projeto agora está definido para executar em um contêiner do Windows. Um Dockerfile é adicionado ao projeto CustomFontSample e um projeto docker-compose é adicionado à solução.

No Gerenciador de Soluções, abra o Dockerfile.

Você precisa usar uma imagem pai com suporte. Altere a imagem pai substituindo a linha FROM pelo código a seguir:

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019

Adicione a seguinte linha ao final do arquivo e salve o arquivo:

RUN ${source:-obj/Docker/publish/InstallFont.ps1}

Você pode encontrar InstallFont.ps1 no projeto CustomFontSample. É um script simples que instala a fonte. Você pode encontrar uma versão mais complexa do script na Galeria do PowerShell.

Observação

Para testar o contêiner do Windows localmente, verifique se o Docker iniciou no computador local.

Publicar no Registro de Contêiner do Azure

O Registro de Contêiner do Azure pode armazenar suas imagens para implantações de contêiner. Você pode configurar o Serviço de Aplicativo para usar imagens hospedadas no Registro de Contêiner.

Abrir a janela Publicar

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto CustomFontSample e selecione Publicar.

Criar e publicar o registro

1. Na janela Publicar , selecione o Azure e selecione Avançar.

2. Selecione o Registro de Contêiner do Azure e selecione Avançar.

3. Selecione a assinatura em que você deseja publicar o registro e, em seguida, selecione Criar novo.

Entrar com uma conta do Azure

Na janela do Registro de Contêiner do Azure , selecione Adicionar uma conta e entre em sua assinatura do Azure. Se você já estiver conectado, selecione a conta que contém a assinatura desejada na lista suspensa.

Configurar o registro

Configure o novo registro de contêiner usando os valores sugeridos na tabela a seguir como guia. Quando terminar, selecione Criar.

Configuração	Valor sugerido
Prefixo DNS	Mantenha o nome de registro gerado ou altere-o para outro nome exclusivo.
Grupo de recursos	Selecione Novo, insira myResourceGroup e selecione OK.
SKU	Básico. Para obter mais informações, consulte Tipos de preço.
Local do Registro	Oeste da Europa

Selecione Concluir.

Uma janela de terminal abre e exibe o progresso da implantação de imagem. Aguarde até que a implantação seja concluída.

Entrar no Azure

Entre no portal do Azure.

Criar um aplicativo Web

Selecione Criar um recurso e, em seguida, selecione Criar em Aplicativo Web.

Definir configurações básicas do aplicativo

Na guia Noções básicas , defina as configurações usando a tabela a seguir como guia.

Configuração	Valor sugerido
Assinatura	Verifique se a assinatura correta foi selecionada.
Grupo de recursos	Selecione Criar novo, insira myResourceGroup e selecione OK.
Nome	Insira um nome exclusivo. A URL do aplicativo Web é https://<app-name>.azurewebsites.net, em que <app-name> é o nome do aplicativo.
Publicar	Contêiner
Sistema operacional	Windows
Região	Oeste da Europa
Plano do Windows	Selecione Criar novo, insira myAppServicePlan e, em seguida, selecione OK.

A guia Noções Básicas deve ser semelhante a esta:

Configurar o contêiner do Windows

Na guia Contêiner , configure seu contêiner personalizado do Windows, conforme mostrado na tabela a seguir, e selecione Examinar + criar.

Configuração	Valor sugerido
Origem da Imagem	Registro de Contêiner do Azure
Registro	Selecione o registro criado anteriormente.
Imagem	customfontsample
Tag	mais recente

Concluir a criação do aplicativo

Selecione Criar e aguarde o Azure criar os recursos necessários.

Navegue até o aplicativo Web

Quando a implantação for concluída, uma mensagem de notificação será exibida:

1. Selecione Ir para o recurso.

2. Na página do aplicativo, selecione o link emURL.

Uma nova página do navegador é aberta na seguinte página:

Aguarde alguns minutos e tente novamente até acessar a home page com a fonte esperada:

Parabéns! Você migrou um aplicativo ASP.NET para o Serviço de Aplicativo em um contêiner do Windows.

Exibir os logs de inicialização do contêiner

Pode levar algum tempo para o contêiner do Windows carregar. Para conferir o progresso, vá para a URL a seguir. (substitua <app-name> pelo nome do seu aplicativo).

https://<app-name>.scm.azurewebsites.net/api/logstream

Os logs transmitidos têm esta aparência:

14/09/2018 23:16:19.889 INFO - Site: fonts-win-container - Creating container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest.
14/09/2018 23:16:19.928 INFO - Site: fonts-win-container - Create container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest succeeded. Container Id 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:23.405 INFO - Site: fonts-win-container - Start container succeeded. Container: 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Configuring container
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container start-up and configuration completed successfully

O Serviço de Aplicativo do Azure usa a tecnologia de contêiner do Docker para hospedar imagens internas e imagens personalizadas. Para ver uma lista de imagens internas, execute o comando da CLI do Azure, az webapp list-runtimes --os linux. Se essas imagens não atenderem às suas necessidades, você poderá criar e implantar uma imagem personalizada.

Observação

Seu contêiner deve ser direcionado para a arquitetura x86-64. O ARM64 não é suportado.

Neste tutorial, você aprenderá a:

• Efetuar push de uma imagem personalizada do Docker para o Registro de Contêiner do Azure.
• Implantar a imagem personalizada no Serviço de Aplicativo.
• Configurar variáveis de ambiente.
• Efetuar pull da imagem no Serviço de Aplicativo usando uma identidade gerenciada.
• Acessar logs de diagnóstico.
• Habilite CI/CD do Registro de Contêiner para o Serviço de Aplicativo.
• Conectar-se ao contêiner usando SSH.

Concluir este tutorial pode gerar uma pequena cobrança na sua conta do Azure pelo registro de contêiner e pode haver custos adicionais se você hospedar o contêiner por mais de um mês.

Configurar o seu ambiente inicial

Este tutorial exige a versão 2.0.80 ou posterior da CLI do Azure. Se você está usando o Azure Cloud Shell, a última versão já está instalada.

• Verifique se você tem uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

• Instale o Docker, que você usa para criar imagens do Docker. A instalação do Docker pode exigir a reinicialização do computador.

Após instalar o Docker, abra uma janela de terminal e verifique se o docker está instalado:

docker --version

Clonar ou baixar o aplicativo de exemplo

Você pode obter o exemplo deste tutorial por meio do clone ou download do Git.

Clonar o repositório usando o Git Bash

Clone o repositório de exemplo:

git clone https://github.com/Azure-Samples/docker-django-webapp-linux.git --config core.autocrlf=input

Inclua o argumento --config core.autocrlf=input para garantir terminações de linha adequadas nos arquivos que são usados no contêiner do Linux.

Em seguida, navegue até a pasta:

cd docker-django-webapp-linux

Baixar o ZIP do GitHub

Em vez de usar o clone do Git, você pode ir e https://github.com/Azure-Samples/docker-django-webapp-linux selecionarCEP de Download> de >.

Descompacte o arquivo ZIP em uma pasta chamada docker-django-webapp-linux.

Em seguida, abra uma janela do terminal na pasta docker-django-webapp-linux.

(Opcional) Examinar o arquivo Docker

A seguir está o arquivo no exemplo chamado Dockerfile. Esse arquivo descreve a imagem Docker e contém instruções de configuração.

FROM tiangolo/uwsgi-nginx-flask:python3.6

RUN mkdir /code
WORKDIR /code
ADD requirements.txt /code/
RUN pip install -r requirements.txt --no-cache-dir
ADD . /code/

# ssh
ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
 && apt-get install -y --no-install-recommends openssh-server \
 && echo "$SSH_PASSWD" | chpasswd 

COPY sshd_config /etc/ssh/
COPY init.sh /usr/local/bin/

RUN chmod u+x /usr/local/bin/init.sh
EXPOSE 8000 2222

#CMD ["python", "/code/manage.py", "runserver", "0.0.0.0:8000"]
ENTRYPOINT ["init.sh"]

• O primeiro grupo de comandos instala os requisitos do aplicativo no ambiente.
• O segundo grupo de comandos cria um servidor SSH para garantir uma comunicação mais segura entre o contêiner e o host.
• A última linha, ENTRYPOINT ["init.sh"], invoca init.sh para iniciar o serviço SSH e o servidor Python.

Criar e testar a imagem localmente

Observação

O Hub do Docker impõe cotas ao número de pulls anônimos por IP e ao número de pulls autenticados por usuário livre. Se você observar que seus pulls do Docker Hub estão sendo limitados, tente executar docker login se você ainda não estiver conectado.

1. Execute o seguinte comando para criar a imagem:

   docker build --tag appsvc-tutorial-custom-image .
   

2. Teste se o build funciona executando o contêiner do Docker localmente:

   docker run -it -p 8000:8000 appsvc-tutorial-custom-image
   

   Esse docker run comando especifica a porta usando o -p argumento e inclui o nome da imagem. -it permite que você interrompa usando Ctrl+C.

   Dica

   Se você estiver executando no Windows e vir o erro *standard_init_linux.go:211: o processo de usuário executivo causou "nenhum arquivo ou diretório desse tipo", o arquivo init.sh contém terminações de linha CRLF em vez das terminações de LF esperadas. Esse erro ocorre se você usou o Git para clonar o repositório de exemplo, mas omitiu o parâmetro --config core.autocrlf=input. Nesse caso, clone o repositório novamente com o argumento --config. Você também poderá ver o erro se você editou init.sh e o salvou com as terminações CRLF. Nesse caso, salve o arquivo novamente somente com as terminações LF.

3. Navegue para http://localhost:8000 para verificar se o aplicativo Web e o contêiner estão funcionando corretamente.

   

Criar uma identidade gerenciada atribuída ao usuário

O Serviço de Aplicativo pode usar uma identidade gerenciada padrão ou uma identidade gerenciada atribuída pelo usuário para se autenticar com um registro de contêiner. Neste tutorial, você usará uma identidade gerenciada atribuída pelo usuário.

CLI do Azure

1. Execute o comando az group create para criar um grupo de recursos:

   az group create --name msdocs-custom-container-tutorial --location westeurope
   

   Você pode alterar o valor de --location para especificar uma região perto de você.

2. Crie uma identidade gerenciada no grupo de recursos:

   az identity create --name myID --resource-group msdocs-custom-container-tutorial
   

Portal do Azure

1. No Portal do Azure:

   1. Insira Identidades Gerenciadas na caixa de pesquisa na parte superior do portal do Azure.

   2. Selecione o item com a etiqueta Identidades Gerenciadas no título Serviços.

   3. Selecione Criar. Você também pode ir diretamente para Criar Identidade Gerenciada Atribuída pelo Usuário .

      

2. Na página Criar Identidade Gerenciada Atribuída ao Usuário :

   1. Para Assinatura, selecione a assinatura na qual você deseja criar seus recursos.

   2. No grupo de recursos, selecione Criar novo, insira o nome msdocs-custom-container-tutorial para o grupo de recursos e selecione OK.

   3. Em Região, selecione Europa Ocidental ou uma região perto de você.

   4. Em Nome, insira myID.

      

3. Na guia Revisar + criar, selecione Criar.

   

4. Quando a criação da identidade for concluída, você poderá abrir sua página de gerenciamento selecionando Ir para o recurso.

   

Criar um registro de contêiner

CLI do Azure

1. Crie um registro de contêiner usando o comando az acr create a seguir. Substitua <registry-name> por um nome exclusivo para o registro. O nome deve conter apenas letras e números e ser exclusivo em todo o Azure.

   az acr create --name <registry-name> --resource-group msdocs-custom-container-tutorial --sku Basic --admin-enabled true
   

   O --admin-enabled parâmetro permite enviar imagens por push para o Registro usando credenciais administrativas.

2. Recupere as credenciais executando o comando az credential acr show:

   az acr credential show --resource-group msdocs-custom-container-tutorial --name <registry-name>
   

   A saída JSON desse comando fornece duas senhas junto com o nome de usuário do registro.

Portal do Azure

1. No Portal do Azure:

   1. Insira registros de contêiner na caixa de pesquisa na parte superior do portal do Azure.
   2. Selecione o item com a etiqueta Registros de contêiner no título Serviços.
   3. Selecione Criar.

   

2. Na página Criar registro de contêiner :

   1. Em Assinatura, selecione a assinatura usada anteriormente.
   2. Em Grupo de recursos, selecione msdocs-custom-container-tutorial.
   3. No nome do Registro, insira um nome exclusivo para o registro de contêiner.
   4. Em Localização, selecione Europa Ocidental ou a mesma região que sua identidade gerenciada.
   5. No plano de preços, selecione Básico.

   

3. Na guia Revisar + criar, selecione Criar.

   

4. Quando o registro de contêiner for criado, abra sua página de gerenciamento selecionando Ir para o recurso.

   

5. No painel esquerdo, em Configurações, selecione Chaves de Acesso.

6. Marque a caixa de seleção ao lado do usuário administrador.

7. Copie os valores para Servidor de logon, Nome de usuário e senha. Você os usará na próxima etapa para entrar no registro e efetuar push de uma imagem do Docker.

   

Enviar por push a imagem de exemplo para o Registro de Contêiner

Nesta seção, você envia a imagem por push para o Registro de Contêiner, que é usado pelo Serviço de Aplicativo posteriormente.

1. No terminal local em que você criou a imagem de exemplo, use o comando docker login para entrar no registro de contêiner:

   docker login <registry-name>.azurecr.io --username <registry-username>
   

   Substitua <registry-name> e <registry-username> por valores das etapas anteriores. Quando solicitado, digite uma das senhas da seção anterior.

   Use o mesmo nome do Registro em todas as etapas restantes desta seção.

2. Quando a conexão for bem-sucedida, marque sua imagem local do Docker no registro:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

3. Use o comando docker push para enviar por push a imagem para o registro:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   Carregar a imagem pela primeira vez pode levar alguns minutos porque inclui a imagem base. Os carregamentos subsequentes normalmente são mais rápidos.

   Enquanto estiver aguardando, você pode concluir as etapas na próxima seção para configurar o Serviço de Aplicativo para implantar usando o registro.

Autorizar a identidade gerenciada para o registro

A identidade gerenciada que você criou ainda não tem autorização para efetuar pull do registro de contêiner. Nesta etapa, você habilita a autorização.

CLI do Azure

1. Recupere o ID da entidade de segurança para a identidade gerenciada:

   principalId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query principalId --output tsv)
   

2. Recupere a ID do recurso para o registro de contêiner:

   registryId=$(az acr show --resource-group msdocs-custom-container-tutorial --name <registry-name> --query id --output tsv)
   

3. Conceda à identidade gerenciada permissão para acessar o registro de contêiner:

   az role assignment create --assignee $principalId --scope $registryId --role "AcrPull"
   

   Para obter mais informações sobre essas permissões, confira O que é o controle de acesso baseado em função do Azure?.

Portal do Azure

1. De volta à página de gerenciamento do registro de contêiner:

   1. No painel esquerdo, selecione Controle de acesso (IAM).
   2. Selecione Adicionar atribuição de função.

   

2. Na guia Funções de função Trabalho , selecione AcrPull na lista de funções.

   

3. Na guia Membros , em Atribuir acesso, selecione Identidade gerenciada.

4. Em Membros, selecione Selecionar membros.

   

5. No painel Selecionar identidades gerenciadas , na identidade gerenciada, selecione a identidade gerenciada atribuída pelo usuário.

6. Selecione myID.

   

7. Na parte inferior da guia Examinar + atribuir , selecione Examinar + atribuir.

   

Criar o aplicativo Web

CLI do Azure

1. Crie um plano do Serviço de Aplicativo usando o az appservice plan create comando:

   az appservice plan create --name myAppServicePlan --resource-group msdocs-custom-container-tutorial --is-linux
   

   Um plano do Serviço de Aplicativo corresponde à máquina virtual que hospeda o aplicativo Web. Por padrão, o comando anterior usa um tipo de preço B1 econômico que é gratuito no primeiro mês. Você pode especificar a camada de serviço usando o parâmetro --sku.

2. Crie o aplicativo Web com o comando az webapp create:

   az webapp create --resource-group msdocs-custom-container-tutorial --plan myAppServicePlan --name <app-name> --deployment-container-image-name <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   Substitua <app-name> por um nome para o aplicativo Web. O nome precisa ser exclusivo em todo o Azure. Além disso, substitua <registry-name> pelo nome do registro da etapa anterior.

   Dica

   Você pode recuperar as configurações de contêiner do aplicativo Web a qualquer momento com o comando az webapp config container show --name <app-name> --resource-group msdocs-custom-container-tutorial. A imagem é especificada na propriedade DOCKER_CUSTOM_IMAGE_NAME. Quando o aplicativo Web é implantado por meio do Azure DevOps ou dos modelos do Azure Resource Manager, a imagem também pode aparecer em uma propriedade chamada LinuxFxVersion. Ambas as propriedades têm a mesma finalidade. Se ambas estiverem presentes na configuração do aplicativo Web, LinuxFxVersion terá precedência.

Portal do Azure

1. No portal do Azure:

   1. Insira o aplicativo na caixa de pesquisa na parte superior do portal do Azure.

   2. Selecione o item com a etiqueta Serviços de Aplicativo no título Serviços.

   3. Selecione Criar>Aplicativo Web. Você também pode ir diretamente para Criar Aplicativo Web .

      

   4. Na página Criar Aplicativo Web :

      1. Em Assinatura, selecione a assinatura usada anteriormente.
      2. Em Grupo de recursos, selecione msdocs-custom-container-tutorial.
      3. Em Nome, insira um nome de aplicativo exclusivo. Esse nome será usado no nome do host padrão do aplicativo: <app-name>.azurewebsites.net.
      4. Em Publicar, selecione Contêiner.
      5. Em Sistema operacional, selecione Linux.
      6. Em Região, selecione Europa Ocidental ou uma região perto de você.
      7. No Plano linux, selecione Criar novo, digite um nome de plano e selecione OK.
      8. No plano de preços, selecione Básico B1.

      

   5. Selecione a guia Contêiner.

   6. Em Origem da imagem, selecione Registro de Contêiner do Azure.

   7. Em Registro, selecione o registro de contêiner criado anteriormente.

   8. Em Identidade, selecione myID.

   9. Em Imagem, selecione appsvc-tutorial-custom-image.

   10. Em Tag, selecione mais recente.

       

   11. Na guia Revisar + criar, selecione Criar.

       

   12. Quando o aplicativo Web é criado, você pode abrir sua página de gerenciamento selecionando Ir para o recurso.

       

Configurar o aplicativo Web

Nesta etapa, você configura o aplicativo Web da seguinte maneira:

• Configure o aplicativo para enviar solicitações para a porta 8000. O contêiner de amostra está escutando na porta 8000 para solicitações da Web.
• Configure seu aplicativo para usar a identidade gerenciada para efetuar pull de imagens do registro de contêiner.
• Configure a implantação contínua do registro de contêiner. (Cada push de imagem para o registro disparará seu aplicativo para efetuar pull da nova imagem.) Esta etapa não é necessária para configurar seu aplicativo Web para efetuar pull do registro de contêiner, mas pode notificar o aplicativo Web quando uma nova imagem é enviada por push para o registro. Se você não concluir essa etapa, será necessário disparar manualmente um pull de imagem reiniciando o aplicativo Web.

CLI do Azure

1. Use az webapp config appsettings set para definir a variável de ambiente WEBSITES_PORT conforme esperado pelo código do aplicativo:

   az webapp config appsettings set --resource-group msdocs-custom-container-tutorial --name <app-name> --settings WEBSITES_PORT=8000
   

   Substitua <app-name> pelo nome usado na etapa anterior.

2. Habilite a identidade gerenciada atribuída pelo usuário no aplicativo Web usando o az webapp identity assign comando:

   id=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query id --output tsv)
   az webapp identity assign --resource-group msdocs-custom-container-tutorial --name <app-name> --identities $id
   

   Substitua <app-name> pelo nome usado na etapa anterior.

3. Configure seu aplicativo para efetuar pull do Registro de Contêiner usando identidades gerenciadas.

   appConfig=$(az webapp config show --resource-group msdocs-custom-container-tutorial --name <app-name> --query id --output tsv)
   az resource update --ids $appConfig --set properties.acrUseManagedIdentityCreds=True
   

   Substitua <app-name> pelo nome usado na etapa anterior.

4. Defina a ID do cliente que seu aplicativo Web usa para efetuar pull do Registro de Contêiner. Essa etapa não será necessária se você usar a identidade gerenciada atribuída pelo sistema.

   clientId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query clientId --output tsv)
   az resource update --ids $appConfig --set properties.AcrUserManagedIdentityID=$clientId
   

5. Habilite CI/CD no Serviço de Aplicativo.

   cicdUrl=$(az webapp deployment container config --enable-cd true --name <app-name> --resource-group msdocs-custom-container-tutorial --query CI_CD_URL --output tsv)
   

   CI_CD_URL é uma URL que o Serviço de Aplicativo gera para você. O registro deve usar essa URL para notificar o Serviço de Aplicativo de que ocorreu um push de imagem. Na verdade, ele não cria o webhook para você.

6. Crie um webhook no registro de contêiner. Use o CI_CD_URL que você obteve na última etapa.

   az acr webhook create --name appserviceCD --registry <registry-name> --uri $cicdUrl --actions push --scope appsvc-tutorial-custom-image:latest
   

7. Para testar se o webhook está configurado corretamente, faça ping no webhook e veja se você obtém uma resposta 200 OK.

   eventId=$(az acr webhook ping --name appserviceCD --registry <registry-name> --query id --output tsv)
   az acr webhook list-events --name appserviceCD --registry <registry-name> --query "[?id=='$eventId'].eventResponseMessage"
   

   Dica

   Para ver todas as informações sobre todos os eventos de webhook, remova o parâmetro --query.

   Se você estiver transmitindo o log de contêiner, deverá ver um mensagem após o ping do webhook: Starting container for site, porque o webhook dispara a reinicialização do aplicativo.

Portal do Azure

1. No painel esquerdo da página de gerenciamento do aplicativo Web, em Configurações, selecione Variáveis de ambiente.

   

2. Na página Variáveis de ambiente :

   1. Selecione Adicionar.

   2. Em Nome, insira WEBSITES_PORT.

   3. Em Valor, insira 8000.

   4. Selecione Aplicar no painel de configuração Adicionar/Editar aplicativo e selecione Aplicar novamente. Confirme a alteração.

      A configuração WEBSITES_PORT especifica a porta do contêiner para a qual encaminhar solicitações da Web. Para obter mais informações, consulte Contêineres personalizados.

   

3. No painel esquerdo, selecione Identidade.

4. Na página Identidade , na guia Atribuído pelo usuário , selecione Adicionar.

   

5. Selecione myID e, em seguida, selecione Adicionar.

   

6. No painel esquerdo, em Implantação, selecione Centro de Implantação. Em seguida, faça o seguinte na página do Centro de Implantação :

   1. Na guia Contêineres , selecione a implantação listada.
   2. No painel Editar contêiner , em Autenticação, verifique se a Identidade Gerenciada está selecionada.
   3. Em Identidade, verifique se myID está selecionado. Se você fez alterações, selecione Aplicar.
   4. De volta à página Centro de Implantação , selecione Implantação contínua para o contêiner principal e selecione Aplicar.

   

7. Na página Centro de Implantação , selecione a guia Logs . Nesta guia, você pode ver mensagens de log para efetuar pull da imagem e iniciar o contêiner. Mais adiante, você aprenderá a visualizar as mensagens do console geradas dentro do contêiner.

   

Navegue até o aplicativo Web

CLI do Azure

Para testar o aplicativo, navegue até https://<app-name>.azurewebsites.net. Substitua <app-name> pelo nome do aplicativo Web.

Portal do Azure

1. Na página Serviço de Aplicativo, no painel esquerdo, selecione Visão geral.

2. Selecione o botão Procurar na parte superior da página.

   

Na primeira vez que você tentar acessar o aplicativo, poderá demorar algum tempo até o aplicativo responder porque o Serviço de Aplicativo precisará efetuar pull da imagem inteira do registro. Se o navegador atingir o tempo limite, bastará atualizar a página. Depois que a imagem inicial for puxada, os testes subsequentes serão executados muito mais rapidamente.

Acessar logs de diagnóstico

CLI do Azure

Enquanto você aguarda o Serviço de Aplicativo efetuar pull da imagem, é interessante ver exatamente o que o Serviço de Aplicativo está fazendo ao transmitir os logs do contêiner para o seu terminal.

1. Ativar o registro em log de contêiner:

   az webapp log config --name <app-name> --resource-group msdocs-custom-container-tutorial --docker-container-logging filesystem
   

2. Habilitar o fluxo de log:

   az webapp log tail --name <app-name> --resource-group msdocs-custom-container-tutorial
   

   Se você não vir os logs do console imediatamente, verifique novamente após 30 segundos.

   Você também pode inspecionar os arquivos de log de um navegador acessando https://<app-name>.scm.azurewebsites.net/api/logs/docker.

3. Para interromper o streaming de log a qualquer momento, selecione Ctrl+C.

Portal do Azure

Na página do Centro de Implantação, você já pode ver as mensagens de log para efetuar pull e iniciar o contêiner. Nesta etapa, você habilitará o registro em log da saída do console de dentro do contêiner.

1. Na página do Serviço de Aplicativo:

   1. No painel esquerdo, em Monitoramento, selecione logs do Serviço de Aplicativo.
   2. Em log do aplicativo, selecione sistema de arquivos.
   3. Selecione Salvar.

   

2. No painel esquerdo, em Monitoramento, selecione Fluxo de log. Você deve ver a saída do console do contêiner no fluxo de log.

   

Modificar o código do aplicativo e reimplantar

Nesta seção, você faz uma alteração no código do aplicativo Web, recompila a imagem e envia por push o registro do contêiner. Em seguida, o Serviço de Aplicativo extrai automaticamente a imagem atualizada do registro para atualizar o aplicativo Web em execução.

1. Na pasta local docker-django-webapp-linux, abra o arquivo app/templates/app/index.html.

2. Altere o primeiro elemento HTML para corresponder ao código a seguir.

   <nav class="navbar navbar-inverse navbar-fixed-top">
     <div class="container">
       <div class="navbar-header">
         <a class="navbar-brand" href="#">Azure App Service - Updated Here!</a>
       </div>
     </div>
   </nav>
   

3. Salve suas alterações.

4. Vá para a pasta docker-django-webapp-linux e recompile a imagem:

   docker build --tag appsvc-tutorial-custom-image .
   

5. Atualize a marca da imagem para latest:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   Substitua <registry-name> pelo nome do seu Registro.

6. Efetue push da imagem para o registro:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

7. Quando o push da imagem terminar, o webhook notificará o Serviço de Aplicativo sobre o push e o Serviço de Aplicativo tentará efetuar o pull da imagem atualizada. Aguarde alguns minutos e verifique se a atualização foi implantada acessando https://<app-name>.azurewebsites.net.

Conectar-se ao contêiner usando o SSH

O SSH possibilita uma comunicação mais segura entre um contêiner e um cliente. Para habilitar uma conexão SSH com seu contêiner, você precisa configurar sua imagem personalizada para isso. Quando o contêiner estiver em execução, você poderá abrir uma conexão SSH.

Configurar o contêiner para SSH

O aplicativo de exemplo usado neste tutorial já tem a configuração necessária no Dockerfile, que instala o servidor SSH e também define as credenciais de entrada. Esta seção é apenas informativa. Para conectar o contêiner, vá para a próxima seção.

ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
  && apt-get install -y --no-install-recommends openssh-server \
  && echo "$SSH_PASSWD" | chpasswd 

Observação

Essa configuração não permite conexões externas com o contêiner. O SSH só está disponível por meio do site do Kudu/SCM. O site do Kudu/SCM é autenticado com sua conta do Azure. root:Docker! não deve ser alterado quando você usa SSH. O SCM/KUDU usa suas credenciais do portal do Azure. Alterar esse valor causará um erro quando você for usar o SSH.

O Dockerfile também copia o arquivo sshd_config para a pasta /etc/ssh/ e expõe a porta 2222 no contêiner:

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

A porta 2222 é uma porta interna que pode ser acessada somente por contêineres dentro da rede de ponte de uma rede virtual privada.

Por fim, o script de entrada init.sh inicia o servidor SSH.

#!/bin/bash
service ssh start

Abrir a conexão SSH com o contêiner

CLI do Azure

1. https://<app-name>.scm.azurewebsites.net/webssh/host Acesse e entre com sua conta do Azure. Substitua <app-name> pelo nome do aplicativo Web.

2. Ao entrar, você será redirecionado para uma página informativa do aplicativo Web. Selecione SSH na parte superior da página para abrir o shell e usar os comandos.

   Por exemplo, você pode examinar os processos em execução no aplicativo usando o comando top.

Portal do Azure

1. Na página do Serviço de Aplicativo:

   1. No painel esquerdo, em Ferramentas de Desenvolvimento, selecione SSH.
   2. Selecione Ir.

   

2. A sessão SSH é aberta em uma nova guia do navegador. Aguarde até que a barra de status na parte inferior mostre uma mensagem SSH CONNECTION ESTABLISHED verde. Em seguida, você pode executar comandos de dentro do contêiner. As alterações de configuração feitas no contêiner não são persistentes entre as reinicializações do aplicativo.

   

Limpar os recursos

CLI do Azure

Os recursos que você criou neste artigo podem gerar custos contínuos. Para limpar os recursos, você só precisa excluir o grupo de recursos que os contém:

az group delete --name msdocs-custom-container-tutorial

Portal do Azure

1. Na caixa de pesquisa na parte superior do portal do Azure:

   1. Insira o nome do grupo de recursos.
   2. Selecione o grupo de recursos.

   

2. Na página Grupo de recursos, selecione Excluir grupo de recursos.

   

3. Insira o nome do grupo de recursos para confirmar sua exclusão e selecione Excluir.

   

Próximas etapas

O que você aprendeu:

• Implantar uma imagem personalizada em um registro de contêiner particular.
• Implantar a imagem personalizada no Serviço de Aplicativo.
• Atualizar e reimplantar a imagem.
• Acessar logs de diagnóstico.
• Conectar-se ao contêiner usando SSH.

• Envie uma imagem personalizada do Docker para o Registro de Contêiner.
• Implantar a imagem personalizada no Serviço de Aplicativo.
• Configurar variáveis de ambiente.
• Efetuar pull da imagem no Serviço de Aplicativo usando uma identidade gerenciada.
• Acessar logs de diagnóstico.
• Habilite CI/CD do Registro de Contêiner para o Serviço de Aplicativo.
• Conectar-se ao contêiner usando SSH.

Vá para o próximo tutorial:

  Fornecer segurança com um domínio e um certificado personalizados

Ou confira outros recursos:

Configurar um contêiner personalizado

Configurar um contêiner de sidecar para um contêiner personalizado no Serviço de Aplicativo