Como criar e configurar um ambiente virtual Python com venv e deploy com Gunicorn no Ubuntu 22.04

Este manual aborda como criar e configurar um ambiente virtual Python utilizando venv e realizar o deploy de uma aplicação web com Gunicorn no Ubuntu 22.04.

Introdução

Ambientes virtuais são essenciais para isolar dependências de projetos Python. O Gunicorn é um servidor WSGI que permite executar aplicações Python de forma eficiente.

Passo a Passo

1. Atualizar o sistema

sudo apt update && sudo apt upgrade -y

2. Instalar Python e pip

sudo apt install python3 python3-pip -y

3. Criar um diretório para o projeto

mkdir ~/meu_projeto && cd ~/meu_projeto

4. Criar um ambiente virtual

python3 -m venv venv

5. Ativar o ambiente virtual

source venv/bin/activate

6. Instalar dependências do projeto

pip install flask gunicorn

7. Criar um arquivo de aplicação Flask

Crie um arquivo chamado app.py com o seguinte conteúdo:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello, World!'

if __name__ == '__main__':
    app.run()

8. Testar a aplicação localmente

python app.py

Acesse http://127.0.0.1:5000 no navegador para verificar se a aplicação está funcionando.

9. Executar a aplicação com Gunicorn

gunicorn -w 4 -b 0.0.0.0:8000 app:app

Isso inicia o Gunicorn com 4 workers na porta 8000.

Conclusão

Agora você tem um ambiente virtual Python configurado e uma aplicação Flask rodando com Gunicorn. Para produção, considere usar um servidor reverso como Nginx para gerenciar as solicitações.

Dica: Sempre mantenha seu ambiente virtual atualizado com as dependências do projeto para evitar problemas de compatibilidade.