Criar um aplicativo Web Python em contêineres na nuvem

Este artigo faz parte de um tutorial sobre como colocar e implantar um aplicativo Web Python no Serviço de Aplicativo do Azure. O Serviço de Aplicativo permite que você execute aplicativos Web em contêineres e implante por meio de recursos de CI/CD (integração contínua/implantação contínua) com o Hub do Docker, o Registro de Contêiner do Azure e o Visual Studio Team Services. Nesta parte do tutorial, você aprenderá a criar o aplicativo Web Python em contêineres na nuvem.

Na parte opcional deste tutorial, uma imagem de contêiner foi criada e executada localmente. Por outro lado, nesta parte do tutorial, você cria (em contêineres) um aplicativo Web Python em uma imagem do Docker diretamente no Registro de Contêiner do Azure. A criação da imagem no Azure normalmente é mais rápida e fácil do que criar localmente e, em seguida, enviar a imagem por push para um registro. Além disso, a criação na nuvem não exige que o Docker esteja em execução em seu ambiente de desenvolvimento.

Depois que a imagem do Docker estiver no Registro de Contêiner do Azure, ela poderá ser implantada no serviço de Aplicativo do Azure.

Este diagrama de serviço realça os componentes abordados neste artigo.

Criar um Registro de Contêiner do Azure

Se você já tiver um Registro de Contêiner do Azure que pode usar, vá para a próxima etapa. Se você não fizer isso, crie um.

CLI do Azure

Os comandos da CLI do Azure podem ser executados no do Azure Cloud Shell ou em uma estação de trabalho com a CLI do Azure instalada. Ao executar no Cloud Shell, ignore a Etapa 3.

1. Se necessário, crie um grupo de recursos com o comando az group create. Se você já tiver configurado uma conta do Azure Cosmos DB para MongoDB em parte 2. Compile e teste o contêiner localmente deste tutorial, defina a variável de ambiente RESOURCE_GROUP_NAME como o nome do grupo de recursos usado para essa conta e passe para a próxima etapa.

   RESOURCE_GROUP_NAME='msdocs-web-app-rg'
   LOCATION='eastus'
   
   az group create -n $RESOURCE_GROUP_NAME -l $LOCATION
   

   LOCATION deve ser um valor de localização do Azure. Escolha um local perto de você. Você pode listar valores de localização do Azure com o seguinte comando: az account list-locations -o table.

2. Crie um registro de contêiner com o comando az acr create.

   REGISTRY_NAME='<your Azure Container Registry name>'
   
   az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Basic
   

   REGISTRY_NAME deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos.

   Na saída JSON do comando, procure o valor loginServer, que é o nome do registro totalmente qualificado (tudo em minúsculas) e deveria incluir o nome do registro especificado por você.

3. Se você estiver executando a CLI do Azure localmente, faça logon no Registro usando o comando az acr login.

   az acr login -n $REGISTRY_NAME
   

   O comando adiciona "azurecr.io" ao nome para criar o nome do Registro totalmente qualificado. Se for bem-sucedido, você verá a mensagem "Login bem-sucedido".

   Nota

   O comando az acr login não é necessário ou tem suporte no Cloud Shell.

VS Code

Essas etapas exigem a extensão Docker para VS Code.

1. Selecione F1 ou CTRL+SHIFT+P para abrir a paleta de comandos. Em seguida, digite "registry" e selecione a tarefa Azure Container Registry: Criar Registro.

   Como alternativa, na seção REGISTROS da extensão do Docker, clique com o botão direito do mouse em sua assinatura e selecione Criar Registro. Essa ação de interface do usuário inicia a mesma tarefa de criar registro.

2. Siga os prompts e insira os seguintes valores:

   • nome do Registro: o nome do registro deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos.

   • SKU: Selecione o padrão .

   • grupo de recursos: use um grupo existente ou crie um novo.

   • Local: Se você estiver usando um grupo de recursos existente, selecione o local que corresponda. Caso contrário, o local é onde é criado o grupo de recursos que contém o registro.

   

3. Na extensão do Docker, na seção REGISTRIES, localize o registro que você criou, clique com o botão direito do mouse e selecione Exibir Propriedades.

   Procure o par chave-valor loginServer na saída. O valor é o nome completo e qualificado do registro.

   

Portal do Azure

Entre no portal do Azure e siga estas etapas para criar um Registro de Contêiner do Azure.

1. Procure "registro de contêiner" e selecione Registro de Contêiner em Marketplace nos resultados.

2. Na guia Noções Básicas no formulário Criar registro de contêiner, insira os seguintes valores:

   • grupo de recursos: use um grupo existente ou crie um novo.
   • nome do Registro: o nome do registro deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos.
   • Local: Se você estiver usando um grupo de recursos existente, selecione o local correspondente. Caso contrário, o local é onde é criado o grupo de recursos que contém o registro.
   • SKU: Selecione Padrão.

   

   Quando terminar, selecione Examinar + criar. Após a conclusão da validação, selecione Criar.

