Compartilhar via

Início Rápido: Implantar um aplicativo Web Python (Django, Flask ou FastAPI) no Serviço de Aplicativo do Azure

  • Artigo

Observação

A partir de 1º de junho de 2024, todos os aplicativos recém-criados do Serviço de Aplicativo terão a opção de gerar um nome do host padrão exclusivo usando a convenção de nomenclatura <app-name>-<random-hash>.<region>.azurewebsites.net. Os nomes de aplicativos existentes permanecerão inalterados.

Exemplo: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Para obter mais detalhes, consulte Nome do Host Padrão Exclusivo para o Recurso Serviço de Aplicativo.

Neste guia de início rápido, você implantará um aplicativo Web Python (Django, Flask ou FastAPI) no Serviço de Aplicativo do Azure. O Serviço de Aplicativo do Azure é um serviço de hospedagem na Web totalmente gerenciado que dá suporte a aplicativos Python hospedados em um ambiente de servidor Linux.

Para concluir este início rápido, você precisa de:

Observação

Este artigo contém instruções atuais de como implantar um aplicativo Web Python usando o Serviço de Aplicativo do Azure. Não há mais suporte para Python no Windows.

Aplicativo de exemplo

Este início rápido pode ser concluído usando Flask, Django ou FastAPI. Um aplicativo de exemplo em cada estrutura é fornecido para ajudá-lo a acompanhar este guia de início rápido. Baixe ou clone o aplicativo de exemplo em sua estação de trabalho local.

git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

Para executar o aplicativo localmente:

  1. Acesse a pasta do aplicativo:

    cd msdocs-python-flask-webapp-quickstart

  2. Crie um ambiente virtual para o aplicativo:

    py -m venv .venv
.venv\scripts\activate

  3. Instalar as dependências:

    pip install -r requirements.txt

  4. Executar o aplicativo:

    flask run

  5. Navegue até o aplicativo de exemplo em http://localhost:5000 um navegador da Web.

    Captura de tela do aplicativo Flask em execução localmente em um navegador

Está enfrentando problemas? Fale conosco.

Criar um aplicativo Web no Azure

Para hospedar seu aplicativo no Azure, você precisa criar um aplicativo Web do Serviço de Aplicativo no Azure. Você pode criar um aplicativo Web usando a CLI do Azure, o VS Code, o pacote de extensão de Ferramentas do Azure ou o portal do Azure.

Comandos da CLI do Azure podem ser executados em um computador com a CLI do Azure instalada.

A CLI do Azure tem um comando az webapp up que criará os recursos necessários e implantará seu aplicativo em uma só etapa.

Se necessário, faça logon no Azure usando az login.

az login

Crie o aplicativo Web e outros recursos e implante seu código no Azure usando az webapp up.

az webapp up --runtime PYTHON:3.9 --sku B1 --logs
  • O parâmetro --runtime especifica a versão do Python que o aplicativo está executando. Este exemplo usa Python 3.9. Para listar todos os runtimes disponíveis, use o comando az webapp list-runtimes --os linux --output table.
  • O parâmetro --sku define o tamanho (CPU, memória) e o custo do plano do Serviço de Aplicativo. Este exemplo usa o plano de serviço B1 (Básico), que gerará um pequeno custo em sua assinatura do Azure. Para obter uma lista completa dos planos do Serviço de Aplicativo, exiba a página de Preço do Serviço de Aplicativo.
  • O sinalizador --logs configura o log padrão necessário para habilitar a exibição do fluxo de log imediatamente após a inicialização do aplicativo Web.
  • Opcionalmente, você pode especificar um nome com o argumento --name <app-name>. Se você não fornecer um, um nome será gerado automaticamente.
  • Opcionalmente, você pode incluir o argumento --location <location-name>, em que <location_name> é uma região do Azure disponível. Você pode recuperar uma lista de regiões permitidas para sua conta do Azure executando o comando az appservice list-locations.

O comando pode demorar um pouco para ser concluído. Durante a execução do comando, ele envia mensagens sobre como criar o grupo de recursos, o plano do Serviço de Aplicativo, o recurso de aplicativo, como configurar o log e como fazer a implantação de zip. Em seguida, ele fornece a mensagem "Você pode iniciar o aplicativo em http://<nome-do-aplicativo>.azurewebsites.net", que é a URL do aplicativo no Azure.

The webapp '<app-name>' doesn't exist
Creating Resource group '<group-name>' ...
Resource group creation complete
Creating AppServicePlan '<app-service-plan-name>' ...
Creating webapp '<app-name>' ...
Configuring default logging for the app, if not already enabled
Creating zip with contents of dir /home/cephas/myExpressApp ...
Getting scm site credentials for zip deployment
Starting zip deployment. This operation can take a while to complete ...
Deployment endpoint responded with status code 202
You can launch the app at http://<app-name>.azurewebsites.net
{
  "URL": "http://<app-name>.azurewebsites.net",
  "appserviceplan": "<app-service-plan-name>",
  "location": "centralus",
  "name": "<app-name>",
  "os": "<os-type>",
  "resourcegroup": "<group-name>",
  "runtime_version": "python|3.9",
  "runtime_version_detected": "0.0",
  "sku": "FREE",
  "src_path": "<your-folder-location>"
}

Observação

