Claude cho Engineering: Deploy checklist tự động

Một deploy thất bại có thể gây ra hậu quả nghiêm trọng: downtime, mất dữ liệu, hoặc tệ hơn là lỗi bảo mật âm thầm. Checklist trước khi deploy không phải là thủ tục hành chính mà là lưới an toàn cuối cùng. Claude có thể tạo checklist deploy tùy chỉnh cho từng tình huống cụ thể của bạn — từ release routine đến migration database phức tạp — và update theo đặc thù stack của team.

Tại sao cần deploy checklist?

Theo nghiên cứu ngành, phần lớn sự cố production bắt nguồn từ quy trình deploy không chuẩn: quên chạy migration, chưa update feature flag, hoặc không notify team on-call. Checklist giải quyết vấn đề "tôi chắc mình đã làm rồi" — đặc biệt quan trọng khi deploy lúc 11 giờ đêm sau sprint nước rút.

• Ngăn chặn lỗi "tôi quên mất" trong các deploy routine
• Đảm bảo nhất quán giữa các team members
• Tài liệu hóa rollback plan trước khi deploy
• Giảm anxiety khi deploy — mọi thứ đều được check

Ba phase trong deploy checklist

Phase 1: Pre-Deploy

Kiểm tra trước khi bắt đầu deploy:

• Tất cả tests passing trong CI
• Code đã được review và approve
• Không có critical bug đã biết trong release
• Database migration đã được test (nếu có)
• Feature flags đã được configure (nếu dùng)
• Rollback plan đã được document
• Team on-call đã được notify

Phase 2: Deploy

• Deploy lên staging và verify
• Chạy smoke tests
• Deploy lên production (canary nếu có)
• Monitor error rates và latency 15 phút
• Verify các user flows quan trọng

Phase 3: Post-Deploy

• Confirm metrics bình thường
• Update release notes / changelog
• Notify stakeholders
• Close các tickets liên quan

Prompt mẫu: Checklist deploy cơ bản

Tạo deploy checklist cho release v2.3.0 của service
payment-api:

Stack: Node.js, PostgreSQL, Redis, deploy trên AWS ECS
Thay đổi trong release này:
- Thêm endpoint mới /api/payments/recurring
- Refactor validation logic
- Update Stripe SDK từ v9 lên v10

Team on-call: Minh (Slack: @minh.nguyen)
Deploy time: Thứ 4, 10 giờ sáng

Hãy tạo checklist đầy đủ với rollback triggers.

Prompt mẫu: Checklist cho database migration

Tôi cần deploy release có database migration quan trọng.
Hãy tạo checklist chi tiết hơn thường lệ:

Migration:
- Thêm cột phone_verified (boolean) vào bảng users
- Backfill 2 triệu rows hiện có (set = false)
- Thêm index trên (user_id, phone_verified)

Database: PostgreSQL 14, 2M rows trong bảng users
Có thể dùng zero-downtime migration không?
Migration script đã được test trên staging với 500K rows.

Tôi cần checklist bao gồm cả rollback procedure nếu migration fail.

Prompt mẫu: Checklist cho breaking API change

Release này có breaking change trong API v1:
- Deprecated endpoint /api/v1/users/profile sẽ bị remove
- Thay bằng /api/v2/users/profile với format response khác

Consumers biết trước: 3 mobile apps (iOS, Android, React Native)
Thời gian migration: 2 tuần đã pass

Hãy tạo checklist với các bước verify consumers
đã migrate, cách xử lý nếu vẫn còn traffic đến v1,
và communication plan.

Ví dụ checklist Claude tạo ra

## Deploy Checklist: payment-api v2.3.0
Date: 2026-03-20 | Deployer: Minh Nguyen

