396 lines
6.6 KiB
Markdown
396 lines
6.6 KiB
Markdown
# 🖥️ Deploy em Servidor Local - Liberi Kids
|
||
|
||
Guia completo para rodar o sistema no servidor local e manter funcionando automaticamente, mesmo após reinicializações.
|
||
|
||
---
|
||
|
||
## 📋 Pré-requisitos
|
||
|
||
```bash
|
||
# Node.js 18+
|
||
node --version
|
||
|
||
# NPM
|
||
npm --version
|
||
|
||
# PM2 (gerenciador de processos)
|
||
sudo npm install -g pm2
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 Método 1: PM2 (Recomendado - Mais Fácil)
|
||
|
||
### 1️⃣ Instalação Inicial
|
||
|
||
```bash
|
||
# 1. Entre no diretório do projeto
|
||
cd /home/tiago/Downloads/app_estoque_v1.0.0
|
||
|
||
# 2. Instale as dependências
|
||
npm install
|
||
cd client && npm install && cd ..
|
||
|
||
# 3. Configure o .env
|
||
cp .env.example .env
|
||
nano .env # Configure suas credenciais do Supabase
|
||
|
||
# 4. Faça o build do frontend
|
||
npm run build
|
||
```
|
||
|
||
### 2️⃣ Iniciar com PM2
|
||
|
||
```bash
|
||
# Inicia o servidor com PM2
|
||
pm2 start ecosystem.config.js
|
||
|
||
# Verifica o status
|
||
pm2 status
|
||
|
||
# Ver logs em tempo real
|
||
pm2 logs liberi-kids-estoque
|
||
|
||
# Ver logs específicos
|
||
pm2 logs liberi-kids-estoque --lines 100
|
||
```
|
||
|
||
### 3️⃣ Configurar Inicialização Automática
|
||
|
||
```bash
|
||
# Salva a configuração atual
|
||
pm2 save
|
||
|
||
# Configura para iniciar no boot do sistema
|
||
pm2 startup
|
||
|
||
# Execute o comando que o PM2 mostrar (algo como):
|
||
# sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u seu-usuario --hp /home/seu-usuario
|
||
```
|
||
|
||
### 4️⃣ Comandos Úteis do PM2
|
||
|
||
```bash
|
||
# Reiniciar aplicação
|
||
pm2 restart liberi-kids-estoque
|
||
|
||
# Parar aplicação
|
||
pm2 stop liberi-kids-estoque
|
||
|
||
# Remover do PM2
|
||
pm2 delete liberi-kids-estoque
|
||
|
||
# Ver informações detalhadas
|
||
pm2 show liberi-kids-estoque
|
||
|
||
# Monitorar em tempo real
|
||
pm2 monit
|
||
|
||
# Ver logs de erro
|
||
pm2 logs liberi-kids-estoque --err
|
||
|
||
# Limpar logs antigos
|
||
pm2 flush
|
||
```
|
||
|
||
### 5️⃣ Atualizar Aplicação
|
||
|
||
```bash
|
||
# 1. Faça as alterações no código
|
||
# 2. Se alterou o frontend, faça o build
|
||
cd client && npm run build && cd ..
|
||
|
||
# 3. Reinicie o PM2
|
||
pm2 restart liberi-kids-estoque
|
||
|
||
# Ou faça reload sem downtime
|
||
pm2 reload liberi-kids-estoque
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 Método 2: Systemd (Mais Robusto)
|
||
|
||
### 1️⃣ Criar Serviço Systemd
|
||
|
||
```bash
|
||
# Crie o arquivo de serviço
|
||
sudo nano /etc/systemd/system/liberi-kids.service
|
||
```
|
||
|
||
**Conteúdo do arquivo:**
|
||
|
||
```ini
|
||
[Unit]
|
||
Description=Liberi Kids - Sistema de Estoque
|
||
After=network.target
|
||
|
||
[Service]
|
||
Type=simple
|
||
User=tiago
|
||
WorkingDirectory=/home/tiago/Downloads/app_estoque_v1.0.0
|
||
Environment=NODE_ENV=production
|
||
Environment=PORT=5000
|
||
ExecStart=/usr/bin/node server-supabase.js
|
||
Restart=always
|
||
RestartSec=10
|
||
StandardOutput=append:/home/tiago/Downloads/app_estoque_v1.0.0/logs/system.log
|
||
StandardError=append:/home/tiago/Downloads/app_estoque_v1.0.0/logs/error.log
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
```
|
||
|
||
### 2️⃣ Ativar o Serviço
|
||
|
||
```bash
|
||
# Criar diretório de logs
|
||
mkdir -p logs
|
||
|
||
# Recarregar systemd
|
||
sudo systemctl daemon-reload
|
||
|
||
# Habilitar para iniciar no boot
|
||
sudo systemctl enable liberi-kids
|
||
|
||
# Iniciar o serviço
|
||
sudo systemctl start liberi-kids
|
||
|
||
# Verificar status
|
||
sudo systemctl status liberi-kids
|
||
```
|
||
|
||
### 3️⃣ Comandos do Systemd
|
||
|
||
```bash
|
||
# Ver status
|
||
sudo systemctl status liberi-kids
|
||
|
||
# Parar serviço
|
||
sudo systemctl stop liberi-kids
|
||
|
||
# Reiniciar serviço
|
||
sudo systemctl restart liberi-kids
|
||
|
||
# Ver logs
|
||
sudo journalctl -u liberi-kids -f
|
||
|
||
# Ver logs das últimas 100 linhas
|
||
sudo journalctl -u liberi-kids -n 100
|
||
|
||
# Desabilitar inicialização automática
|
||
sudo systemctl disable liberi-kids
|
||
```
|
||
|
||
---
|
||
|
||
## 🔥 Script de Deploy Rápido
|
||
|
||
Criei um script para facilitar o deploy. Execute:
|
||
|
||
```bash
|
||
chmod +x scripts/deploy-servidor.sh
|
||
./scripts/deploy-servidor.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 🌐 Configurar Nginx (Opcional)
|
||
|
||
Se quiser usar um domínio ou porta 80/443:
|
||
|
||
```bash
|
||
# Instalar Nginx
|
||
sudo apt install nginx -y
|
||
|
||
# Criar configuração
|
||
sudo nano /etc/nginx/sites-available/liberi-kids
|
||
```
|
||
|
||
**Configuração do Nginx:**
|
||
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name seu-dominio.com; # ou IP do servidor
|
||
|
||
location / {
|
||
proxy_pass http://localhost:5000;
|
||
proxy_http_version 1.1;
|
||
proxy_set_header Upgrade $http_upgrade;
|
||
proxy_set_header Connection 'upgrade';
|
||
proxy_set_header Host $host;
|
||
proxy_cache_bypass $http_upgrade;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
}
|
||
```
|
||
|
||
```bash
|
||
# Ativar site
|
||
sudo ln -s /etc/nginx/sites-available/liberi-kids /etc/nginx/sites-enabled/
|
||
|
||
# Testar configuração
|
||
sudo nginx -t
|
||
|
||
# Reiniciar Nginx
|
||
sudo systemctl restart nginx
|
||
```
|
||
|
||
---
|
||
|
||
## 🔒 Configurar Firewall
|
||
|
||
```bash
|
||
# Permitir porta 5000
|
||
sudo ufw allow 5000/tcp
|
||
|
||
# Ou se usar Nginx
|
||
sudo ufw allow 80/tcp
|
||
sudo ufw allow 443/tcp
|
||
|
||
# Verificar status
|
||
sudo ufw status
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 Monitoramento
|
||
|
||
### Ver uso de recursos
|
||
|
||
```bash
|
||
# Com PM2
|
||
pm2 monit
|
||
|
||
# Processos
|
||
htop
|
||
|
||
# Espaço em disco
|
||
df -h
|
||
|
||
# Memória
|
||
free -h
|
||
```
|
||
|
||
### Logs
|
||
|
||
```bash
|
||
# PM2
|
||
pm2 logs liberi-kids-estoque --lines 200
|
||
|
||
# Systemd
|
||
sudo journalctl -u liberi-kids -f
|
||
|
||
# Logs customizados
|
||
tail -f logs/pm2-error.log
|
||
tail -f logs/pm2-out.log
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 Backup Automático
|
||
|
||
Adicione ao crontab:
|
||
|
||
```bash
|
||
# Editar crontab
|
||
crontab -e
|
||
|
||
# Adicionar linha para backup diário às 3h da manhã
|
||
0 3 * * * cd /home/tiago/Downloads/app_estoque_v1.0.0 && ./backup-projeto-completo.sh
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ Troubleshooting
|
||
|
||
### Aplicação não inicia
|
||
|
||
```bash
|
||
# Verificar logs
|
||
pm2 logs liberi-kids-estoque
|
||
|
||
# Verificar se a porta está em uso
|
||
sudo lsof -i :5000
|
||
|
||
# Matar processo na porta
|
||
sudo kill -9 $(sudo lsof -t -i:5000)
|
||
|
||
# Reiniciar
|
||
pm2 restart liberi-kids-estoque
|
||
```
|
||
|
||
### Alto uso de memória
|
||
|
||
```bash
|
||
# Reiniciar aplicação
|
||
pm2 restart liberi-kids-estoque
|
||
|
||
# Limpar cache do npm
|
||
npm cache clean --force
|
||
|
||
# Verificar processos
|
||
pm2 monit
|
||
```
|
||
|
||
### Erros de permissão
|
||
|
||
```bash
|
||
# Dar permissões corretas
|
||
sudo chown -R $USER:$USER /home/tiago/Downloads/app_estoque_v1.0.0
|
||
|
||
# Permissões de execução
|
||
chmod +x server-supabase.js
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 Resumo - Comandos Principais
|
||
|
||
```bash
|
||
# ✅ Iniciar aplicação
|
||
pm2 start ecosystem.config.js
|
||
|
||
# ✅ Ver status
|
||
pm2 status
|
||
|
||
# ✅ Ver logs
|
||
pm2 logs liberi-kids-estoque
|
||
|
||
# ✅ Reiniciar
|
||
pm2 restart liberi-kids-estoque
|
||
|
||
# ✅ Salvar configuração
|
||
pm2 save
|
||
|
||
# ✅ Configurar auto-inicialização
|
||
pm2 startup
|
||
|
||
# ✅ Acessar aplicação
|
||
# http://seu-ip:5000
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 Próximos Passos
|
||
|
||
1. ✅ Sistema rodando com PM2
|
||
2. ⚙️ Configurar Nginx (opcional)
|
||
3. 🔒 Configurar SSL com Let's Encrypt (opcional)
|
||
4. 📊 Configurar monitoramento
|
||
5. 💾 Configurar backups automáticos
|
||
|
||
---
|
||
|
||
## 📞 Suporte
|
||
|
||
- **Logs PM2**: `pm2 logs liberi-kids-estoque`
|
||
- **Status**: `pm2 status`
|
||
- **Monitoramento**: `pm2 monit`
|
||
|
||
**Aplicação rodando em**: http://localhost:5000
|
||
**Catálogo público**: http://localhost:5000/catalogo
|