Compartilhar via

Implantar um aplicativo Web Flask ou FastAPI nos Aplicativos de Contêiner do Azure

Este tutorial mostra como colocar em contêiner um aplicativo Web Python Flask ou FastAPI e implantá-lo nos Aplicativos de Contêiner do Azure. Os Aplicativos de Contêiner do Azure usam a tecnologia de contêiner do Docker para hospedar imagens internas e imagens personalizadas. Para obter mais informações sobre como usar contêineres no Azure, consulte Comparando as opções de contêiner do Azure.

Neste tutorial, você usará a CLI do Docker e a CLI do Azure para criar uma imagem do Docker e implantá-la nos Aplicativos de Contêiner do Azure. Você também pode implantar com o Visual Studio Code e a Extensão de Ferramentas do Azure.

Pré-requisitos

Para concluir este tutorial, você precisará:

Obter o código de exemplo

Em seu ambiente local, obtenha o código.

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

Adicionar arquivos Dockerfile e .dockerignore

Adicione um Dockerfile para instruir o Docker sobre como criar a imagem. O Dockerfile especifica o uso do Gunicorn, um servidor da Web em nível de produção que encaminha solicitações da Web para as estruturas Flask e FastAPI. Os comandos ENTRYPOINT e CMD instruem o Gunicorn a lidar com solicitações para o objeto do aplicativo.

# syntax=docker/dockerfile:1

FROM python:3.11

WORKDIR /code

COPY requirements.txt .

RUN pip3 install -r requirements.txt

COPY . .

EXPOSE 50505

ENTRYPOINT ["gunicorn", "app:app"]

50505 é usado para a porta do contêiner (interna) neste exemplo, mas você pode usar qualquer porta livre.

Verifique o arquivo requirements.txt para certificar-se de que ele contém gunicorn.

Flask==3.1.0
gunicorn

Configurar gunicorn

O Gunicorn pode ser configurado com um arquivo gunicorn.conf.py. Quando o arquivo gunicorn.conf.py está localizado no mesmo diretório em que gunicorn é executado, você não precisa especificar seu local na ENTRYPOINT instrução ou CMD no Dockerfile. Para obter mais informações sobre como especificar o arquivo de configuração, consulte Configurações do Gunicorn.

Neste tutorial, o arquivo de configuração sugerido configura o GUnicorn para aumentar seu número de trabalhos com base no número de núcleos de CPU disponíveis. Para obter mais informações sobre configurações de arquivo gunicorn.conf.py, consulte Configuração do Gunicorn.

# Gunicorn configuration file
import multiprocessing

max_requests = 1000
max_requests_jitter = 50

log_file = "-"

bind = "0.0.0.0:50505"

workers = (multiprocessing.cpu_count() * 2) + 1
threads = workers

timeout = 120

Adicione um arquivo .dockerignore para excluir arquivos desnecessários da imagem.

.git*
**/*.pyc
.venv/

Criar e executar a imagem localmente

Crie a imagem localmente.

docker build --tag flask-demo .

Execute a imagem localmente em um contêiner do Docker.

docker run --detach --publish 5000:50505 flask-demo

Abra a URL http://localhost:5000 no seu navegador para ver o aplicativo Web em execução localmente.

A opção --detach executa o contêiner em segundo plano. A opção --publish mapeia a porta do contêiner para uma porta no host. A porta do host (externa) é a primeira no par e a porta do contêiner (interna) é a segunda. Para obter mais informações, confira Referência sobre docker run.

Implantar um aplicativo Web no Azure

Para implantar a imagem do Docker nos Aplicativos de Contêiner do Azure, use o comando az containerapp up . (Os comandos a seguir são mostrados para o shell do Bash. Altere o caractere de continuação (\) conforme apropriado para outros shells.)

az containerapp up \
  --resource-group web-flask-aca-rg --name web-aca-app \
  --ingress external --target-port 50505 --source .

Quando a implantação for concluída, você terá um grupo de recursos com os seguintes recursos dentro dele:

  • Um Registro de Contêiner do Azure
  • Um ambiente de aplicações de contêiner
  • Um aplicativo em contêiner executando a imagem do aplicativo Web
  • Um workspace do Log Analytics

A URL do aplicativo implantado está na saída do az containerapp up comando. Abra a URL no navegador para ver o aplicativo Web em execução no Azure. A forma do URL será semelhante à seguinte https://web-aca-app.<generated-text>.<location-info>.azurecontainerapps.io, onde <generated-text> e <location-info> são exclusivos da sua implantação.

Faça atualizações e reimplante

Depois de fazer atualizações de código, você pode executar o comando anterior az containerapp up novamente, que recria a imagem e a reimplanta nos Aplicativos de Contêiner do Azure. Executar o comando novamente leva em conta que o grupo de recursos e o aplicativo já existem e atualiza apenas o aplicativo de contêiner.

Em cenários de atualização mais complexos, você pode reimplantar com os comandos az acr build e az containerapp update juntos para atualizar o aplicativo de contêiner.

Limpeza

Todos os recursos do Azure criados neste tutorial estão no mesmo grupo de recursos. Remover o grupo de recursos remove todos os recursos no grupo de recursos e é a maneira mais rápida de remover todos os recursos do Azure usados para seu aplicativo.

Para remover recursos, use o comando az group delete.

az group delete --name web-flask-aca-rg

Você também pode remover o grupo no portal do Azure ou no Visual Studio Code e na Extensão de Ferramentas do Azure.

Próximas etapas

Para obter mais informações, consulte os seguintes recursos: