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

   

Está enfrentando problemas? Fale conosco.

1. Acesse 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. Instalar as dependências:

   pip install -r requirements.txt
   

4. Executar o aplicativo:

   python manage.py runserver
   

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

   

Está enfrentando problemas? Fale conosco.

1. Acesse 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. Instalar as dependências:

   pip install -r requirements.txt
   

4. Executar o aplicativo:

   uvicorn main:app --reload
   

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

   

Está enfrentando problemas? Fale conosco.

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

Para criar recursos do Azure no VS Code, você deve ter o pacote de extensão de ferramentas do Azure instalado e conectado ao Azure por meio do VS Code.

Na pasta do aplicativo, abra o VS Code:

code .

Instruções	Captura de tela
Localize o ícone do Azure na barra de ferramentas do lado esquerdo. Selecione-o para abrir a extensão de Ferramentas do Azure para VS Code. Se você não encontrar o ícone de Ferramentas do Azure, verifique se tem a extensão de Ferramentas do Azure para VS Code instalada.
Na extensão de Ferramentas do Azure para VS Code: Localize a seção RECURSOS e selecione sua assinatura. Selecione + (Criar Recurso...)
Escolha a opção Criar Aplicativo Web do Serviço de Aplicativo....
Insira o nome msdocs-Python-webapp-QuickStart-XYZ para este aplicativo Web, em que XYZ é qualquer conjunto de três caracteres exclusivos. Quando implantado, esse nome será usado como o nome do aplicativo no formulário https://<app-name>.azurewebsites.net.
Selecione a pilha de runtime para o aplicativo. Nesse exemplo, selecione Python 3.9.
Selecione o plano do Serviço de Aplicativo (tipo 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 o quanto você paga. Para este exemplo, selecione o tipo de preço Básico (B1). Esse plano gerará uma pequena cobrança na sua assinatura do Azure, mas é recomendado para melhor desempenho com relação ao nível F1 (Gratuito).
Selecione o botão Implantar na notificação "Criar aplicativo Web".
Selecione a pasta de início rápido na qual você está trabalhando como aquela na qual deve ser feita a implantação.
Responda Sim para atualizar sua configuração de build e melhorar o desempenho da implantação.
Quando a implantação estiver concluída, uma notificação será exibida 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 tela
No portal do Azure: Insira serviços de aplicativos na caixa de pesquisa na parte superior do portal do Azure. Selecione o item chamado Serviços de Aplicativos no cabeçalho Serviços do menu que aparece abaixo da barra de pesquisa.
Na página Serviços de Aplicativos, selecione + Criar e, em seguida, selecione + Aplicativo Web no menu suspenso.
Na página Criar aplicativo Web, preencha o formulário como demonstrado a seguir. Grupo de recursos → selecione criar novo e use um nome de msdocs-Python-webapp-QuickStart. Nome → msdocs-Python-webapp-QuickStart-XYZ, em que XYZ tem três caracteres aleatórios. Esse nome deve ser exclusivo no Azure. Pilha do runtime → Python 3.9. Região → qualquer região do Azure próxima a você. Plano do Serviço de Aplicativo → em Plano de preços, selecione Explorar planos de preços para selecionar um plano do Serviço de Aplicativo diferente.
O Plano do Serviço de Aplicativo controla a quantidade de recursos (CPU/memória) disponíveis para o aplicativo e o custo associado a eles. Para este exemplo, em Desenvolvimento/Teste, selecione o plano B1 Básico. O plano Básico B1 incorrerá em uma pequena cobrança em sua conta do Azure, mas é recomendado para melhor desempenho em relação ao plano Gratuito F1. Quando terminar, selecione Selecionar para aplicar as alterações.
Na página principal Criar Aplicativo Web, selecione *Examinar + criar na parte inferior da tela. Isso levará você até a página Examinar. Selecione Criar para criar o Serviço de Aplicativo.

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.

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

Você pode implantar o código do aplicativo de um repositório Git local no Azure configurando um repositório Git remoto em seu repositório local que aponta para o repositório que você deseja enviar código por push. 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 tela
Navegue até o Serviço de Aplicativo para seu aplicativo. Insira o nome do 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 no lado esquerdo da tela. Selecione Git Local na lista suspensa rotulada como Origem. Selecione Salvar.
Depois de salvar a página, ela será atualizada e exibirá o endereço do repositório Git remoto. Copie o valor do URI do Git Clone, pois esse valor será usado para configurar um repositório Git remoto em uma etapa posterior.
Na página Centro de Implantação: Navegue até a guia Credenciais do FTPS/Git local. Localize o nome de usuário do Git local e a senha nas 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. Copie o nome de usuário local do Git, que começa com um $, por exemplo $msdocs-python-webapp-quickstart-123. Ao efetuar push do código para o repositório Git remoto pela primeira vez, essas credenciais são necessárias para se autenticar no repositório remoto.

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

git remote add azure <git-deployment-url>

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

git push azure main:master

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

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

Habilitar automação de build

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

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

• Portal do Azure
• CLI do Azure

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

Criar um arquivo zip do seu aplicativo

A seguir, crie um arquivo zip do seu aplicativo. Você só precisa incluir componentes do próprio aplicativo. Você não precisa incluir arquivos nem diretórios que comecem com um ponto (.), como, .venv, .gitignore, .github ou .vscode.

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

Carregar o arquivo zip para o Azure

Assim que você tiver um arquivo ZIP, ele poderá 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 detecta 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 detecta automaticamente a presença de um aplicativo Django. Nenhuma configuração adicional é necessária para este início rápido.

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

Primeiro, configure o comando de inicialização 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 detecta 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 detecta 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 detecta 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 detecta automaticamente a presença de um aplicativo Django. Nenhuma configuração adicional é necessária para este início rápido.

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

Instruções	Captura de tela
Primeiro, configure o comando de inicialização no Serviço de Aplicativo do Azure. Acesse a página da instância do Serviço de Aplicativo no portal do Azure. Selecione Configuração no título Configurações no menu no lado esquerdo da página. Verifique se a guia Configurações gerais está selecionada. No campo Comando de Inicialização, insira gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app. Selecione Salvar para salvar as alterações. Aguarde a notificação de que as configurações são atualizadas antes de prosseguir.
Em seguida, reinicie o aplicativo Web. Selecione Visão geral no menu no 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 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"

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.

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

Instruções	Captura de tela
Procure 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.