Execute um Servidor Manualmente¶

Utilize o comando `fastapi run`¶

Em resumo, utilize o comando fastapi run para inicializar sua aplicação FastAPI:


fast →fastapi run main.py
   FastAPI   Starting production server 🚀

             Searching for package file structure from directories
             with __init__.py files
             Importing from /home/user/code/awesomeapp

    module   🐍 main.py

      code   Importing the FastAPI app object from the module with
             the following code:

             from main import app

       app   Using import string: main:app

    server   Server started at http://0.0.0.0:8000
    server   Documentation at http://0.0.0.0:8000/docs

             Logs:

      INFO   Started server process [2306215]
      INFO   Waiting for application startup.
      INFO   Application startup complete.
      INFO   Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C
             to quit)

restart ↻

Isto deve funcionar para a maioria dos casos. 😎

Você pode utilizar esse comando, por exemplo, para iniciar sua aplicação FastAPI em um contêiner, em um servidor, etc.

Servidores ASGI¶

Vamos nos aprofundar um pouco mais em detalhes.

FastAPI utiliza um padrão para construir frameworks e servidores web em Python chamado ASGI. FastAPI é um framework web ASGI.

A principal coisa que você precisa para executar uma aplicação FastAPI (ou qualquer outra aplicação ASGI) em uma máquina de servidor remoto é um programa de servidor ASGI como o Uvicorn, que é o que vem por padrão no comando fastapi.

Existem diversas alternativas, incluindo:

Uvicorn: um servidor ASGI de alta performance.
Hypercorn: um servidor ASGI compátivel com HTTP/2, Trio e outros recursos.
Daphne: servidor ASGI construído para Django Channels.
Granian: um servidor HTTP Rust para aplicações Python.
NGINX Unit: NGINX Unit é um runtime de aplicação web leve e versátil.

Máquina Servidora e Programa Servidor¶

Existe um pequeno detalhe sobre estes nomes para se manter em mente. 💡

A palavra "servidor" é comumente usada para se referir tanto ao computador remoto/nuvem (a máquina física ou virtual) quanto ao programa que está sendo executado nessa máquina (por exemplo, Uvicorn).

Apenas tenha em mente que quando você ler "servidor" em geral, isso pode se referir a uma dessas duas coisas.

Quando se refere à máquina remota, é comum chamá-la de servidor, mas também de máquina, VM (máquina virtual), nó. Todos esses termos se referem a algum tipo de máquina remota, normalmente executando Linux, onde você executa programas.

Instale o Programa Servidor¶

Quando você instala o FastAPI, ele vem com um servidor de produção, o Uvicorn, e você pode iniciá-lo com o comando fastapi run.

Mas você também pode instalar um servidor ASGI manualmente.

Certifique-se de criar um ambiente virtual, ativá-lo e, em seguida, você pode instalar a aplicação do servidor.

Por exemplo, para instalar o Uvicorn:


fast →pip install "uvicorn[standard]"

restart ↻

Um processo semelhante se aplicaria a qualquer outro programa de servidor ASGI.

Dica

Adicionando o standard, o Uvicorn instalará e usará algumas dependências extras recomendadas.

Isso inclui o uvloop, a substituição de alto desempenho para asyncio, que fornece um grande aumento de desempenho de concorrência.

Quando você instala o FastAPI com algo como pip install "fastapi[standard]", você já obtém uvicorn[standard] também.

Execute o Programa Servidor¶

Se você instalou um servidor ASGI manualmente, normalmente precisará passar uma string de importação em um formato especial para que ele importe sua aplicação FastAPI:


fast →uvicorn main:app --host 0.0.0.0 --port 80
INFO:     Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)

restart ↻

Nota

O comando uvicorn main:app refere-se a:

main: o arquivo main.py (o "módulo" Python).
app: o objeto criado dentro de main.py com a linha app = FastAPI().

É equivalente a:


from main import app

Cada programa de servidor ASGI alternativo teria um comando semelhante, você pode ler mais na documentação respectiva.

Aviso

Uvicorn e outros servidores suportam a opção --reload que é útil durante o desenvolvimento.

A opção --reload consome muito mais recursos, é mais instável, etc.

Ela ajuda muito durante o desenvolvimento, mas você não deve usá-la em produção.

Conceitos de Implantação¶

Esses exemplos executam o programa do servidor (por exemplo, Uvicorn), iniciando um único processo, ouvindo em todos os IPs (0.0.0.0) em uma porta predefinida (por exemplo, 80).

Esta é a ideia básica. Mas você provavelmente vai querer cuidar de algumas coisas adicionais, como:

Segurança - HTTPS
Executando na inicialização
Reinicializações
Replicação (o número de processos em execução)
Memória
Passos anteriores antes de começar

Vou te contar mais sobre cada um desses conceitos, como pensar sobre eles e alguns exemplos concretos com estratégias para lidar com eles nos próximos capítulos. 🚀