3. Após concluir a implantação, acesse o novo registro e localize o nome totalmente qualificado.

   1. No menu de serviço , selecione Visão geral.
   2. Copie o valor do Servidor de logon. Deve ser um nome totalmente qualificado com "azurecr.io".

   

4. A conta de administrador é necessária para implantar uma imagem de contêiner de um registro nos Aplicativos Web do Azure para Contêineres.

   1. No menu de serviço ,, selecione Chaves de Acesso .
   2. Selecione Habilitado para o Usuário Administrador.

   

   O registro conta de administrador é necessário quando você usa o portal do Azure para implantar uma imagem de contêiner, conforme mostrado neste tutorial. A conta de administrador só é usada durante a criação do Serviço de Aplicativo. Depois que o Serviço de Aplicativo é criado, a identidade gerenciada é usada para extrair imagens do registro e a conta de administrador pode ser desabilitada.

Criar uma imagem no Registro de Contêiner do Azure

Você pode criar a imagem de contêiner diretamente no Azure de algumas maneiras. Primeiro, você pode usar o Azure Cloud Shell, que cria a imagem sem usar seu ambiente local. Você também pode criar a imagem de contêiner no Azure do seu ambiente local usando o VS Code ou a CLI do Azure. A criação da imagem na nuvem não exige que o Docker esteja em execução em seu ambiente local. Se precisar, siga as instruções em Clone ou baixe o aplicativo de exemplo na parte 2 deste tutorial para obter o aplicativo Web Flask ou Django de exemplo.

CLI do Azure

Os comandos da CLI do Azure podem ser executados em uma estação de trabalho com a CLI do Azure instalada ou em do Azure Cloud Shell. Ao executar no Cloud Shell, ignore a Etapa 1.

1. Se você estiver executando a CLI do Azure localmente, entre no registro se ainda não tiver feito isso com o comando az acr login.

   az acr login -n $REGISTRY_NAME
   

   Se você estiver acessando o registro de uma assinatura diferente daquela em que o registro foi criado, use a opção --suffix.

   Nota

   O comando az acr login não é necessário e não tem suporte no Cloud Shell.

2. Crie a imagem com o comando az acr build.

   az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest .
   

   Neste comando:

   • O ponto (".") no final do comando indica o local do código-fonte a ser compilado. Se você não estiver executando esse comando no diretório raiz do aplicativo de exemplo, especifique o caminho para o código.

     Em vez de um caminho para o código em seu ambiente, você pode, opcionalmente, especificar um caminho para o repositório GitHub de exemplo: https://github.com/Azure-Samples/msdocs-python-django-container-web-app ou https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.

   • Omitindo a opção -t (igual a --image), o comando enfileira uma construção de contexto local sem enviá-la para o repositório. Construir sem empurrar pode ser útil para verificar se a imagem é construída.

3. Confirme se a imagem de contêiner foi criada com o comando az acr repository list.

   az acr repository list -n $REGISTRY_NAME
   

VS Code

Essas etapas exigem a extensão do Docker para o VS Code. O VS Code precisa ser aberto na pasta de trabalho do seu aplicativo Web.

1. Na extensão do Docker, acesse REGISTRIES e conecte-se ao Azure.

   

2. Selecione F1 ou CTRL+SHIFT+P para abrir a paleta de comandos, digite "registro" e selecione a tarefa Registro de Contêiner do Azure: Criar Imagem no Azure.

   Se você não vir a tarefa, certifique-se de que Azure seja mostrado em REGISTRIES na extensão do Docker. Você também pode clicar com o botão direito do mouse no Dockerfile e selecionar Criar Imagem no Azure para executar a tarefa.

3. Siga os prompts e insira os valores a seguir para criar a imagem.

   • Marcar imagem: use o nome da imagem "msdocspythoncontainerwebapp:latest".
   • Registro: selecione o registro que você criou acima ou um ao qual você tem acesso.
   • Imagem do Sistema Operacional Base: selecione Linux.

   

   Verifique a janela OUTPUT para obter o progresso e informações sobre o build. Se você receber um erro de credenciais, clique com o botão direito do mouse no Registro na seção REGISTRIES da extensão do Docker e selecione Atualizar.

4. Confirme a imagem no Registro de Contêiner do Azure.

   1. Na extensão do Docker, na seção REGISTRIES, localize a imagem de contêiner que foi criada.

   2. Confirme o nome e a marca "mais recente".

   

Portal do Azure

Entre no portal do Azure para concluir essas etapas.

1. Abra o Azure Cloud Shell.

   

2. Crie a imagem com o comando az acr build.

   az acr build \
     -r <registry-name> \
     -g <resource-group> \
     -t msdocspythoncontainerwebapp:latest \
     <repo-path>
   

   O último argumento no comando é o caminho totalmente qualificado para o repositório. Use https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git para o aplicativo de exemplo do Django e https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git para o aplicativo de exemplo do Flask.

3. Confirme se uma imagem de contêiner foi criada com o comando az acr repository list.

   az acr repository list -n <registry-name>
   

Próxima etapa

Implantar aplicativo web