CompanySite/.agents/devops-engineer/BACKUP_QUICK_REFERENCE.md

Backup System - Quick Reference Card

🚀 Quick Commands

# Setup (first time only)
bash scripts/backup/setup.sh

# Daily operations
npm run backup:full          # Full backup
npm run backup:content       # Content only (quick)
npm run backup:verify        # Check health

# Emergency
npm run backup:list          # Show all backups
npm run backup:restore       # Restore (interactive)

---

📁 Directory Structure

backups/
├── daily/          # Last 7 days
├── weekly/         # Last 4 weeks
├── monthly/        # Last 3 months
├── pre-deploy/     # Last 10 deployments
├── incremental/    # Last 72 hours
└── safety/         # Pre-restore backups (30 days)

---

⏰ Automated Schedule

When	What	Retention
Daily 2:00 AM	Full backup	7 days
Every 6 hours	Incremental (content)	72 hours
Sunday 3:00 AM	Cleanup old backups	Auto
Daily 9:00 AM	Verify backup health	N/A

---

🔧 Setup Automation

Linux/macOS

crontab -e
# See scripts/backup/cron.example for template

Windows

# Run as Administrator
.\scripts\backup\windows-tasks.ps1

---

🆘 Emergency Restore

# 1. List backups
npm run backup:list

# 2. Restore from specific backup
npm run backup:restore backups/daily/full-backup-2026-03-21.tar.gz

# 3. Verify and rebuild
npm install
npm run build
npm run test

---

✅ Health Check

# Quick status
npm run backup:verify

# Check what's in a backup
tar -tzf backups/daily/latest-full.tar.gz | less

# Check backup age
ls -lht backups/daily/

---

📋 Pre-Deployment Checklist

• Run config backup: npm run backup:config
• Verify backup created: ls -lht backups/pre-deploy/
• Note backup location for potential rollback
• Proceed with deployment

---

🔐 What Gets Backed Up

✅ Included:

• src/ - All source code
• public/ - Public assets
• src/content/ - Blog posts, content
• Config files (astro, tailwind, etc.)
• .env - Environment variables
• package.json - Dependencies

❌ Excluded:

• node_modules/ - Reinstallable
• dist/ - Build artifacts
• .astro/ - Build cache
• test-results/ - Test outputs
• .git/ - Version control

---

🚨 Alert Thresholds

Condition	Action
Latest backup > 24h	⚠️ Warning
Latest backup > 48h	🚨 Critical
Corrupted backup	🚨 Critical
Storage > 80%	⚠️ Cleanup needed
Storage > 5GB	⚠️ Review retention

---

🛠️ Troubleshooting

Backup fails

df -h                        # Check disk space
ls -la backups/              # Check permissions
npm run backup:verify        # Verify system

Restore fails

tar -tzf backup.tar.gz       # Verify integrity
npm run backup:verify backup.tar.gz

Missing files after restore

tar -tzf backup.tar.gz | grep "filename"

---

📞 Emergency Contacts

Issue	Contact
Backup system failure	DevOps Lead
Cannot restore	Tech Lead
Disk space full	Platform Admin
Corrupted backup	DevOps Lead

---

📚 Documentation

• Full strategy: .agents/devops-engineer/BACKUP_STRATEGY.md
• Scripts README: scripts/backup/README.md
• Deployment: DEPLOYMENT.md

---

💡 Best Practices

1. ✅ Test restores monthly - Verify backups work
2. ✅ Always backup before deployment - Safety first
3. ✅ Monitor backup health - Check verification output
4. ✅ Keep multiple backup types - Redundancy
5. ✅ Secure environment files - Encrypt if needed

---

Last Updated: 2026-03-21 Version: 1.0