Fazer deploy de uma aplicacao web e o processo de publicar seu codigo em um servidor para que ele fique acessivel pela internet. O resultado esperado e que usuarios possam acessar sua aplicacao por um dominio ou IP publico, com tudo funcionando, banco de dados, APIs, autenticacao, etc. Antes de comecar, voce precisa de: uma aplicacao funcional em ambiente de desenvolvimento (testada localmente), acesso a um servidor ou servico de hospedagem (como AWS, DigitalOcean, Vercel ou um VPS), e conhecimentos basicos de terminal e Git. Este guia cobre as etapas essenciais, independentemente da stack.
Passo 1: Preparar o codigo para producao
O primeiro passo e garantir que seu codigo esteja pronto para um ambiente de producao. Isso significa remover configuracoes de debug, ajustar variaveis de ambiente e compilar ou buildar o projeto, se necessario.
O que fazer: Crie um arquivo .env.production com variaveis como DATABASE_URL, SECRET_KEY e API_URL apontando para os servicos de producao. Rode o comando de build (ex.: npm run build para React, python manage.py collectstatic para Django) e verifique se nao ha erros. Teste localmente com as variaveis de producao antes de subir.
Dica: Use um arquivo .gitignore para evitar que arquivos sensiveis (como .env) sejam enviados ao repositorio. Muitos servicos de deploy leem variaveis diretamente do painel de controle.
Erro comum: Esquecer de desabilitar o modo debug. Em frameworks como Django e Flask, deixar DEBUG=True em producao expoe informacoes do sistema e pode causar vazamento de dados. Sempre troque para DEBUG=False.
Passo 2: Escolher e configurar o ambiente de servidor
A escolha do servidor depende do orcamento e da complexidade do projeto. Para aplicacoes simples, servicos como Vercel (front-end) ou Heroku (back-end) oferecem deploy com poucos cliques. Para mais controle, um VPS (como DigitalOcean Droplet ou AWS EC2) exige configuracao manual.
O que fazer: Se optar por um VPS, acesse via SSH e instale as dependencias necessarias: Node.js, Python, Nginx, PostgreSQL, etc. Configure um firewall (ufw) para liberar apenas as portas 80 (HTTP) e 443 (HTTPS). Crie um usuario nao-root para seguranca.
Dica: Para projetos pequenos, considere usar Docker para empacotar a aplicacao com todas as dependencias. Isso evita problemas de "funciona na minha maquina".
Erro comum: Usar o servidor padrao de desenvolvimento (ex.: python manage.py runserver) em producao. Esses servidores nao sao seguros nem performaticos. Use Gunicorn (Python), PM2 (Node.js) ou Nginx como proxy reverso.
Passo 3: Configurar o banco de dados
Aplicacoes web geralmente dependem de um banco de dados. Em producao, voce precisa de uma instancia separada do banco local, com backups e acesso controlado.
O que fazer: Crie um banco de dados no mesmo servidor (ex.: PostgreSQL com createdb) ou use um servico gerenciado como Amazon RDS ou MongoDB Atlas. Atualize a string de conexao no arquivo de variaveis. Execute as migracoes (ex.: python manage.py migrate) para criar as tabelas.
Dica: Nunca use o mesmo banco de dados para desenvolvimento e producao. Um erro no codigo pode corromper dados reais. Mantenha ambientes separados.
Erro comum: Esquecer de configurar backups automaticos. Em servicos gerenciados, ative backups diarios. Em VPS, use scripts com pg_dump e agende no cron.
Passo 4: Transferir os arquivos para o servidor
Com o ambiente pronto, e hora de enviar o codigo. Existem duas abordagens principais: via Git (clone do repositorio no servidor) ou via FTP/SCP.
O que fazer: No servidor, clone o repositorio: git clone <url>. Para updates futuros, git pull e o comando de build. Se usar FTP, ferramentas como FileZilla transferem os arquivos, mas o processo e manual e sujeito a erros.
Dica: Automatize com pipelines de CI/CD (GitHub Actions, GitLab CI). Configure para que, a cada push na branch main, o servidor faca pull e rebuild. Isso reduz erros humanos.
Erro comum: Transferir arquivos com permissoes incorretas. No Linux, pastas estaticas (static, media) precisam de permissao de leitura para o usuario do servidor web (www-data). Use chmod e chown adequadamente.
Passo 5: Configurar o servidor web e dominio
Para que usuarios acessem sua aplicacao por um nome legivel (ex.: meusite.com), configure um servidor web como Nginx ou Apache e aponte o dominio.
O que fazer: Instale o Nginx e crie um arquivo de configuracao em /etc/nginx/sites-available/meusite. Defina o server_name com seu dominio e o proxy_pass para a porta onde a aplicacao roda (ex.: http://localhost:8000). Habilite o site com ln -s e reinicie o Nginx.
No registro de dominio (GoDaddy, Cloudflare), crie um registro A apontando para o IP do servidor. Pode levar alguns minutos para propagar.
Dica: Use Cloudflare como DNS. Ele oferece CDN, protecao DDoS e SSL gratuito com configuracao simples.
Erro comum: Configurar o proxy_pass para http://127.0.0.1:8000 mas esquecer de iniciar a aplicacao. Use um gerenciador de processos (PM2, supervisor) para garantir que a aplicacao reinicie automaticamente apos falhas.
Passo 6: Habilitar HTTPS com SSL
Sites seguros usam HTTPS. O Let's Encrypt fornece certificados SSL gratuitos, renovados automaticamente.
O que fazer: Instale o Certbot (sudo apt install certbot python3-certbot-nginx) e execute sudo certbot --nginx -d meusite.com. Siga as instrucoes. O Certbot modifica automaticamente a configuracao do Nginx para redirecionar HTTP para HTTPS.
Dica: Teste a renovacao com sudo certbot renew --dry-run. Se falhar, verifique se a porta 80 esta acessivel (o Let's Encrypt precisa dela para validar o dominio).
Erro comum: Esquecer de renovar o certificado. O Certbot adiciona um cron job automaticamente, mas em alguns sistemas (como Docker) isso pode nao funcionar. Verifique manualmente a cada 60 dias.
Passo 7: Testar e monitorar a aplicacao
Apos o deploy, teste todos os fluxos: login, cadastro, pagamento, etc. Monitore logs e desempenho para identificar problemas.
O que fazer: Acesse o dominio e navegue pelas paginas. Verifique o console do navegador (F12) para erros de rede. No servidor, veja logs do Nginx (/var/log/nginx/error.log) e da aplicacao (ex.: journalctl -u meuaplicativo).
Dica: Use ferramentas como UptimeRobot ou Pingdom para monitorar se o site esta no ar. Configure alertas por email ou Slack.
Erro comum: Ignorar erros 500. Eles indicam problemas no codigo ou no servidor. Verifique os logs imediatamente e corrija antes de divulgar o site.
Checklist final: o que voce fez
- [ ] Codigo preparado para producao (build, variaveis de ambiente, debug desligado)
- [ ] Servidor configurado (dependencias, firewall, usuario nao-root)
- [ ] Banco de dados criado e migracoes executadas
- [ ] Arquivos transferidos (Git ou FTP)
- [ ] Servidor web configurado (Nginx com proxy reverso)
- [ ] Dominio apontado e HTTPS habilitado
- [ ] Testes realizados e monitoramento ativo
Com esses passos, sua aplicacao web esta no ar. O proximo passo e manter o codigo atualizado e fazer backups regulares. Se encontrar problemas, consulte a documentacao oficial da sua stack ou forums como Stack Overflow.
FAQ
Qual a diferenca entre deploy manual e automatizado?
No deploy manual, voce executa cada etapa (transferir arquivos, rodar comandos) manualmente. No automatizado, ferramentas como GitHub Actions ou Jenkins executam esses passos automaticamente a cada commit, reduzindo erros e tempo.
Preciso de um dominio proprio para fazer deploy?
Nao. Durante o desenvolvimento, voce pode usar o IP publico do servidor ou servicos como ngrok para testes. Para producao, um dominio proprio e recomendado para credibilidade e SEO.
Como escolher entre VPS e servicos gerenciados (PaaS)?
VPS oferece controle total, mas exige configuracao manual e manutencao. PaaS (Heroku, Vercel) e mais simples e rapido, ideal para projetos pequenos ou MVPs. Para aplicacoes com muitos usuarios, um VPS ou servico em nuvem (AWS, GCP) pode ser mais viavel.
O que fazer se o deploy falhar?
Verifique os logs do servidor e da aplicacao. Causas comuns: variaveis de ambiente ausentes, porta ocupada, dependencias nao instaladas, ou permissao de arquivos incorreta. Teste localmente com as mesmas configuracoes.
Devo usar Docker para deploy?
Docker empacota a aplicacao e dependencias em um container, garantindo que funcione igual em qualquer ambiente. E recomendado para equipes ou projetos complexos, mas adiciona complexidade. Para projetos simples, pode ser desnecessario.
Como fazer deploy de uma aplicacao com front-end e back-end separados?
O front-end (React, Vue) pode ser hospedado em servicos como Vercel ou Netlify, enquanto o back-end (API) vai para um VPS ou PaaS. Configure CORS no back-end para permitir requisicoes do dominio do front-end. Use um proxy reverso se estiverem no mesmo servidor.
