Fazer deploy de um app FastAPI

Ú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 FastAPI:

  • 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 
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

O comando de start padrão é:

uvicorn main:app --host 0.0.0.0

Se necessário, você pode especificar a porta, por exemplo:

uvicorn main:app --host 0.0.0.0 --port 80

Requisitos
Copiar link

  • Certifique-se de que o arquivo de inicialização da aplicação 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.

Na maioria dos casos, os problemas estão relacionados ao comando de start.

  • Certifique-se de que tudo funciona localmente com gunicorn.
  • Verifique se todos os módulos necessários estão listados no requirements.txt.