Runbook phát hành và xử lý sự cố sau deploy
Bài trước bạn đã có checklist để bấm deploy. Nhưng checklist chỉ giúp bạn bấm đúng, nó không giúp bạn lúc mọi thứ vỡ sau khi bấm. Bài này nói về thứ tôi luôn đòi xem trước khi cho ai deploy: runbook và cách xử lý sự cố ngay sau deploy.
Sau bài này, bạn sẽ:
- Viết được runbook một trang gồm ba phần: người phụ trách, tín hiệu bất thường, bước xử lý.
- Đặt ngưỡng số cho từng tín hiệu thay vì viết "theo dõi lỗi".
- Chọn đúng hành động khi deploy vỡ: tắt feature flag, rollback, hay hotfix.
- Chuẩn bị sẵn lệnh rollback copy-paste được cho project của mình.
Runbook một trang: ai làm gì khi có sự cố
Runbook không phải tài liệu kiến trúc. Nó là tờ giấy một trang mà người trực đọc được lúc 2 giờ sáng, khi mắt mỏi và tay run. Nếu một dòng trong đó không trả lời được "vậy ai làm việc này?", hãy xoá dòng đó.
Ba phần bắt buộc:
| Vai trò | Trách nhiệm | Ghi tên ai (tên thật) |
|---|---|---|
| Release owner | Quyết định deploy tiếp, tắt flag hay rollback | |
| Người on-call | Người đầu tiên xem tín hiệu và báo động | |
| Người duyệt rollback | Đồng ý khi rollback ảnh hưởng dữ liệu | |
| Người thông báo | Báo nội bộ hoặc khách hàng khi có sự cố |
Điền tên thật, kèm kênh liên lạc (số điện thoại, kênh chat). Runbook không có tên người là runbook chưa tồn tại.
Bài tập 1. Mở file runbook của project bạn đang làm, viết ba dòng đầu: release owner là ai, on-call là ai, ai có quyền bấm rollback. Thời hạn: 3 phút.
Tín hiệu bất thường phải có ngưỡng số
"Deploy xong thì theo dõi lỗi" là câu vô nghĩa. Theo dõi cái gì, ở đâu, vượt bao nhiêu thì gọi là bất thường? Mỗi tín hiệu cần hai thứ: một con số và một nơi xem được.
In this lesson
- Khi deploy có vấn đề: thứ tự hành động
- Mẫu runbook điền vào là xong
- Mang gì sang buổi go-live
About this course
Part of Ra mắt an toàn cho app vibe-code: staging, smoke test và rollback — Xây một quy trình phát hành an toàn cho app do AI viết: biết kiểm tra gì trước khi deploy, phát hiện lỗi ngay sau khi lên production và quay lại phiên bản cũ trong vài phút.
- Level
- Beginner
- Goal
- Build a project
- Language
- Vietnamese
- Focus
- tách môi trường và biến môi trường smoke test sau deploy feature flag và rollback kiểm thử E2E cơ bản
- Prior knowledge
- Đã từng đưa một app web lên hosting hoặc VPS, Biết dùng terminal và Git ở mức cơ bản
- Practice
- Guided exercises
- Time
- ~3.1h
- Voice
- một release engineer khó tính, luôn hỏi 'nếu bước này hỏng thì rollback thế nào' trước khi cho phép bấm deploy
- Not covered
- Unit test chuyên sâu và TDD, CI/CD nâng cao với self-hosted runner, Load test và đo hiệu năng
This lesson is premium content. Sign in and purchase the course to view the full content. Sign in