Guia de início rápido: implantar um aplicativo Web Python (Django, Flask ou FastAPI) no Serviço de Aplicativo do Azure

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

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

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

1. Vá para a pasta do aplicativo:

   cd msdocs-python-flask-webapp-quickstart
   

2. Crie um ambiente virtual para o aplicativo:

   • Windows
   • macOS/Linux

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

3. Instale as dependências:

   pip install -r requirements.txt
   

4. Execute a aplicação:

   flask run
   

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

   

Tem problemas? Deixe-nos saber.

1. Vá para a pasta do aplicativo:

   cd msdocs-python-django-webapp-quickstart
   

2. Crie um ambiente virtual para o aplicativo:

   • Windows
   • macOS/Linux

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

3. Instale as dependências:

   pip install -r requirements.txt
   

4. Execute a aplicação:

   python manage.py runserver
   

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

   

Tem problemas? Deixe-nos saber.

1. Vá para a pasta do aplicativo:

   cd msdocs-python-fastapi-webapp-quickstart
   

2. Crie um ambiente virtual para o aplicativo:

   • Windows
   • macOS/Linux

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

3. Instale as dependências:

   pip install -r requirements.txt
   

4. Execute a aplicação:

   uvicorn main:app --reload
   

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

   

Tem problemas? Deixe-nos saber.

Os 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 única etapa.

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

az login

Crie o webapp e outros recursos e, em seguida, implante seu código no Azure usando az webapp up.

az webapp up --runtime PYTHON:3.9 --sku B1 --logs

• O --runtime parâmetro especifica qual versão do Python seu aplicativo está executando. Este exemplo usa Python 3.9. Para listar todos os tempos de execução disponíveis, use o comando az webapp list-runtimes --os linux --output table.
• O --sku parâmetro define o tamanho (CPU, memória) e o custo do plano de serviço do aplicativo. Este exemplo usa o plano de serviço B1 (Básico), que incorrerá em um pequeno custo em sua assinatura do Azure. Para obter uma lista completa dos planos do Serviço de Aplicativo, consulte a página de preços do Serviço de Aplicativo .
• O --logs sinalizador configura o log padrão necessário para habilitar a visualização do fluxo de log imediatamente após iniciar o webapp.
• 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> onde <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 az appservice list-locations comando.

O comando pode levar alguns minutos para ser concluído. Enquanto o comando está em execução, ele fornece mensagens sobre como criar o grupo de recursos, o plano do Serviço de Aplicativo e o recurso do aplicativo, configurar o registro em log e fazer a implantação do ZIP. Em seguida, ele fornece a mensagem "Você pode iniciar o aplicativo em http://< app-name.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>"
}

Para criar recursos do Azure no VS Code, você deve ter o pacote de extensão Ferramentas do Azure instalado e estar conectado ao Azure a partir do VS Code.

Na pasta do aplicativo, abra o VS Code:

code .

Instruções	Captura de ecrã
Localize o ícone do Azure na barra de ferramentas à esquerda. Selecione-o para exibir a extensão Ferramentas do Azure para VS Code. Se não vir o ícone Ferramentas do Azure, certifique-se de que tem a extensão Ferramentas do Azure para VS Code instalada.
Na extensão Ferramentas do Azure para VS Code: Encontre a secção RECURSOS e selecione a sua subscrição. Selecione + (Criar recurso...)
Escolha a opção Criar Aplicativo Web do Serviço de Aplicativo...
Digite o nome msdocs-python-webapp-quickstart-XYZ para este aplicativo Web, onde XYZ é qualquer três caracteres exclusivos. Quando implantado, esse nome é usado como o nome do aplicativo no formato https://<app-name>.azurewebsites.net.
Selecione a pilha de tempo de execução para o aplicativo. Neste exemplo, selecione Python 3.9.
Selecione o plano do Serviço de Aplicativo (nível de preço) para este aplicativo Web. O plano do Serviço de Aplicativo controla quantos recursos (CPU/memória) estão disponíveis para seu aplicativo e quanto você paga. Para este exemplo, selecione o nível de preço Básico (B1). Este plano incorrerá em uma pequena cobrança em relação à sua assinatura do Azure, mas é recomendado para um melhor desempenho na camada Gratuita (F1).
Selecione o botão Implantar na notificação "Novo aplicativo Web criado".
Selecione a pasta de início rápido em que você está trabalhando como a pasta a ser implantada.
Responda Sim para atualizar sua configuração de compilação e melhorar o desempenho da implantação.
Quando a implantação estiver concluída, uma notificação aparecerá no canto inferior direito do VS Code. Você pode usar essa notificação para navegar até seu aplicativo Web.

Entre no portal do Azure e siga estas etapas para criar seus recursos do Serviço de Aplicativo do Azure.

