288 lines
6.1 KiB
Markdown
288 lines
6.1 KiB
Markdown
# 🚀 HOW TO DEPLOY CHANGES TO LIVE SITE
|
|
|
|
**Last Updated**: December 13, 2025
|
|
|
|
---
|
|
|
|
## 📋 DEPLOYMENT CHECKLIST
|
|
|
|
### Step 1: Commit Changes to GitHub ✅
|
|
|
|
```bash
|
|
# Check what changed
|
|
git status
|
|
|
|
# Add all changes
|
|
git add .
|
|
|
|
# Commit with descriptive message
|
|
git commit -m "feat: Add 10 collection management pages with Titanium Pro design"
|
|
|
|
# Push to main branch
|
|
git push origin main
|
|
```
|
|
|
|
---
|
|
|
|
### Step 2: Fix Directus Permissions (ONE-TIME) ⚠️
|
|
|
|
**CRITICAL**: This must be done ONCE before the frontend can access data.
|
|
|
|
1. **Log into Directus Admin**
|
|
```
|
|
URL: https://spark.jumpstartscaling.com/admin
|
|
Email: somescreenname@gmail.com
|
|
Password: Idk@2025lol
|
|
```
|
|
|
|
2. **Navigate to Access Control**
|
|
- Click **Settings** (⚙️ gear icon at bottom left)
|
|
- Click **Access Control** (🔑 key icon)
|
|
|
|
3. **Grant Permissions to Collections**
|
|
|
|
Find your role (e.g., "Administrator" or the role assigned to your API token).
|
|
|
|
Enable **Read** permission (eye icon 👁️) for these collections:
|
|
- `avatar_intelligence` ✅
|
|
- `avatar_variants` ✅
|
|
- `campaign_masters` ✅
|
|
- `cartesian_patterns` ✅
|
|
- `content_fragments` ✅
|
|
- `generated_articles` ✅
|
|
- `generation_jobs` ✅
|
|
- `geo_intelligence` ✅
|
|
- `headline_inventory` ✅
|
|
- `leads` ✅
|
|
- `offer_blocks` ✅
|
|
- `spintax_dictionaries` ✅
|
|
|
|
4. **Verify API Token**
|
|
```
|
|
Token: oGn-0AZjenB900pfzQYH8zCbFwGw7flU
|
|
```
|
|
|
|
Make sure this token uses the role you just updated.
|
|
|
|
---
|
|
|
|
### Step 3: Rebuild Frontend Container 🐳
|
|
|
|
**Option A: SSH Method (Recommended)**
|
|
|
|
```bash
|
|
# 1. SSH into server
|
|
ssh root@72.61.15.216
|
|
|
|
# 2. Navigate to Coolify app directory
|
|
cd /data/coolify/applications/i8cswkos04c4s08404ok0ws4
|
|
|
|
# 3. Pull latest code from GitHub
|
|
docker exec frontend-i8cswkos04c4s08404ok0ws4-021136192114 sh -c "cd /app && git pull"
|
|
|
|
# 4. Rebuild frontend container
|
|
docker compose build frontend
|
|
|
|
# 5. Restart frontend with new build
|
|
docker compose up -d frontend
|
|
|
|
# 6. Check logs for errors
|
|
docker logs -f frontend-i8cswkos04c4s08404ok0ws4-021136192114
|
|
```
|
|
|
|
**Option B: Coolify UI Method**
|
|
|
|
1. Go to your Coolify dashboard: http://72.61.15.216:8000
|
|
2. Find the "launch.jumpstartscaling.com" application
|
|
3. Click **"Redeploy"** or **"Force Rebuild"**
|
|
4. Wait for build to complete (~2-3 minutes)
|
|
5. Check deployment logs
|
|
|
|
---
|
|
|
|
### Step 4: Verify Deployment ✅
|
|
|
|
**Test Frontend is Live:**
|
|
```bash
|
|
curl -I https://launch.jumpstartscaling.com
|
|
# Should return: HTTP/2 200
|
|
```
|
|
|
|
**Test Admin Dashboard:**
|
|
```bash
|
|
curl https://launch.jumpstartscaling.com/admin
|
|
# Should return HTML (not error page)
|
|
```
|
|
|
|
**Test API Connection:**
|
|
```bash
|
|
curl https://launch.jumpstartscaling.com/api/health
|
|
# Should return: {"status":"ok"}
|
|
```
|
|
|
|
**Manual Browser Test:**
|
|
1. Open https://launch.jumpstartscaling.com
|
|
2. Navigate to `/admin`
|
|
3. Check that command palette (Cmd+K) works
|
|
4. Verify no console errors (F12)
|
|
5. Test at least 2-3 collection pages
|
|
|
|
---
|
|
|
|
### Step 5: Monitor for Issues 🔍
|
|
|
|
**Check Container Health:**
|
|
```bash
|
|
ssh root@72.61.15.216
|
|
docker ps | grep -E 'directus|frontend|postgres|redis'
|
|
```
|
|
|
|
**Check Frontend Logs:**
|
|
```bash
|
|
docker logs --tail 100 frontend-i8cswkos04c4s08404ok0ws4-021136192114
|
|
```
|
|
|
|
**Check Directus Logs:**
|
|
```bash
|
|
docker logs --tail 100 directus-i8cswkos04c4s08404ok0ws4-021136158139
|
|
```
|
|
|
|
---
|
|
|
|
## 🆘 TROUBLESHOOTING
|
|
|
|
### "Site shows old build"
|
|
```bash
|
|
# Force rebuild from scratch
|
|
ssh root@72.61.15.216
|
|
cd /data/coolify/applications/i8cswkos04c4s08404ok0ws4
|
|
docker compose build --no-cache frontend
|
|
docker compose up -d frontend
|
|
```
|
|
|
|
### "API returns 403 Forbidden"
|
|
- Check Directus permissions (Step 2 above)
|
|
- Verify API token is still valid
|
|
- Check role has read access to collections
|
|
|
|
### "Container won't start"
|
|
```bash
|
|
# Check for port conflicts
|
|
docker ps -a
|
|
|
|
# Check build logs
|
|
docker compose logs frontend
|
|
|
|
# Restart all services
|
|
docker compose restart
|
|
```
|
|
|
|
### "Changes not appearing"
|
|
```bash
|
|
# Clear browser cache (Cmd+Shift+R on Mac)
|
|
# Or use incognito mode to test
|
|
|
|
# Verify Git commit reached server
|
|
ssh root@72.61.15.216
|
|
cd /data/coolify/applications/i8cswkos04c4s08404ok0ws4
|
|
docker exec frontend-i8cswkos04c4s08404ok0ws4-021136192114 sh -c "cd /app && git log -1"
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 QUICK DEPLOY SCRIPT
|
|
|
|
Save this as `deploy.sh` for one-command deployments:
|
|
|
|
```bash
|
|
#!/bin/bash
|
|
set -e
|
|
|
|
echo "🚀 Deploying Spark Alpha..."
|
|
|
|
# Step 1: Commit changes
|
|
echo "📝 Committing changes..."
|
|
git add .
|
|
git commit -m "${1:-Update Spark Alpha}" || echo "No changes to commit"
|
|
git push origin main
|
|
|
|
# Step 2: SSH and rebuild
|
|
echo "🐳 Rebuilding on server..."
|
|
ssh root@72.61.15.216 << 'ENDSSH'
|
|
cd /data/coolify/applications/i8cswkos04c4s08404ok0ws4
|
|
docker compose pull frontend
|
|
docker compose build frontend
|
|
docker compose up -d frontend
|
|
echo "✅ Deployment complete!"
|
|
docker logs --tail 20 frontend-i8cswkos04c4s08404ok0ws4-021136192114
|
|
ENDSSH
|
|
|
|
echo "🎉 Done! Check https://launch.jumpstartscaling.com"
|
|
```
|
|
|
|
**Usage:**
|
|
```bash
|
|
chmod +x deploy.sh
|
|
./deploy.sh "Add new collection pages"
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 DEPLOYMENT CHECKLIST
|
|
|
|
Before deploying to production, verify:
|
|
|
|
- [ ] All tests pass locally
|
|
- [ ] No console errors in browser
|
|
- [ ] API connections working
|
|
- [ ] Directus permissions configured
|
|
- [ ] Docker containers healthy
|
|
- [ ] SSL certificates valid
|
|
- [ ] Database migrations applied
|
|
- [ ] Environment variables set
|
|
- [ ] Backup recent data
|
|
- [ ] Commit message is descriptive
|
|
|
|
---
|
|
|
|
## 🔐 CREDENTIALS REFERENCE
|
|
|
|
### SSH Access
|
|
```
|
|
Server: root@72.61.15.216
|
|
Method: SSH key authentication
|
|
```
|
|
|
|
### Directus Admin
|
|
```
|
|
URL: https://spark.jumpstartscaling.com/admin
|
|
Email: somescreenname@gmail.com
|
|
Password: Idk@2025lol
|
|
```
|
|
|
|
### API Token
|
|
```
|
|
Token: oGn-0AZjenB900pfzQYH8zCbFwGw7flU
|
|
Usage: Set as DIRECTUS_TOKEN in frontend .env
|
|
```
|
|
|
|
### Database (Coolify-generated)
|
|
```
|
|
User: wdoC78BlbpuP82SO
|
|
Password: KVvgCRzH0yy7p7R9TVYBooDjE073Pbq4
|
|
Database: directus
|
|
Host: postgresql (internal network)
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 ADDITIONAL RESOURCES
|
|
|
|
- [Coolify Documentation](https://coolify.io/docs)
|
|
- [Docker Compose Reference](https://docs.docker.com/compose/)
|
|
- [Directus API Docs](https://docs.directus.io/reference/introduction.html)
|
|
|
|
---
|
|
|
|
**IMPORTANT**: Always test on a development environment first if making major changes!
|