Fazer deploy de um app Flask

Última atualização em 30 de maio de 2025

Você pode encontrar o guia passo a passo para fazer deploy aqui.

Build da aplicação
Copiar link

A Hostman utiliza o seguinte ambiente ao fazer o build de um app Flask:

  • Python: 3.10, 3.11, 3.12, 3.13 ou 3.14
  • pip
  • gunicorn
  • Bibliotecas do sistema para trabalhar com PostgreSQL e MySQL

A Hostman executa os seguintes comandos durante o build:

apt-get install -y python3 python3-pip gunicorn python3-psycopg2 libpq-dev python-dev default-mysql-client python3-dev default-libmysqlclient-dev python3-mysqldb --fix-missing
pip3 install psycopg2 flask
ln /usr/bin/python3 /usr/bin/python -sf
ln /usr/bin/pip3 /usr/bin/pip -sf

Para instalar dependências, adicione a seguinte linha ao comando de build:

pip3 install --upgrade -r requirements.txt

Rodando a aplicação
Copiar link

Para que o app seja implantado corretamente, pode ser necessário ajustar o comando de start de acordo com o seu projeto, por exemplo, especificando o bind da porta:

gunicorn main:app --timeout 60 --bind 0.0.0.0:80

Requisitos
Copiar link

  • Certifique-se de que o arquivo de inicialização da aplicação (ponto de entrada do app) se chama main.py.
  • Certifique-se de que a aplicação está escutando em 0.0.0.0 e não em 127.0.0.1; caso contrário, conexões externas não funcionarão.

Troubleshooting
Copiar link

Deploy falhou
Copiar link

Se houver problemas no deploy, primeiro confira o log de deploy. Ele ajuda a identificar em qual etapa ocorreu o erro.

A maioria dos erros geralmente está relacionada a:

  • ausência do arquivo main.py ou da variável app;
  • comando de start incorreto;
  • dependências ausentes no arquivo requirements.txt.

Certifique-se de que o comando gunicorn main:app roda corretamente no seu ambiente local.