iDefineHD
f9156897ce
Some checks failed
Deploy to Production / Deploy to turbotrades.dev (push) Has been cancelled
317 lines
5.3 KiB
Markdown
317 lines
5.3 KiB
Markdown
# 🚀 TurboTrades - Simple Deployment
|
|
|
|
Quick deployment guide for TurboTrades on turbotrades.dev.
|
|
|
|
---
|
|
|
|
## 📋 Server Setup (Already Done)
|
|
|
|
- **Frontend:** https://turbotrades.dev → `/var/www/html/turbotrades`
|
|
- **Backend:** https://api.turbotrades.dev → Node.js on port 3000
|
|
- **WebSocket:** https://ws.turbotrades.dev → Node.js on port 3000
|
|
- **Backend Code:** `/root/ttbackend`
|
|
- **Nginx:** Already configured
|
|
- **SSL:** Already configured
|
|
|
|
---
|
|
|
|
## 🎯 Quick Deploy
|
|
|
|
### SSH to Server and Run Deploy Script
|
|
|
|
```bash
|
|
# SSH into server
|
|
ssh root@turbotrades.dev
|
|
|
|
# Navigate to backend directory
|
|
cd /root/ttbackend
|
|
|
|
# Pull latest code
|
|
git pull origin main
|
|
|
|
# Run deploy script
|
|
./deploy.sh
|
|
```
|
|
|
|
That's it! ✅
|
|
|
|
---
|
|
|
|
## 🔄 What the Deploy Script Does
|
|
|
|
1. ⏸️ Stops the backend (PM2)
|
|
2. 💾 Creates a backup
|
|
3. 📥 Pulls latest code from Gitea
|
|
4. 📦 Installs backend dependencies
|
|
5. 🎨 Builds frontend
|
|
6. 🚀 Deploys frontend to `/var/www/html/turbotrades`
|
|
7. ▶️ Restarts backend with PM2
|
|
8. ✅ Runs health checks
|
|
|
|
---
|
|
|
|
## 🛠️ Manual Deploy (Without Script)
|
|
|
|
```bash
|
|
# SSH to server
|
|
ssh root@turbotrades.dev
|
|
|
|
# Stop backend
|
|
pm2 stop turbotrades-backend
|
|
|
|
# Navigate to backend
|
|
cd /root/ttbackend
|
|
|
|
# Pull latest code
|
|
git pull origin main
|
|
|
|
# Install backend dependencies
|
|
npm ci --production
|
|
|
|
# Build frontend
|
|
cd frontend
|
|
npm ci
|
|
npm run build
|
|
|
|
# Deploy frontend
|
|
rm -rf /var/www/html/turbotrades/*
|
|
cp -r dist/* /var/www/html/turbotrades/
|
|
chown -R www-data:www-data /var/www/html/turbotrades
|
|
|
|
# Back to backend
|
|
cd /root/ttbackend
|
|
|
|
# Restart backend
|
|
pm2 restart turbotrades-backend
|
|
pm2 save
|
|
|
|
# Check status
|
|
pm2 logs turbotrades-backend
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Monitoring
|
|
|
|
### Check Backend Status
|
|
|
|
```bash
|
|
pm2 list
|
|
pm2 logs turbotrades-backend
|
|
pm2 monit
|
|
```
|
|
|
|
### Check Nginx Logs
|
|
|
|
```bash
|
|
tail -f /var/log/nginx/turbotrades-error.log
|
|
tail -f /var/log/nginx/api-turbotrades-error.log
|
|
tail -f /var/log/nginx/ws-turbotrades-error.log
|
|
```
|
|
|
|
### Health Checks
|
|
|
|
```bash
|
|
# Backend API
|
|
curl https://api.turbotrades.dev/api/health
|
|
|
|
# Frontend
|
|
curl https://turbotrades.dev
|
|
|
|
# WebSocket (requires wscat)
|
|
wscat -c wss://ws.turbotrades.dev
|
|
```
|
|
|
|
---
|
|
|
|
## 🐛 Quick Troubleshooting
|
|
|
|
### Backend Won't Start
|
|
|
|
```bash
|
|
# Check logs
|
|
pm2 logs turbotrades-backend
|
|
|
|
# Check if port 3000 is free
|
|
netstat -tulpn | grep 3000
|
|
|
|
# Check MongoDB
|
|
systemctl status mongod
|
|
|
|
# Restart everything
|
|
pm2 restart turbotrades-backend
|
|
```
|
|
|
|
### Frontend Not Loading
|
|
|
|
```bash
|
|
# Check if files exist
|
|
ls -la /var/www/html/turbotrades/
|
|
|
|
# Check permissions
|
|
chown -R www-data:www-data /var/www/html/turbotrades
|
|
chmod -R 755 /var/www/html/turbotrades
|
|
|
|
# Check nginx
|
|
nginx -t
|
|
systemctl reload nginx
|
|
```
|
|
|
|
### 502 Bad Gateway
|
|
|
|
```bash
|
|
# Backend is probably down
|
|
pm2 restart turbotrades-backend
|
|
|
|
# Check backend is listening
|
|
netstat -tulpn | grep 3000
|
|
|
|
# Check nginx logs
|
|
tail -f /var/log/nginx/api-turbotrades-error.log
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 Rollback
|
|
|
|
```bash
|
|
# SSH to server
|
|
ssh root@turbotrades.dev
|
|
|
|
# Stop current version
|
|
pm2 stop turbotrades-backend
|
|
|
|
# List backups
|
|
ls -lt /root/ | grep ttbackend-backup
|
|
|
|
# Restore from backup
|
|
cd /root
|
|
rm -rf ttbackend
|
|
cp -r ttbackend-backup-YYYYMMDD-HHMMSS ttbackend
|
|
|
|
# Restart
|
|
cd ttbackend
|
|
pm2 restart turbotrades-backend
|
|
```
|
|
|
|
---
|
|
|
|
## 📝 Update .env
|
|
|
|
If you need to update environment variables:
|
|
|
|
```bash
|
|
ssh root@turbotrades.dev
|
|
cd /root/ttbackend
|
|
nano .env
|
|
|
|
# After editing, restart
|
|
pm2 restart turbotrades-backend
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Deployment Workflow
|
|
|
|
### For Code Changes
|
|
|
|
```bash
|
|
# On your local machine
|
|
git add .
|
|
git commit -m "Your changes"
|
|
git push origin main
|
|
|
|
# On the server
|
|
ssh root@turbotrades.dev
|
|
cd /root/ttbackend
|
|
./deploy.sh
|
|
```
|
|
|
|
### For Environment Changes Only
|
|
|
|
```bash
|
|
ssh root@turbotrades.dev
|
|
cd /root/ttbackend
|
|
nano .env
|
|
pm2 restart turbotrades-backend
|
|
```
|
|
|
|
### For Frontend Only
|
|
|
|
```bash
|
|
ssh root@turbotrades.dev
|
|
cd /root/ttbackend
|
|
git pull origin main
|
|
cd frontend
|
|
npm ci
|
|
npm run build
|
|
rm -rf /var/www/html/turbotrades/*
|
|
cp -r dist/* /var/www/html/turbotrades/
|
|
chown -R www-data:www-data /var/www/html/turbotrades
|
|
```
|
|
|
|
### For Backend Only
|
|
|
|
```bash
|
|
ssh root@turbotrades.dev
|
|
cd /root/ttbackend
|
|
git pull origin main
|
|
npm ci --production
|
|
pm2 restart turbotrades-backend
|
|
```
|
|
|
|
---
|
|
|
|
## 🔐 Required Environment Variables
|
|
|
|
Make sure these are set in `/root/ttbackend/.env`:
|
|
|
|
```env
|
|
NODE_ENV=production
|
|
PORT=3000
|
|
|
|
FRONTEND_URL=https://turbotrades.dev
|
|
BACKEND_URL=https://api.turbotrades.dev
|
|
WS_URL=https://ws.turbotrades.dev
|
|
|
|
MONGODB_URI=mongodb://localhost:27017/turbotrades
|
|
|
|
JWT_SECRET=your-secret
|
|
REFRESH_TOKEN_SECRET=your-secret
|
|
SESSION_SECRET=your-secret
|
|
|
|
STEAM_API_KEY=your-key
|
|
STEAM_REALM=https://turbotrades.dev
|
|
STEAM_RETURN_URL=https://api.turbotrades.dev/auth/steam/return
|
|
```
|
|
|
|
---
|
|
|
|
## ✅ Post-Deployment Checklist
|
|
|
|
- [ ] Backend is running (`pm2 list`)
|
|
- [ ] Frontend loads (visit https://turbotrades.dev)
|
|
- [ ] API responds (`curl https://api.turbotrades.dev/api/health`)
|
|
- [ ] Steam login works
|
|
- [ ] WebSocket connects
|
|
- [ ] No errors in PM2 logs
|
|
- [ ] No errors in Nginx logs
|
|
|
|
---
|
|
|
|
## 🆘 Emergency Contacts
|
|
|
|
- **PM2 Documentation:** https://pm2.keymetrics.io/docs/usage/quick-start/
|
|
- **Nginx Documentation:** https://nginx.org/en/docs/
|
|
|
|
---
|
|
|
|
## 🎉 Done!
|
|
|
|
Your TurboTrades instance is now deployed and running!
|
|
|
|
- 🌐 **Frontend:** https://turbotrades.dev
|
|
- 🔧 **Backend:** https://api.turbotrades.dev
|
|
- 💬 **WebSocket:** https://ws.turbotrades.dev
|
|
|
|
**Happy Trading! 🚀** |