Runbooks Manifest Index
AI Agent Instructions
Vai trò của thư mục này: /irp/runbooks/ chứa các Runbook — tài liệu kỹ thuật chi tiết với các bước thực thi cụ thể, CLI commands, điều kiện kiểm tra (verification) và phương án rollback.
Khi nào cần đọc file này:
- Playbook đã xác định action cần làm và chỉ định tên Runbook cụ thể.
- SRE on-call cần tra cứu nhanh thủ tục kỹ thuật đã được chuẩn hóa.
- AI agent hỗ trợ thực thi: trích xuất commands từ Runbook để suggest cho engineer.
Quy tắc đọc Runbook:
- Kiểm tra section "Điều kiện sử dụng (When to use)" trước — xác nhận đúng scenario.
- Thực thi tuần tự từng bước trong "Các bước thực hiện".
- Sau mỗi bước quan trọng, thực hiện "Quy trình xác minh (Verification Steps)".
- Nếu verification fail → chuyển ngay sang "Phương án rollback".
Lưu ý: Runbook chứa commands thực thi thực tế — AI agent không được tự động chạy mà chỉ được suggest. Mọi thực thi phải có engineer xác nhận (Human-in-the-Loop).
Danh Mục Runbooks
| Runbook Document | Description | Owner | Status | Tags |
|---|---|---|---|---|
| /irp/runbooks/example.md | Khởi động lại pods payment-gateway an toàn và xác minh trạng thái phục hồi sau khi restart. | payments-sre | approved | payments, k8s, recovery |
| /irp/runbooks/restart-database.mdx | Khởi động lại an toàn PostgreSQL Primary của payment-gateway: drain PgBouncer, graceful restart, xác minh replica. | sre-team | approved | database, postgresql, pgbouncer, restart |