Faça deploy de FastAPI na Nodion

Faça deploy de FastAPI passo a passo

1. Instale o FastAPI com o Uvicorn A Nodion arranca o Uvicorn, mas não o instala. O fastapi[standard] inclui-o; com o fastapi simples, adicione o uvicorn manualmente. Fixe a versão de Python em .python-version, porque um intervalo escolhe a versão mais recente. requirements.txt

   fastapi[standard]

2. Mantenha a aplicação em main.py ou app.py A Nodion procura entre main.py e app.py um ficheiro que contenha FastAPI ou Starlette e executa uvicorn main:app ou uvicorn app:app em 0.0.0.0 e na porta PORT que define. Responda a / com um 200: é o caminho por omissão do health check. main.py

   from fastapi import FastAPI
   
   app = FastAPI()
   
   
   @app.get("/")
   def root():
       return {"status": "ok"}

3. Estrutura em pacote? Adicione uma linha web Se a sua aplicação estiver num pacote como app/main.py, a Nodion não encontra nenhum dos ficheiros esperados na raiz. Indique o módulo manualmente num Procfile; esta linha substitui o comando de arranque por omissão. Procfile

   web: uvicorn app.main:app --host 0.0.0.0 --port $PORT

4. Execute as migrações em cada deploy Com o Alembic, uma linha release: é executada uma vez por build, depois do build e antes de a nova versão arrancar. Se falhar, o deploy é interrompido e a versão em execução continua online. Procfile

   release: alembic upgrade head

5. Crie a aplicação e a base de dados Crie uma aplicação a partir do seu repositório na região EU Central, depois uma base de dados PostgreSQL na mesma região, e associe-a no separador Environment: chega como DATABASE_URL no deploy seguinte. Marque as chaves de API como secretas e depois faça push.

A ter em conta

• TrustedHostMiddlewareO health check da Nodion chama cada instância pelo seu endereço interno, que não está em allowed_hosts, por isso o middleware responde 400 e a release nunca entra em produção. Adicione depois dele uma função @app.middleware("http") que devolva 200 para /healthz (o Starlette executa primeiro o middleware adicionado em último lugar) e defina /healthz como caminho do health check nas definições da aplicação.
• Mais do que um workerPor omissão, é executado um único processo Uvicorn. Para ter mais, defina web: uvicorn main:app --host 0.0.0.0 --port $PORT --workers 2 num Procfile ou execute mais instâncias do processo web.
• DATABASE_URL e SQLAlchemyA DATABASE_URL da Nodion começa por postgres://, que o SQLAlchemy 1.4 e versões posteriores não aceitam. Substitua o esquema antes de a passar, por exemplo por postgresql+psycopg:// para psycopg 3, que funciona com motores síncronos e assíncronos.

O que a Nodion gere por si

• Deploys sem downtime Faça push para o seu branch e a Nodion cria uma nova release. O tráfego só muda quando as novas instâncias passam no health check; se uma release falhar, a que está em execução mantém-se. Em vez disso, as aplicações com um volume local são reiniciadas, porque o disco pertence a uma única instância.
• Bases de dados junto à aplicação PostgreSQL, pgvector, MySQL, Valkey e ClickHouse geridos, na mesma região. As bases de dados associadas chegam como DATABASE_URL, REDIS_URL ou CLICKHOUSE_URL.
• Pré-visualizações por pull request Ative as pré-visualizações e cada pull request do seu repositório passa a ter uma aplicação própria, com URL próprio e bases de dados novas e vazias, criada automática ou manualmente. Os forks e os pull requests de bots são ignorados.
• Workers, cron jobs e escalabilidade Execute workers como processos adicionais da mesma aplicação, agende tarefas no separador Cron e escale cada processo até 16 instâncias.
• Etapa de release Com buildpacks, uma linha release: do Procfile é executada a cada novo build. As aplicações com Dockerfile, bem como os redeploys ou rollbacks para uma imagem anterior, usam um comando de release definido na própria aplicação, que também tem prioridade sobre a linha do Procfile. Nos sites estáticos, a etapa de release é executada numa imagem que contém apenas os ficheiros gerados pelo build.
• Logs e métricas Logs de build, release e runtime, além de métricas de CPU, memória, disco e rede de cada instância, no dashboard.
• Domínios e HTTPS Um hostname atribuído por omissão com HTTPS desde o primeiro deploy; os seus próprios domínios recebem certificados automaticamente.

Para saber mais

• Ambientes de pré-visualização: uma aplicação por pull request Uma cópia em execução da sua aplicação para cada pull request: para que servem os ambientes de pré-visualização, onde se complicam e como a Nodion os gere.
• Alternativas ao Render na Europa: 5 opções comparadas Web service, background workers e Postgres na Europa: cinco alternativas ao Render comparadas pela forma como executam workers e gerem o Postgres.

FastAPI na Nodion: perguntas e respostas