Instruções	Captura de ecrã
No portal do Azure: Insira os serviços de aplicativo na barra de pesquisa na parte superior do portal do Azure. Selecione o item rotulado Serviços de Aplicativo sob o título Serviços no menu que aparece abaixo da barra de pesquisa.
Na página Serviços de Aplicativo, selecione + Criar e, em seguida, selecione + Aplicativo Web no menu suspenso.
Na página Criar Aplicativo Web, preencha o formulário da seguinte maneira. Grupo de Recursos → Selecione Criar novo e use um nome de início rápido msdocs-python-webapp. Nomeie → msdocs-python-webapp-quickstart-XYZ onde XYZ é qualquer três caracteres aleatórios. Este nome tem de ser exclusivo em todo o Azure. Pilha de tempo de execução → Python 3.9. Região → qualquer região do Azure perto de si. Plano do Serviço de Aplicativo → Em Plano de preços, selecione Explorar planos de preços para selecionar um plano diferente do Serviço de Aplicativo.
O plano do Serviço de Aplicativo controla a quantidade de recursos (CPU/memória) disponíveis para seu aplicativo e o custo desses recursos. Neste exemplo, em Desenvolvimento/Teste, selecione o plano B1 Básico. O plano Basic B1 incorrerá em uma pequena cobrança contra sua conta do Azure, mas é recomendado para um melhor desempenho em relação ao plano F1 gratuito. Quando terminar, selecione Selecionar para aplicar as alterações.
Na página principal Criar Aplicativo Web, selecione Revisão + criação na parte inferior da tela. Isso o levará para a página Revisão. Selecione Criar para criar seu Serviço de Aplicativo.

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

Como a etapa anterior criou os recursos necessários e implantou seu aplicativo em uma única etapa, você pode passar para a próxima etapa.

Você pode implantar seu código de aplicativo de um repositório Git local no Azure configurando um remoto Git em seu repositório local que aponta para o repositório para o qual você deseja enviar código. A URL do repositório remoto e as credenciais do Git necessárias para a configuração podem ser recuperadas usando o portal do Azure ou a CLI do Azure.

• Portal do Azure
• CLI do Azure

Instruções	Captura de ecrã
Navegue até o Serviço de Aplicativo do seu aplicativo. Digite o nome do seu Serviço de Aplicativo na caixa de pesquisa na parte superior da tela. No título Recursos, selecione o Serviço de Aplicativo para navegar até ele.
Na página do Serviço de Aplicativo: Selecione Centro de Implantação no menu do lado esquerdo da tela. Selecione Git Local na lista suspensa chamada Source. Selecione Guardar.
Depois de salvar a página, ela será atualizada e exibirá o endereço do repositório Git remoto. Copie o valor do Uri de clone do Git, pois esse valor será usado para configurar um controle remoto do Git em uma etapa posterior.
Na página Centro de Implementação: Navegue até a guia Credenciais locais do Git/FTPS. Localize o nome de usuário e a senha do git local sob as credenciais do escopo do aplicativo. Mantenha essa tela aberta para que você possa copiar essas credenciais momentaneamente ao implantar seu código no repositório remoto. Certifique-se de copiar o nome de usuário git local, que começa com um $, por exemplo $msdocs-python-webapp-quickstart-123. Quando você envia código para o repositório Git remoto pela primeira vez, essas credenciais são necessárias para autenticar no repositório remoto.

Em seguida, no diretório raiz do seu aplicativo, configure um remoto Git que aponte para o Azure usando a URL do Git do remoto do Azure obtida em uma etapa anterior.

git remote add azure <git-deployment-url>

Agora você pode enviar código do seu repositório Git local para o Azure usando o controle remoto Git que você acabou de configurar. A ramificação de implantação padrão para o Serviço de Aplicativo é master, mas muitos repositórios Git estão se afastando master e usando maino . Você pode especificar o mapeamento do nome da ramificação local para o nome da ramificação remota no push (conforme mostrado abaixo) ou pode definir a configuração do aplicativo.DEPLOYMENT_BRANCH

git push azure main:master

Na primeira vez que você enviar código para o Azure, o Git solicitará as credenciais de implantação do Azure obtidas na etapa anterior. O Git armazenará essas credenciais em cache para que você não precise reinseri-las em implantações subsequentes.

Os aplicativos podem ser implantados no Azure criando e carregando um arquivo ZIP do código do aplicativo no Azure. Os arquivos ZIP podem ser carregados no Azure usando a CLI do Azure ou um cliente HTTP como o cURL.

Habilite a automação de compilação

Ao implantar um arquivo ZIP do seu código Python, você precisa definir um sinalizador para habilitar a automação de compilação do Azure. A automação de compilação instalará todos os requisitos necessários e empacotará o aplicativo para ser executado no Azure.