### Pre-Deploy
- [ ] CI pipeline green (link: https://ci.example.com/...)
- [ ] PR #234 approved bởi senior reviewer
- [ ] Stripe SDK v10 compatibility test passed
- [ ] Staging deploy successful lúc 9h sáng
- [ ] Không có open P0/P1 bugs cho release này
- [ ] On-call Minh đã sẵn sàng (Slack: @minh.nguyen)
- [ ] Rollback plan: git revert + redeploy 15 phút

### Deploy Steps
- [ ] Notify #engineering: "Bắt đầu deploy payment-api v2.3.0"
- [ ] ECS: Update task definition với image mới
- [ ] Wait: Rolling deployment hoàn thành (est. 5 phút)
- [ ] Smoke test: GET /health trả về 200
- [ ] Smoke test: POST /api/payments/recurring (test account)
- [ ] Monitor Datadog dashboard 15 phút:
  - [ ] Error rate < 0.1%
  - [ ] P99 latency < 500ms
  - [ ] Stripe webhook events processing bình thường

### Post-Deploy
- [ ] Notify #engineering: "payment-api v2.3.0 deployed"
- [ ] Update CHANGELOG.md
- [ ] Close tickets: JIRA-456, JIRA-457
- [ ] Notify product team

### Rollback Triggers (deploy lại v2.2.1 ngay nếu)
- Error rate vuot 1% trong 5 phút
- P99 latency > 2 giây
- Stripe payment failure rate tăng bất thường
- Bất kỳ complaint nào từ merchants

Tùy chỉnh checklist theo stack của team

Một lần nói với Claude về stack và quy trình của bạn, nó sẽ nhớ và tạo checklist phù hợp:

Đây là thông tin về deploy process của chúng tôi,
hãy dùng khi tạo checklist trong tương lai:

Infrastructure: Kubernetes trên GCP
CI/CD: GitHub Actions + ArgoCD
Monitoring: Grafana + Prometheus
Database: MongoDB Atlas
Feature flags: LaunchDarkly
Deployment strategy: Blue-green
On-call: Rotation 2 tuần, hiện tại là Nam

Chúng tôi luôn deploy vào giờ thấp điểm (9-11 sáng)
và cần verify trên 5 critical user flows sau mỗi deploy.

Checklist cho hotfix khẩn cấp

Cần deploy hotfix gấp cho lỗi critical đang ảnh hưởng
đến checkout flow. Đây là tình huống P0.

Fix: 3 dòng code, chỉ sửa null check trong cart service
Đã test locally, không có thời gian test staging

Hãy tạo checklist hotfix rút gọn với minimum steps
nhưng vẫn đảm bảo an toàn. Highlight những gì có thể
skip trong tình huống khẩn cấp và những gì KHÔNG bao giờ được skip.

Rollback triggers: Quyết định trước, thực hiện sau

Phần quan trọng nhất mà nhiều team bỏ qua: định nghĩa rollback triggers trước khi deploy, không phải trong lúc đang stress với incident. Claude giúp bạn thiết lập ngưỡng cụ thể:

Giúp tôi định nghĩa rollback triggers cho service
order-processing. Baseline metrics hiện tại:
- Error rate: 0.05%
- P50 latency: 120ms
- P99 latency: 450ms
- Throughput: 200 TPS

Đây là service quan trọng nhất, revenue trực tiếp.
Rollback trigger nên là gì?

Mẹo dùng checklist hiệu quả

• Chạy trước mỗi deploy: Kể cả deploy "routine". Checklist ngăn sự cố kiểu "chắc không cần check".
• Customize một lần, dùng mãi: Một khi đã mô tả stack và process, Claude nhớ để tạo checklist tương lai.
• Quyết định rollback trước: Xác định khi nào rollback trước khi deploy, không phải khi đang panic.
• Archive checklist đã dùng: Lưu checklist đã hoàn thành vào PR description hoặc release note như audit trail.

Bước tiếp theo

Checklist deploy là một phần của quy trình release management toàn diện:

• Thư viện ứng dụng Claude cho Engineering
• Kết hợp với Incident Response workflow khi deploy gây ra sự cố
• Dùng Architecture workflow để document các quyết định về deployment strategy

Bài viết liên quan

• Claude cho Engineering: Incident Response workflow
• Claude cho Engineering: Standup và báo cáo tiến độ
• Claude cho Engineering: System Design interviews và planning
• Context Engineering — Nghệ thuật quản lý context cho Claude
• Context Compaction — Tự động nén context cho conversations dài