O comando az webapp up realiza as seguintes ações:

Está enfrentando problemas? Fale conosco.

Implantar código de aplicativo no Azure

O Serviço de Aplicativo do Azure dá suporte a vários métodos para implantar o código do aplicativo no Azure, como GitHub Actions e todas as principais ferramentas de CI/CD. Este artigo se concentra em como implantar o código de sua estação de trabalho local no Azure.

Como o comando az webapp up criou os recursos necessários e implantou o aplicativo em uma única etapa, você pode progredir para a próxima etapa.

Está enfrentando problemas? Primeiro confira o guia de solução de problemas. Se isso não ajudar, fale conosco.

Configurar o script de inicialização

Com base na presença de determinados arquivos em uma implantação, o Serviço de Aplicativo detecta automaticamente se um aplicativo é um aplicativo Django ou Flask e executa etapas padrão para executar seu aplicativo. Para aplicativos baseados em outras estruturas da Web, como o FastAPI, você precisa configurar um script de inicialização para o Serviço de Aplicativo executar seu aplicativo. Caso contrário, o Serviço de Aplicativo executará um aplicativo somente leitura padrão localizado na pasta opt/defaultsite.

Para saber mais sobre como o Serviço de Aplicativo executa aplicativos Python e como você pode configurar e personalizar o comportamento com seu aplicativo, consulte Configurar um aplicativo Python Linux para o Serviço de Aplicativo do Azure.

O Serviço de Aplicativo detecta automaticamente a presença de um aplicativo Flask. Nenhuma configuração adicional é necessária para este início rápido.

Navegar até o aplicativo

Navegue até o aplicativo implantado no navegador usando a URL http://<app-name>.azurewebsites.net. Se você vir uma página de aplicativo padrão, aguarde um minuto e atualize o navegador.

O código de exemplo Python está executando um contêiner Linux no Serviço de Aplicativo usando uma imagem interna.

Captura de tela do aplicativo em execução no Azure

Parabéns! Você implantou seu aplicativo Python no Serviço de Aplicativo.

Está enfrentando problemas? Primeiro confira o guia de solução de problemas. Se isso não ajudar, fale conosco.

Transmitir logs

O Serviço de Aplicativo do Azure captura todas as mensagens geradas no console para ajudar você a diagnosticar problemas com seu aplicativo. Os aplicativos de exemplo incluem instruções print() para demonstrar essa funcionalidade.

@app.route('/')
def index():
   print('Request for index page received')
   return render_template('index.html')

@app.route('/favicon.ico')
def favicon():
    return send_from_directory(os.path.join(app.root_path, 'static'),
                               'favicon.ico', mimetype='image/vnd.microsoft.icon')

@app.route('/hello', methods=['POST'])
def hello():
   name = request.form.get('name')

   if name:
       print('Request for hello page received with name=%s' % name)
       return render_template('hello.html', name = name)
   else:
       print('Request for hello page received with no name or blank name -- redirecting')
       return redirect(url_for('index'))

Você pode revisar o conteúdo dos logs de diagnóstico do Serviço de Aplicativo usando a CLI do Azure, o VS Code ou o portal do Azure.

Primeiro, você precisa configurar o Serviço de Aplicativo do Azure para gerar logs para o sistema de arquivos do Serviço de Aplicativo usando o comando az webapp log config.

az webapp log config \
    --web-server-logging filesystem \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Para transmitir logs, use o comando az webapp log tail.

az webapp log tail \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Atualize a home page no aplicativo ou tente outras solicitações para gerar algumas mensagens de log. A saída deve ser semelhante ao seguinte.

Starting Live Log Stream ---

2021-12-23T02:15:52.740703322Z Request for index page received
2021-12-23T02:15:52.740740222Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET / HTTP/1.1" 200 1360 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.841043070Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.884541951Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:53.043211176Z 169.254.130.1 - - [23/Dec/2021:02:15:53 +0000] "GET /favicon.ico HTTP/1.1" 404 232 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

2021-12-23T02:16:01.304306845Z Request for hello page received with name=David
2021-12-23T02:16:01.304335945Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "POST /hello HTTP/1.1" 200 695 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.398399251Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.430740060Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

Está enfrentando problemas? Primeiro confira o guia de solução de problemas. Se isso não ajudar, fale conosco.

Limpar os recursos

Ao terminar o aplicativo de exemplo, você poderá remover todos os recursos do aplicativo do Azure. A remoção do grupo de recursos garante que você não incorra em encargos extras e ajuda a manter sua assinatura do Azure organizada. Remover o grupo de recursos também remove todos os recursos do grupo de recursos e é a maneira mais rápida de remover todos os recursos do Azure para seu aplicativo.

Exclua o grupo de recursos usando o comando az group delete.

az group delete \
    --name msdocs-python-webapp-quickstart \
    --no-wait

O argumento --no-wait permite que o comando seja retornado antes que a operação seja concluída.

Está enfrentando problemas? Fale conosco.

Próximas etapas

Tutorial: aplicativo Web Python (Django ou Flask) com PostgreSQL

Configurar um aplicativo Python

Adicionar entrada do usuário a um aplicativo Web Python

Tutorial: execute um aplicativo Python em um contêiner personalizado

 Tutorial: proteja um aplicativo com domínio e certificado personalizados