A automação de compilação no Azure é habilitada definindo a configuração do SCM_DO_BUILD_DURING_DEPLOYMENT aplicativo no portal do Azure ou na CLI do Azure.

• Portal do Azure
• CLI do Azure

Instruções	Captura de ecrã
Na página do aplicativo Web no portal do Azure: Selecione Configuração no cabeçalho Configurações na barra de ferramentas esquerda para exibir as configurações do aplicativo. Em Configurações do aplicativo, selecione Nova configuração do aplicativo.
Usando a caixa de diálogo, insira uma nova configuração com: Nome → SCM_DO_BUILD_DURING_DEPLOYMENT O valor → verdadeiro
Selecione Salvar para salvar suas configurações.

Crie um ficheiro ZIP da sua aplicação

Em seguida, crie um arquivo ZIP do seu aplicativo. Você só precisa incluir componentes do próprio aplicativo. Não é necessário incluir arquivos ou diretórios que comecem com um ponto (.), como .venv, .gitignore, .githubou .vscode.

zip -r <file-name>.zip . -x '.??*'

Carregue o arquivo ZIP no Azure

Depois de ter um arquivo ZIP, o arquivo pode ser carregado no Azure usando a CLI do Azure ou um cliente HTTP como cURL.

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deploy \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --src-path <zip-file-path>

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp deploy `
    --name $appServiceName `
    --resource-group $resourceGroupName `
    --src-path <zip-file-path>

curl -X POST \
    -H 'Content-Type: application/zip' \
    -u '<deployment-user>' \
    -T <zip-file-name> \
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

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

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

Para FastAPI, você deve configurar um comando de inicialização personalizado para que o Serviço de Aplicativo execute seu aplicativo. O comando a seguir inicia o Gunicorn com 2 processos de trabalho Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Primeiro, configure o comando startup usando o comando az webapp config set .

az webapp config set \
    --startup-file "gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app" \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Em seguida, reinicie o aplicativo Web usando o comando az webapp restart .

az webapp restart \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

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

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

Use a CLI do Azure ou o portal do Azure para configurar o comando de inicialização.

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

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

Para FastAPI, você deve configurar um comando de inicialização personalizado para que o Serviço de Aplicativo execute seu aplicativo. O comando a seguir inicia o Gunicorn com 2 processos de trabalho Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Instruções	Captura de ecrã
Primeiro, configure o comando de inicialização no Serviço de Aplicativo do Azure. Navegue até a página da instância do Serviço de Aplicativo no portal do Azure. Selecione Configuração sob o título Configurações no menu do lado esquerdo da página. Verifique se a guia Configurações gerais está selecionada. No campo Comando de inicialização, digite gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app. Selecione Guardar para guardar as alterações. Aguarde a notificação de que as configurações foram atualizadas antes de continuar.
Em seguida, reinicie o aplicativo Web. Selecione Visão geral no menu do lado esquerdo da página. No menu superior, selecione Reiniciar.

@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'))

def index(request):
    print('Request for index page received')
    return render(request, 'hello_azure/index.html')

@csrf_exempt
def hello(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        
        if name is None or name == '':
            print("Request for hello page received with no name or blank name -- redirecting")
            return redirect('index')
        else:
            print("Request for hello page received with name=%s" % name)
            context = {'name': name }
            return render(request, 'hello_azure/hello.html', context)
    else:

@app.get("/", response_class=HTMLResponse)
async def index(request: Request):
    print('Request for index page received')
    return templates.TemplateResponse('index.html', {"request": request})

@app.get('/favicon.ico')
async def favicon():
    file_name = 'favicon.ico'
    file_path = './static/' + file_name
    return FileResponse(path=file_path, headers={'mimetype': 'image/vnd.microsoft.icon'})

@app.post('/hello', response_class=HTMLResponse)
async def hello(request: Request, name: str = Form(...)):
    if name:
        print('Request for hello page received with name=%s' % name)
        return templates.TemplateResponse('hello.html', {"request": request, 'name':name})
    else:
        print('Request for hello page received with no name or blank name -- redirecting')
        return RedirectResponse(request.url_for("index"), status_code=status.HTTP_302_FOUND)

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

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

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

Atualize a página inicial no aplicativo ou tente outras solicitações para gerar algumas mensagens de log. A saída deve ser semelhante à 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"

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

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

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

Siga estas etapas enquanto estiver conectado ao portal do Azure para excluir um grupo de recursos.

Instruções	Captura de ecrã
Navegue até o grupo de recursos no portal do Azure. Insira o nome do grupo de recursos na barra de pesquisa na parte superior da página. No título Grupos de Recursos, selecione o nome do grupo de recursos para navegar até ele.
Selecione o botão Excluir grupo de recursos na parte superior da página.
Na caixa de diálogo de confirmação, digite o nome do grupo de recursos para confirmar a exclusão. Selecione Excluir para excluir o grupo de recursos.