erhankaraarslan Rollback Skill
Bu skill, hatalı deployment veya kod değişikliklerini geri almak için güvenli rollback stratejileri sağlar.
🎯 Rollback Prensipleri
Golden Rule
"Forward is better than backward, but backward is better than broken"
Önce düzelt (hotfix), düzeltemiyorsan geri al (rollback).
🚨 Ne Zaman Rollback?
✅ Rollback YAP
- Production'da kritik hata var
- Data corruption riski var
- Güvenlik açığı keşfedildi
- Performans %50+ düştü
- Fix süresi > rollback süresi
❌ Rollback YAPMA
- Küçük UI bug (hotfix at)
- Test environment hatası (fix et)
- Non-critical warning (log'la, sonra fix)
🔄 Rollback Türleri
1. Git Rollback (Code)
A. git revert (Önerilen)
# Son commit'i geri al (yeni commit oluşturur)
git revert HEAD
# Belirli commit'i geri al
git revert abc123
# Merge commit'i geri al
git revert -m 1 abc123
# Push
git push origin main
Avantaj: Tarihçe bozulmaz, audit trail var.
B. git reset (Tehlikeli!)
# ⚠️ DİKKAT: Sadece local branch için!
# Son commit'i sil (değişiklikler staged kalır)
git reset --soft HEAD~1
# Son commit'i sil (değişiklikler working dir'de)
git reset --mixed HEAD~1
# Son commit'i sil (değişiklikler kaybolur)
git reset --hard HEAD~1
# Remote'a zorla push (ÇOOOOK TEHLİKELİ!)
git push --force origin main # ❌ ASLA main/master'da yapma!
Kural: git reset --hard sadece local branch'lerde!
C. git checkout (Geçici)
# Önceki commit'e geç (detached HEAD)
git checkout abc123
# Test et, sorun yoksa:
git checkout main
# Sorun varsa revert et:
git revert abc123..HEAD
2. Feature Rollback (feature-list.json)
# Feature durumunu değiştir
jq '.features[] | select(.id == "F005") | .status = "cancelled"' feature-list.json > tmp.json
mv tmp.json feature-list.json
# Feature'ı geri al (git diff ile bul)
git log --all --oneline --grep="F005"
git revert <commit-hash>
3. Database Rollback (Migration)
Prisma
# Son migration'ı geri al
npx prisma migrate resolve --rolled-back <migration-name>
# Veya manuel SQL
psql -d mydb -f migrations/down/20260126_rollback.sql
TypeORM
# Son migration'ı geri al
npm run migration:revert
# Birden fazla
npm run migration:revert
npm run migration:revert
Manual SQL
-- Rollback script örneği
BEGIN;
-- 1. Yeni kolonu sil
ALTER TABLE users DROP COLUMN new_column;
-- 2. Constraint'i geri koy
ALTER TABLE orders ADD CONSTRAINT fk_user FOREIGN KEY (user_id) REFERENCES users(id);
-- 3. Data'yı geri yükle (eğer backup varsa)
INSERT INTO users SELECT * FROM users_backup WHERE created_at > '2026-01-26';
-- Test et, sorun yoksa commit
COMMIT;
-- Sorun varsa: ROLLBACK;
4. CLAUDE.md Rollback
# CLAUDE.md'yi backup'tan geri yükle
cp .claude-backup/CLAUDE.md.2026-01-26 CLAUDE.md
# Veya git'ten geri al
git checkout HEAD~5 -- CLAUDE.md
🛡️ Safe Rollback Procedure
Adım adım güvenli rollback:
# 1. Backup al
git branch backup-before-rollback-$(date +%Y%m%d)
pg_dump mydb > backup-$(date +%Y%m%d).sql
cp CLAUDE.md CLAUDE.md.backup
# 2. Rollback yap
git revert HEAD
# veya
npm run migration:revert
# 3. Lokal test et
npm run test
npm run lint
npm run build
# 4. Staging'de test et
git push origin staging
# Smoke test yap
# 5. Production'a deploy
git push origin main
./deploy.sh
# 6. Health check
curl https://myapp.com/health/ready
# 7. Monitoring izle (5-10 dakika)
tail -f /var/log/app/error.log
# Sentry, Datadog kontrol et
# 8. Incident report yaz
# docs/incidents/2026-01-26-rollback.md
📦 Checkpoint Sistemi
Otomatik Checkpoint (Önerilen)
# PreToolUse hook'una ekle (settings.json)
{
"matcher": "Write|Edit",
"hooks": [{
"type": "command",
"command": "if git diff --quiet; then exit 0; fi; git add -A && git commit -m 'checkpoint: auto-save before changes' 2>/dev/null || true"
}]
}
Manuel Checkpoint
# Feature başlamadan önce checkpoint
git add -A
git commit -m "checkpoint: before F005 implementation"
git tag checkpoint-F005-start
# Feature bittikten sonra
git tag checkpoint-F005-complete
# Geri dönmek için
git checkout checkpoint-F005-start
🔥 Emergency Rollback (Production)
Scenario: Production çöktü, 2 dakikada geri al!
#!/bin/bash
# emergency-rollback.sh
set -e
echo "🚨 EMERGENCY ROLLBACK BAŞLIYOR..."
# 1. Son çalışan commit'i bul
LAST_WORKING_COMMIT=$(git log --oneline --grep="deploy: production" -1 --format="%H")
echo "📍 Geri dönülecek commit: $LAST_WORKING_COMMIT"
# 2. Revert yap
git revert HEAD --no-edit
# 3. Push
git push origin main
# 4. Deploy trigger
curl -X POST https://deploy.myapp.com/webhook
echo "✅ Rollback tamamlandı. Monitoring'i izleyin!"
echo "📊 Health: curl https://myapp.com/health/ready"
Kullanım:
chmod +x emergency-rollback.sh
./emergency-rollback.sh
📋 Rollback Checklist
Rollback öncesi:
- Backup aldın mı? (git branch, database dump)
- Rollback sebebi net mi?
- Stakeholder'lar bilgilendirildi mi?
- Rollback planı hazır mı?
- Test environment'ta denedin mi?
Rollback sonrası:
- Health check geçti mi?
- Error rate düştü mü?
- Monitoring normal mi?
- Data consistency kontrolü yapıldı mı?
- Incident report yazıldı mı?
- Post-mortem planlandı mı?
🧪 Rollback Test
Test script:
# test-rollback.sh
#!/bin/bash
echo "🧪 Rollback simulation başlıyor..."
# 1. Dummy feature ekle
echo "// Test feature" >> src/test.ts
git add src/test.ts
git commit -m "feat: test feature for rollback simulation"
# 2. Rollback yap
git revert HEAD --no-edit
# 3. Doğrula
if [ ! -f src/test.ts ]; then
echo "✅ Rollback başarılı"
exit 0
else
echo "❌ Rollback başarısız"
exit 1
fi
Her sprint sonunda rollback test et!
🗄️ Database Rollback Stratejileri
Blue-Green Migration
-- Eski tablo (blue)
CREATE TABLE users_v1 AS SELECT * FROM users;
-- Yeni tablo (green)
CREATE TABLE users_v2 (
id SERIAL PRIMARY KEY,
email TEXT,
new_column TEXT -- Yeni alan
);
-- Data migration
INSERT INTO users_v2 (id, email, new_column)
SELECT id, email, NULL FROM users_v1;
-- Switch (atomic rename)
BEGIN;
ALTER TABLE users RENAME TO users_old;
ALTER TABLE users_v2 RENAME TO users;
COMMIT;
-- Rollback gerekirse:
BEGIN;
ALTER TABLE users RENAME TO users_v2;
ALTER TABLE users_old RENAME TO users;
COMMIT;
📝 Rollback Documentation
Incident Report Template
# Incident Report: Rollback - [YYYY-MM-DD]
## Özet
Production'da kritik hata tespit edildi ve rollback yapıldı.
## Timeline
- **10:00** - Deploy (commit: abc123)
- **10:15** - Error rate spike (%5 → %30)
- **10:18** - Sentry alert
- **10:20** - Rollback decision
- **10:22** - Rollback complete
- **10:25** - System normal
## Root Cause
Database migration'da foreign key constraint eksikti.
## Rollback Details
- **Commit:** `git revert abc123`
- **Database:** `npm run migration:revert`
- **Duration:** 2 dakika
## Impact
- Affected users: ~500
- Downtime: 5 dakika
- Data loss: Yok
## Prevention
- [ ] Migration review process ekle
- [ ] Staging'de constraint test et
- [ ] Rollback drill yap (aylık)
## Post-Mortem
Tarih: 2026-01-27 14:00
Katılımcılar: Team lead, DevOps, Backend
🎓 Rollback Best Practices
DO ✅
- Hızlı karar ver - Rollback kararını 5 dakikada ver
- Backup her zaman - Rollback öncesi backup al
- Incremental rollback - Önce staging, sonra prod
- Monitoring izle - Rollback sonrası 30 dakika izle
- Documentation - Her rollback'i belgele
- Test rollback - Rollback prosedürünü test et
DON'T ❌
- Panic rollback - Planla, sonra rollback
- Partial rollback - Tam geri al veya hiç alma
- Silent rollback - Takımı bilgilendir
- Blame game - Rollback = başarısızlık değil
- Skip post-mortem - Neden oldu? Nasıl önlenir?
🔗 Related Skills
- error-recovery - Rollback gerekmeden fix et
- monitoring - Rollback ihtiyacını erkenden tespit et
- git-workflow - Safe branching strategy
📚 Kaynakları
- Git Revert vs Reset vs Checkout
- Database Migration Best Practices
- Site Reliability Engineering - Rollback Chapter
Son Güncelleme: 2026-01-26 Kullanıcı: devops-engineer, backend-developer agent'lar Kritiklik: HIGH - Production kurtarma mekanizması