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 predefinidos em Windows, como ASP.NET ou Node.js, em execução 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 saber mais, confira Funcionalidade do sistema operacional no Serviço de Aplicativo do Azure.

É possível implantar uma imagem do Windows configurada de maneira personalizada do Visual Studio para fazer as alterações necessárias ao seu SO. Portanto, é fácil migrar o aplicativo local que requer a 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.

Shows the web app running in a Windows container.

Pré-requisitos

Para concluir este tutorial:

Configure o aplicativo localmente

Baixar o exemplo

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

O projeto de exemplo 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, navegue até 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.

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

Screenshot showing the app displayed in the default browser.

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 em vez disso, pois é possível 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.

Screenshot of the Solution Explorer window showing the CustomFontSample project, Add, and Container Orchestrator Support menu items selected.

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 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

No final do arquivo, adicione a seguinte linha 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. É possível configurar o Serviço de Aplicativo para usar imagens hospedadas no Registro de Contêiner do Azure.

Abrir o assistente de publicação

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

Screenshot of Solution Explorer showing the CustomFontSample project and Publish selected.

Criar registro e publicar

No assistente de publicação, selecione Registro de Contêiner>Criar novo Registro de Contêiner do Azure>Publicar.

Screenshot of the publish wizard showing Container Registry, Create New Azure Container Registry, and the Publish button selected.

Entre com a conta do Azure

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

Sign in to Azure.

Configurar o registro

Configure o novo registro de contêiner com base nos valores sugeridos na tabela a seguir. Quando terminar, selecione Criar.

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

Configure Azure container registry.

Uma janela de terminal é aberta 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

No menu à esquerda, selecione Criar um recurso>Web>Aplicativo Web para Contêineres.

Definir configurações básicas do aplicativo

Na guia Básico, defina as configurações de acordo com a tabela a seguir e, em seguida, selecione Avançar: Docker.

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

A guia Básico deverá ter esta aparência:

Shows the Basics tab used to configure the web app.

Configurar o contêiner do Windows

Na guia Docker, configure o contêiner do Windows personalizado conforme mostrado na tabela a seguir e selecione Revisar + 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 operação do Azure for concluída, uma caixa de notificação será exibida.

Shows that the Azure operation is complete.

  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:

Shows the new browser page for the web app.

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

Shows the homepage with the font you configured.

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

Conferir logs de inicialização do contêiner

Pode levar algum tempo para o contêiner do Windows carregar. Para ver o progresso, acesse a seguinte URL, substituindo o <nome de aplicativo> 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 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

O contêiner deve ter como destino a arquitetura x86-x64; o ARM64 não tem suporte.

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
  • Habilitar CI/CD do Registro de Contêiner do Azure para o Serviço de Aplicativo
  • Conectar-se ao contêiner usando SSH

Concluir este tutorial incorre em um pequeno encargo na sua conta do Azure para o registro de contêiner e poderá incorrer em mais custos ao 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.

  • 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 de download ou git clone.

Clonar com git

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 do GitHub

Em vez de usar git clone, você pode visitar https://github.com/Azure-Samples/docker-django-webapp-linux, selecionar Clonar e Baixar ZIP.

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

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

(Opcional) Examinar o arquivo Docker

O arquivo no exemplo intitulado Dockerfile que descreve a imagem do 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.
  • Os segundo grupo de comando cria um servidor SSH para a comunicação 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 Docker Hub tem cotas no número de pulls anônimos por IP e o número de pulls autenticados por usuário gratuito (confira Transferência de dados). Se você observar que seus pulls do Docker Hub estão sendo limitados, tente 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
    

    O comando docker run especifica a porta com o argumento -p seguido pelo nome da imagem. -it permite que você pare com Ctrl+C.

    Dica

    Se estiver em execução no Windows e você visualizar o erro standard_init_linux.go:211: exec user process caused "no such file or directory", o arquivo init.sh conterá as terminações de linha CR-LF, em vez das terminações 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.

    Test web app locally.

I. 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 autenticar com um registro de contêiner. Neste tutorial, você usará uma identidade gerenciada atribuída pelo usuário.

  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
    

II. Criar um registro de contêiner

  1. Crie um registro de contêiner com o comando az acr create e 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 parâmetro --admin-enabled permite enviar imagens por push para o registro usando um conjunto de credenciais administrativas.

  2. Recupere as credenciais executando o comando az 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.

III. Efetue push na imagem de exemplo para o Registro de Contêiner do Azure

Nesta seção, você efetua push na imagem para o Registro de Contêiner do Azure, que será 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 etapa anterior.

    Use o mesmo nome de 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.

IV. 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.

  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?.

V. Criar o aplicativo Web

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

    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 controlar o nível com 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, que 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.

VI. Configurar o aplicativo Web

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

  • O contêiner de amostra está escutando na porta 8000 para solicitações da Web e você configura o aplicativo para enviar solicitações para a porta 8000.
  • Diga ao seu aplicativo para usar a identidade gerenciada para extrair imagens do seu registro de contêiner.
  • Configure a implantação contínua do registro de contêiner (ou, cada push de imagem para o registro disparará seu aplicativo para efetuar pull da nova imagem). Essa parte não é necessária para que seu aplicativo Web seja retirado do registro de contêiner, mas pode informar seu aplicativo Web quando uma nova imagem é enviada por push para o registro. Sem ele, você deve disparar manualmente um pull de imagem reiniciando o aplicativo Web.
  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.

    Para obter mais informações sobre essa variável de ambiente, confira o Leiame no repositório GitHub de exemplo.

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

    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 do Azure 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 de Registro de Contêiner do Azure. 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 usando a CI_CD_URL que você recebeu 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 seu 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 a mensagem após o ping do webhook: Starting container for site, porque o webhook dispara a reinicialização do aplicativo.

VII. Navegue até o aplicativo Web

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

No primeiro acesso, 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. Quando a imagem inicial for retirada, os testes subsequentes serão executados muito mais rapidamente.

A screenshot of the browser showing web app running successfully in Azure.

VIII. Acessar logs de diagnóstico

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 do navegador em https://<app-name>.scm.azurewebsites.net/api/logs/docker.

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

IX. 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. Altere 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 a mais recente:

    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 de imagem for concluído, o webhook notificará o Serviço de Aplicativo sobre o push e o Serviço de Aplicativo tentará obter a imagem atualizada. Aguarde alguns minutos e verifique se a atualização foi implantada navegando até https://<app-name>.azurewebsites.net.

X. Conectar-se ao contêiner usando SSH

O SSH permite a comunicação segura entre um contêiner e um cliente. Para habilitar a conexão SSH com o contêiner, a imagem personalizada precisa ser configurada para ele. Quando o contêiner estiver em execução, você poderá abrir uma conexão SSH.

Configurar o contêiner para SSH

O aplicativo de amostra usado neste tutorial já possui a configuração necessária no Dockerfile, que instala o servidor SSH e também define as credenciais de login. 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 está disponível apenas 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 para SSH. O SCM/KUDU usará suas credenciais do portal do Azure. Alterar esse valor causará um erro ao 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 conexão SSH no contêiner

  1. Navegue até https://<app-name>.scm.azurewebsites.net/webssh/host e entre com a sua conta do Azure. Substitua <app-name> pelo nome do seu 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 nele usando o comando top.

XI. Limpar os recursos

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

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
  • 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
  • Habilitar CI/CD do Registro de Contêiner do Azure para o Serviço de Aplicativo
  • Conectar-se ao contêiner usando SSH

No próximo tutorial, você aprenderá a proteger seu aplicativo com um domínio e um certificado personalizados.

Se preferir, confira outros recursos: