Crie um aplicativo Web Python em contêiner na nuvem

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

1. Crie um grupo de recursos, se necessário, com o comando az group create. Se você já configurou uma conta do Azure Cosmos DB para MongoDB na parte 2. Criar e testar 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 si. Você pode listar valores de local do Azure com o seguinte comando: az account list-locations -o table.

2. Crie um registo de contentores 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 devem ser exclusivos 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 registo totalmente qualificado (em minúsculas) e que deve incluir o nome do registo que especificou.

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 de registro totalmente qualificado. Se for bem-sucedido, você verá a mensagem "Início de sessão bem-sucedido".

   Observação

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

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: Create Registry.

   Como alternativa, na seção da extensão Docker REGISTROS, clique com o botão direito do rato na sua subscrição e selecione Criar Registro. Esta ação da interface do usuário inicia a mesma tarefa de criação do Registro.

2. Siga as instruções 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.

   • Localização: Se estiver a utilizar um grupo de recursos existente, selecione a localização a corresponder. Caso contrário, o local é onde o grupo de recursos é criado que contém o registro.

   

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

   Procura o par chave-valor loginServer na saída. O valor é o nome totalmente qualificado do registo.

   

Entre no portal Azure e siga estas etapas para criar um Registo de Contentores do Azure.

1. Procure por "registo de contentor" e selecione Registo de Contentor debaixo do Marketplace nos resultados.

2. Na aba Noções básicas do formulário Criar registo de contentor, 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.
   • Localização: Se estiver a utilizar um grupo de recursos existente, selecione a localização a corresponder. Caso contrário, a localização é onde é criado o grupo de recursos que contém o registo.
   • SKU: Selecione padrão .

   

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

3. Após a conclusão da implantação, vá para o novo registro e localize o nome de domínio totalmente qualificado.

   1. No menu de serviço , selecione Visão geral .
   2. Copie o valor do servidor de login . 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 no Azure Web Apps for Containers.

   1. No menu de serviço , selecione Chaves de Acesso.
   2. Selecione Ativado para o Utilizador Administrador.

   

   A conta de administrador do registo é necessária quando utiliza o portal do Azure para despachar uma imagem de contêiner, como 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.

Os comandos da CLI do Azure podem ser executados em uma estação de trabalho com a CLI do Azure instalada ou no Azure Cloud Shell. Ao executar no Cloud Shell, ignore 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 estiver a aceder ao registo a partir de uma subscrição diferente daquela em que o registo foi criado, utilize o parâmetro --suffix.

   Observação

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

2. Construa a imagem utilizando 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.

   • Se você deixar de fora a opção -t (igual a --image), o comando enfileirará uma compilação de contexto local sem enviá-la para o registro. Construir sem fazer o push pode ser útil para verificar se a imagem é criada.

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

   az acr repository list -n $REGISTRY_NAME
   

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

1. Na extensão do Docker, vá para REGISTOS e ligue-se ao Azure.

   

2. Selecione F1 ou CTRL+SHIFT+P para abrir a paleta de comandos, digite "registro" e selecione a tarefa Azure Container Registry: Build Image in Azure.

   Se não vires a tarefa, certifica-te de que Azure aparece em REGISTOS 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 as instruções e insira os seguintes valores para criar a imagem.

   • Tag image: Use o nome da imagem "msdocspythoncontainerwebapp:latest".
   • Registro: Selecione o registro que você criou acima ou um que você tem acesso.
   • Imagem do SO Base: Selecione Linux.

   

   Verifique a janela OUTPUT para obter progresso e informações sobre a compilação. Se receber um erro de credenciais, clique com o botão direito no registo na secção REGISTROS 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 REGISTOS, encontre a imagem de contentor criada.

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

   

Entre no portal do Azure para concluir estes passos.

1. Abra Azure Cloud Shell.

   

2. Construa 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 repo. Use https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git para o aplicativo de exemplo Django e https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git para o aplicativo de exemplo Flask.

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

   az acr repository list -n <registry-name>