Rollback Procedures

Rollback Procedures

Panduan langkah demi langkah untuk melakukan rollback ketika ada masalah setelah deployment.

Overview

Terdapat 4 level rollback, dari yang termudah sampai yang paling kompleks:

Level	Method	Time	Data Loss
1	Dokploy Redeploy	~2 min	None
2	Git Revert	~5 min	None
3	Database Restore	~15-30 min	Last backup
4	Full Infrastructure	~1 hour	Varies

---

Level 1: Dokploy Redeploy (Fastest)

When to Use

• Bug di code tanpa perubahan database
• Perlu kembali ke versi sebelumnya dengan cepat
• Tidak ada schema migration yang bermasalah

Steps

1. Login ke Dokploy dashboard
2. Pilih aplikasi → tab Deployments
3. Temukan deployment yang sebelumnya berfungsi
4. Klik “Redeploy”

[SCREENSHOT: Dokploy → Deployments tab showing previous deployment]

5. Monitor logs sampai selesai
6. Verify dengan health check:

curl https://api.yourdomain.com/api/health

Time Estimate

• ~2 menit

---

Level 2: Git Revert

When to Use

• Commit bermasalah sudah di-push
• Perlu review perubahan sebelum rollback
• Ingin zachh完整的 revert commit

Steps

Option A: Revert via CLI

# Clone repo jika belum ada
git clone https://github.com/Syskita/merq.git
cd merq

# Buat revert commit
git revert HEAD

# Push ke main (trigger auto-deploy)
git push origin main

Option B: Revert via GitHub

1. Buka GitHub repository
2. Pilih commit yang bermasalah
3. Klik “Revert”
4. Buat Pull Request
5. Merge setelah review

Time Estimate

• ~5 menit

---

Level 3: Database Restore

When to Use

• Ada destructive migration yang merusak data -Perlu kembali ke state database sebelumnya
• Level 1 dan 2 tidak menyelesaikan masalah

⚠️ Warning

Database restore akan menghapus semua perubahan sejak backup terakhir. Pastikan tidak ada data penting yang perlu diselamatkan!

Prerequisites

• Backup file tersedia di /backups/
• Tau timestamp backup yang ingin di-restore

Steps

1. Backup Current State (Sebelum Restore)

# Backup dulu state saat ini (jika memungkinkan)
pg_dump -h $DB_HOST -U $DB_USER $DB_NAME > /backups/pre_restore_$(date +%Y%m%d_%H%M%S).sql

2. Stop Application

# Via Dokploy
# Buka dashboard → Stop Application

# Via CLI
docker stop merq-backend
docker stop merq-web

3. Identify Available Backups

ls -la /backups/

4. Restore Database

# Drop dan recreate database
psql -h $DB_HOST -U $DB_USER -c "DROP DATABASE $DB_NAME"
psql -h $DB_HOST -U $DB_USER -c "CREATE DATABASE $DB_NAME"

# Restore dari backup
psql -h $DB_HOST -U $DB_USER $DB_NAME < /backups/merq_YYYYMMDD_HHMMSS.sql

5. Redeploy Previous Version

# Kembali ke versi code sebelumnya (Level 1 atau 2)
# Kemudian start aplikasi
docker start merq-backend
docker start merq-web

6. Verify

# Check application logs
docker logs -f merq-backend

# Health check
curl https://api.yourdomain.com/api/health

# Sample query
curl https://api.yourdomain.com/api/office/v1/users?limit=1

Time Estimate

• ~15-30 menit

---

Level 4: Full Infrastructure Rollback

When to Use

• Seluruh infrastruktur corrupted -Perlu provisioning ulang dari awal
• Semua upaya lain gagal

Steps

1. Document Current State

Catat:

• Error messages
• Logs
• Screenshots
• Steps yang menyebabkan masalah

2. Stop All Services

# Stop semua container
docker-compose down

# atau

docker stop merq-backend merq-web merq-postgres merq-redis merq-typesense

3. Restore dari Snapshots (Jika Ada)

Jika menggunakan DigitalOcean:

1. Buka Droplet settings
2. Pilih Snapshots
3. Restore dari snapshot terakhir yang berfungsi

4. Provision Server Baru

Jika snapshot tidak tersedia:

1. Buat Droplet baru
2. Ikuti Manual Deployment dari awal
3. Restore database dari backup

5. Update DNS

# Point domain ke IP baru
# A Record: api.yourdomain.com → new_server_ip
# A Record: admin.yourdomain.com → new_server_ip

6. Verify Everything

# All services
docker ps

# Health checks
curl https://api.yourdomain.com/api/health
curl https://admin.yourdomain.com

Time Estimate

• ~1 jam atau lebih

---

Pre-Deployment Checklist

Untuk mencegah kebutuhan rollback:

• Backup database sebelum deploy:

  pg_dump -h $DB_HOST -U $DB_USER $DB_NAME > /backups/pre_deploy_$(date +%Y%m%d_%H%M%S).sql

• Test di staging terlebih dahulu

• Review migration scripts:

  • Apakah reversible?
  • Apakah ada data loss?
  • Apakah ada backup strategy?

• Deploy di jam off-peak untuk minimize impact

• Siapkan rollback plan sebelum deploy

---

Rollback Decision Tree

Masalah terjadi setelah deploy
            │
            ▼
    ┌───────────────┐
    │ Severity?     │
    └───────┬───────┘
            │
    ┌───────┴───────┐
    ▼               ▼
┌───────┐     ┌───────┐
│ Critical│     │ Minor │
└───┬───┘     └───┬───┘
    │             │
    ▼             ▼
┌─────────┐   ┌─────────┐
│ Level 1 │   │ Level 1 │
│ or 2    │   │ first   │
└────┬────┘   └───┬────┘
     │             │
     ▼             ▼
┌─────────┐   ┌─────────┐
│ Work?   │   │ Fix in  │
│   ✓     │   │ next    │
└─────────┘   │ release │
              └─────────┘

---

Recovery Time Summary

Level	Method	Typical Time
1	Dokploy Redeploy	2 menit
2	Git Revert	5 menit
3	Database Restore	15-30 menit
4	Full Infrastructure	1+ jam

---

Related Documentation

• Dokploy Deployment
• Manual Deployment
• Infrastructure
• Environment Variables