164 lines
2.5 KiB
Markdown
164 lines
2.5 KiB
Markdown
# 🚀 Início Rápido - Servidor Local Persistente
|
|
|
|
## Como rodar o sistema no servidor e manter funcionando sempre
|
|
|
|
---
|
|
|
|
## ⚡ Método Rápido (Recomendado)
|
|
|
|
Execute apenas **1 comando**:
|
|
|
|
```bash
|
|
./scripts/deploy-servidor.sh
|
|
```
|
|
|
|
Este script vai:
|
|
- ✅ Verificar dependências
|
|
- ✅ Instalar PM2 automaticamente
|
|
- ✅ Fazer build do frontend
|
|
- ✅ Iniciar a aplicação
|
|
- ✅ Configurar para reiniciar automaticamente
|
|
|
|
---
|
|
|
|
## 🔧 Configuração Manual
|
|
|
|
Se preferir fazer passo a passo:
|
|
|
|
### 1. Instalar PM2 (Gerenciador de Processos)
|
|
|
|
```bash
|
|
sudo npm install -g pm2
|
|
```
|
|
|
|
### 2. Configurar o projeto
|
|
|
|
```bash
|
|
# Instalar dependências
|
|
npm install
|
|
cd client && npm install && cd ..
|
|
|
|
# Configurar .env
|
|
cp .env.example .env
|
|
nano .env # Configure suas credenciais
|
|
|
|
# Build do frontend
|
|
npm run build
|
|
```
|
|
|
|
### 3. Iniciar com PM2
|
|
|
|
```bash
|
|
# Iniciar aplicação
|
|
pm2 start ecosystem.config.js
|
|
|
|
# Salvar configuração
|
|
pm2 save
|
|
|
|
# Configurar para iniciar no boot
|
|
pm2 startup
|
|
# Execute o comando que o PM2 mostrar
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Comandos Essenciais
|
|
|
|
```bash
|
|
# Ver status
|
|
pm2 status
|
|
|
|
# Ver logs em tempo real
|
|
pm2 logs liberi-kids-estoque
|
|
|
|
# Reiniciar aplicação
|
|
pm2 restart liberi-kids-estoque
|
|
|
|
# Parar aplicação
|
|
pm2 stop liberi-kids-estoque
|
|
|
|
# Monitorar recursos
|
|
pm2 monit
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 Atualizar Aplicação
|
|
|
|
Quando fizer alterações no código:
|
|
|
|
```bash
|
|
# 1. Se alterou o frontend
|
|
cd client && npm run build && cd ..
|
|
|
|
# 2. Reiniciar PM2
|
|
pm2 restart liberi-kids-estoque
|
|
```
|
|
|
|
---
|
|
|
|
## 🌐 Acessar Aplicação
|
|
|
|
Após iniciar, acesse:
|
|
|
|
- **Local**: http://localhost:5000
|
|
- **Na rede**: http://SEU-IP:5000
|
|
- **Catálogo**: http://localhost:5000/catalogo
|
|
|
|
---
|
|
|
|
## 🛡️ Systemd (Alternativa ao PM2)
|
|
|
|
Se preferir usar systemd:
|
|
|
|
```bash
|
|
# Instalar serviço
|
|
sudo ./scripts/install-systemd.sh
|
|
|
|
# Comandos
|
|
sudo systemctl status liberi-kids
|
|
sudo systemctl restart liberi-kids
|
|
sudo journalctl -u liberi-kids -f
|
|
```
|
|
|
|
---
|
|
|
|
## ⚠️ Problemas Comuns
|
|
|
|
### Porta em uso
|
|
```bash
|
|
sudo lsof -i :5000
|
|
sudo kill -9 PID
|
|
```
|
|
|
|
### PM2 não encontra node
|
|
```bash
|
|
pm2 unstartup
|
|
pm2 startup
|
|
pm2 save
|
|
```
|
|
|
|
### Aplicação não inicia
|
|
```bash
|
|
pm2 logs liberi-kids-estoque --lines 50
|
|
```
|
|
|
|
---
|
|
|
|
## 📖 Documentação Completa
|
|
|
|
Para mais detalhes, consulte:
|
|
- **Guia Completo**: `DEPLOY-SERVIDOR-LOCAL.md`
|
|
- **Deploy Geral**: `README-DEPLOY.md`
|
|
|
|
---
|
|
|
|
## ✅ Resumo
|
|
|
|
1. Execute: `./scripts/deploy-servidor.sh`
|
|
2. Configure auto-start quando solicitado
|
|
3. Sistema rodará sempre, mesmo após reiniciar servidor
|
|
4. Use `pm2 logs` para monitorar
|
|
|
|
**Pronto! 🎉**
|