A resposta curta
Para fazer deploy de Django em produção, manage.py runserver não é o servidor. Rode um servidor WSGI ou ASGI em 0.0.0.0 e na porta que a plataforma entrega, com DEBUG = False, uma SECRET_KEY estável e ALLOWED_HOSTS no hostname real. Colete os estáticos, deixe os uploads dos usuários em armazenamento durável e rode as migrações uma vez, como passo de release.
Se a busca é hospedagem Django, na Unbroker esse caminho é um serviço com Dockerfile e exige Pro. A página do produto é Deploy de Django. Os passos estão em Deploy a Django application.
runserver não é o servidor de produção
runserver sobe um servidor de desenvolvimento leve. Por padrão ele escuta a porta 8000 em 127.0.0.1. O Django avisa que esse é um servidor de desenvolvimento e que produção precisa de um servidor WSGI ou ASGI. O checklist de deploy diz o mesmo: saia do manage.py runserver. A referência do comando é runserver.
O servidor de desenvolvimento recarrega o código Python enquanto você edita, e serve estáticos quando django.contrib.staticfiles está ativo. Isso é conveniência de desenvolvimento. Não é um processo de produção.
Desenvolvimento (runserver) | Servidor de produção | |
|---|---|---|
| Processo | O servidor de desenvolvimento do Django. Não é para produção. | Um servidor WSGI como o Gunicorn, ou um servidor ASGI como o Uvicorn. |
| Endereço | 127.0.0.1:8000, a menos que você passe outro. Outras máquinas não alcançam esse padrão. | 0.0.0.0 e a PORT recebida. O exemplo da Unbroker cai para 8000 só quando PORT está vazia. |
| Estáticos | O runserver serve quando staticfiles está ativo. | collectstatic, e depois WhiteNoise ou outro host. O Gunicorn sozinho não serve. |
| Settings | DEBUG costuma estar ligado. | DEBUG = False, uma SECRET_KEY secreta e ALLOWED_HOSTS com o hostname real. |
| Migrações | Muitas vezes aplicadas à mão numa máquina. | Uma vez, como passo de release, não quando cada cópia da app sobe. |
WSGI ou ASGI
A plataforma principal de deploy do Django é WSGI. O startproject cria wsgi.py com um callable application, e o runserver usa essa app WSGI. Ele não usa asgi.py. O panorama está em How to deploy with WSGI.
O Gunicorn é o servidor WSGI que o guia da Unbroker usa. O comando inicial da documentação do Django é gunicorn myproject.wsgi. Ele sobe um processo e uma thread em 127.0.0.1:8000. A referência é How to use Django with Gunicorn.
Use ASGI quando o projeto é publicado por asgi.py. O comando de Uvicorn na doc do Django é python -m uvicorn myproject.asgi:application, e nessa forma simples também escuta em 127.0.0.1:8000. Para produção, o Django documenta rodar o Uvicorn sob o Gunicorn com -k uvicorn_worker.UvicornWorker. A referência é How to use Django with Uvicorn e How to deploy with ASGI.
O guia da Unbroker assume uma aplicação WSGI e mostra o Gunicorn. Se você mudar para o comando ASGI, mantenha o mesmo bind: todas as interfaces, e a porta que você recebe.
Settings que precisam mudar
Siga o checklist de deploy do Django e rode python manage.py check --deploy com os settings de produção. O guia da Unbroker pede a mesma checagem.
Defina DEBUG = False. O Django diz que o debug nunca deve ficar ligado em produção. Com debug ativo, as páginas de erro podem expor código, variáveis locais e settings.
Leia SECRET_KEY do ambiente. O checklist mostra os.environ["SECRET_KEY"] como um caminho. Mantenha o mesmo valor entre deploys. O guia da Unbroker diz que um segredo diferente a cada subida invalida dados assinados e sessões. Não faça commit dele. Como as variáveis se dividem está em Variáveis de ambiente e segredos.
Coloque em ALLOWED_HOSTS o hostname em que o serviço realmente responde. Com DEBUG em False, o Django não funciona sem um valor adequado. Um request cujo host não está permitido gera DisallowedHost. Essa exceção é uma SuspiciousOperation. Se nada mais a trata, o Django responde com a view de bad request: uma mensagem “Bad Request”, status 400, e só quando DEBUG é False. A lista de exceções está em SuspiciousOperation. O guia diz que um erro DisallowedHost aponta para a configuração de host. Não resolva liberando todos os hosts.
Inclua as origens HTTPS finais em CSRF_TRUSTED_ORIGINS onde a app precisar delas. O padrão é uma lista vazia. Uma entrada é uma origem, como https://example.com, não um hostname sem o esquema. O setting é CSRF_TRUSTED_ORIGINS. Uma falha de CSRF pede revisão da origem e do cookie. Não desligue a proteção CSRF.
Quando o site já está em HTTPS, o checklist também pede CSRF_COOKIE_SECURE e SESSION_COOKIE_SECURE em True, para esses cookies não seguirem em HTTP puro.
SECURE_PROXY_SSL_HEADER importa quando o TLS termina num proxy e, sem isso, o Django veria o request como HTTP. O padrão é None. O Django diz para definir o valor só se você controla esse proxy, o proxy remove o header dos requests que entram, e o proxy define o header para os requests que chegaram por HTTPS. O guia de Django da Unbroker não cita um header para confiar. Não copie um valor de exemplo até saber que o proxy na frente da app cumpre essas condições. Um loop de redirects depois de ligar SECURE_SSL_REDIRECT é o sintoma que o Django documenta para esse caso. O setting é SECURE_PROXY_SSL_HEADER.
Um domínio próprio é um passo posterior, e exige Pro. Quando estiver pronto, inclua esse hostname em ALLOWED_HOSTS e a origem HTTPS em CSRF_TRUSTED_ORIGINS. O DNS e o certificado estão em Domínio personalizado e HTTPS.
Arquivos estáticos e mídia
Em produção você define STATIC_ROOT. O collectstatic copia os estáticos para lá. O servidor de desenvolvimento não faz esse trabalho. A entrada do checklist é STATIC_ROOT e STATIC_URL, e a página de deploy é How to deploy static files.
O Gunicorn não serve os arquivos coletados. Escolha uma estratégia. O WhiteNoise, no MIDDLEWARE logo depois do SecurityMiddleware do Django, serve esses arquivos a partir do processo do Django. Rode collectstatic na etapa que a estratégia pedir. Se o comando roda enquanto a imagem é construída, use settings seguros para o build. Os passos do WhiteNoise estão em Using WhiteNoise with Django. Um host externo de estáticos é a outra opção que o guia da Unbroker cita.
Uploads de usuários são outro diretório. MEDIA_ROOT guarda arquivos de usuários, e o Django os trata como não confiáveis. O helper que serve MEDIA_ROOT em desenvolvimento não é um servidor de arquivos de produção, e a doc só o mostra quando DEBUG está ligado. Na Unbroker, essa mídia vai para armazenamento persistente ou object storage, separada dos estáticos coletados.
Um volume persistente é um caminho absoluto num serviço. Arquivos escritos só no filesystem do contêiner devem ser tratados como temporários, porque um deploy, um restart ou um reagendamento pode trocar esse contêiner. Um serviço com volume roda uma réplica. O volume pode crescer, até 50 GB, e não pode encolher. Apagar o serviço apaga o volume. Volumes exigem Pro. Esse limite está em volumes persistentes e em Persistent storage and backups.
Se mais de uma réplica precisa ver o mesmo upload, use object storage. O volume não é um disco compartilhado entre várias réplicas.
Banco de dados e migrações
Configure o setting DATABASES do Django para o PostgreSQL que você escolheu. O Django não interpreta DATABASE_URL sozinho. Use a configuração que você já tem, ou um parser que você instalou de propósito. Engine, nome, usuário, senha, host e porta são os campos de conexão que o Django documenta para PostgreSQL.
Na Unbroker há dois caminhos de PostgreSQL. Um nó de Apps é um serviço de banco privado dentro do projeto. Um cluster gerenciado é um host de banco operado à parte. O schema e as migrações continuam seus. Guarde as credenciais nas variáveis de runtime do serviço. Revelar uma connection string pode imprimir um segredo, então essa saída não vai para o repositório, para o chat nem para a página de erro. Os passos de conexão estão em Connect your application to PostgreSQL. Operar o banco está em Postgres em produção. Bancos gerenciados exigem Pro.
Rode as migrações uma vez, como passo de release controlado, com as credenciais de runtime. Não as coloque no build da imagem. Não as rode a partir de cada processo web, porque esses processos podem competir. Teste numa cópia descartável antes de produção. Na Unbroker o passo de release é o comando pre-deploy, e comandos de migração exigem Pro. O que um rollback de código não desfaz está em Migrações de banco de dados no deploy.
Tarefas em segundo plano
E-mail, indexação e o resto do trabalho de fila não ficam no processo web. Coloque o consumidor num serviço worker próprio, com o comando de início dele e os logs dele. Um worker não tem HTTP de entrada nem URL pública. Workers exigem Pro e rodam uma réplica.
Celery e RQ são exemplos desse consumidor. O guia de workers não cita nenhuma das duas bibliotecas. Ele diz que o comando de início deve lançar o consumidor e permanecer no ar enquanto espera jobs. Um script que processa um item e sai é um job agendado ou um comando avulso, não um worker. Jobs agendados exigem Pro. O corte está em Workers em segundo plano e cron, e os passos em Deploy a background worker.
Como funciona na Unbroker
Crie um serviço de repositório com Dockerfile no Cloud. Inclua o Gunicorn e o driver do banco nos requirements travados. O comando do guia, para um projeto cujo módulo WSGI é config.wsgi, é:
gunicorn config.wsgi:application --bind 0.0.0.0:${PORT:-8000} --workers 1 --access-logfile - --error-logfile -
Troque config.wsgi pelo seu módulo. Escute em 0.0.0.0, não em 127.0.0.1. Escute a PORT que você recebe. O fallback ${PORT:-8000} vale só quando PORT está vazia. Se você não escolhe uma porta, um serviço de repositório novo usa 3000, e a Unbroker coloca em PORT a porta do serviço, a menos que você defina PORT. Uma PORT que você define substitui esse valor, então não aponte para uma porta diferente da porta do serviço. O guia de falhas lista PORT e 0.0.0.0 em saúde e roteamento.
Defina as variáveis de produção, confirme que o banco responde, rode o passo de migração e faça o deploy. Depois abra uma página pública, entre na conta, envie um formulário, carregue um estático e envie um arquivo de mídia se a app tiver isso.
O guia parte de um projeto Django que já funciona, dependências Python travadas, um banco de produção e Unbroker Pro. Builds de Dockerfile não estão no Free. Comandos de migração, workers, volumes persistentes, bancos gerenciados e domínios próprios também são Pro. Builds de Dockerfile ficam fora do Serverless, então este serviço não está no caminho de dormir e acordar que os serviços HTTP do Free usam. Os tipos de serviço estão em Service types.
O Pro custa $25 por mês com $25 de crédito de uso. O crédito reinicia a cada ciclo e não acumula. Se o uso elegível fica abaixo do crédito, a cobrança mensal continua o preço do plano. As linhas estão em preços e em Plans.
Checklist
- Deixe
runserverfora do comando de início de produção. - Rode o Gunicorn se a app é WSGI, ou um servidor ASGI se o deploy usa
asgi.py. Escute em0.0.0.0e naPORTrecebida. - Defina
DEBUG = False. Carregue umaSECRET_KEYestável a partir do ambiente. - Coloque o hostname real em
ALLOWED_HOSTS. Inclua as origens HTTPS emCSRF_TRUSTED_ORIGINSonde a app precisar. - Rode
python manage.py check --deploycom os settings de produção. - Defina
STATIC_ROOT, rodecollectstatice sirva esses arquivos com WhiteNoise ou outro host. O Gunicorn não faz isso. - Coloque os uploads dos usuários num volume ou em object storage. Um volume mantém o serviço em uma réplica.
- Rode as migrações uma vez, como passo de release, não no build da imagem e não em cada processo web.
- Coloque o consumidor da fila no próprio worker. Use um job agendado para um comando que termina.
- Faça deploy do serviço Dockerfile no Pro. Confira uma página, um login, um formulário, um estático e um upload de mídia.
Perguntas frequentes
Posso usar runserver em produção?
Não. O checklist de deploy do Django manda sair do manage.py runserver. É um servidor de desenvolvimento leve. Ele não passou por auditorias de segurança nem por testes de desempenho, e o Django diz que ele não serve para produção. Por padrão escuta em 127.0.0.1:8000, recarrega o código e serve estáticos quando staticfiles está ativo. Use um servidor WSGI ou ASGI de produção. O guia de Django da Unbroker diz que runserver não é o comando de início.
Devo usar gunicorn ou uvicorn no Django?
Gunicorn, se o projeto é WSGI. A plataforma principal de deploy do Django é WSGI, e o guia da Unbroker assume uma app WSGI e mostra o Gunicorn. Use um servidor ASGI quando o deploy passa por asgi.py, por exemplo o Uvicorn. A página de Uvicorn do Django também mostra rodar o Uvicorn sob o Gunicorn com o worker do Uvicorn. Nos dois casos, escute em 0.0.0.0 e na PORT que você recebe. Os comandos mais simples do Gunicorn e do Uvicorn escutam em 127.0.0.1:8000, e outras máquinas não alcançam esse endereço.
Por que aparece Bad Request (400) depois do deploy do Django?
Olhe ALLOWED_HOSTS. Com DEBUG em False, o Django não funciona sem um ALLOWED_HOSTS adequado. Um host que não está permitido gera DisallowedHost, que é uma SuspiciousOperation. Se nada mais trata essa exceção, o Django considera o request um bad request. A view de bad request produz uma mensagem Bad Request com status 400, e só é usada quando DEBUG é False. Coloque o hostname real do serviço em ALLOWED_HOSTS. Não libere todos os hosts e não ligue o DEBUG de novo para esconder a página.
Como sirvo os arquivos estáticos do Django em produção?
Defina STATIC_ROOT e rode collectstatic. O servidor de desenvolvimento serve os estáticos sozinho. O Gunicorn não. O WhiteNoise, configurado no Django, pode servir os arquivos coletados. Um host externo de estáticos é a outra opção que o guia da Unbroker cita. Arquivos enviados pelos usuários não ficam nesse diretório.
Quando as migrações do Django devem rodar no deploy?
Uma vez, como passo de release, com as credenciais de runtime, antes de a versão nova receber tráfego. O guia de Django diz para evitar colocar as migrações no build da imagem e para evitar migrações concorrentes em cada processo web. Na Unbroker esse passo é o comando pre-deploy, e comandos de migração exigem Pro. Teste a migração numa cópia descartável antes.
Onde devem ficar os arquivos de mídia enviados?
Em armazenamento persistente ou em object storage, não no filesystem do contêiner. Um deploy, um restart ou um reagendamento pode trocar o contêiner, e arquivos escritos só ali devem ser tratados como temporários. Separe essa mídia dos estáticos coletados. Um serviço com volume na Unbroker tem uma réplica. O volume pode crescer até 50 GB e não pode encolher.
Como faço deploy de uma app Django na Unbroker?
Crie um serviço de repositório com Dockerfile, inclua o Gunicorn e o driver do banco, e defina as variáveis de produção. O comando do guia faz o Gunicorn escutar em 0.0.0.0 e na PORT, com um worker, e usa 8000 só quando PORT está vazia. O caminho exige Pro. Builds de Dockerfile não estão no Free. Os passos estão em Deploy de Django e no guia de Django.