VNPT

CI/CD Integration and Deployment (Stage 5: Deploy)

Thực thi Claude Code không tương tác (non-interactively) trong CI/CD pipeline, sandbox môi trường chạy an toàn, expose công cụ triển khai qua MCP và diễn tập rollback path trước khi cần đến

Bài gốc: Anthropic Claude Academy reference/ai-native-sdlc/course/12-ci-cd-integration-and-deployment.md 2026-09-16 ~7 phút đọc

1. Những thay đổi: CI/CD Pipeline

Trong pipeline truyền thống, các pipeline thực thi deterministic scripts và mọi bước cần phán đoán (incident triage (phân loại và cô lập sự cố sản xuất), xử lý test flaky, viết changelog, tìm nguyên nhân lỗi build) đều phải dừng lại chờ con người. Quy trình triển khai và rollback là các runbook mà kỹ sư phải thực hiện thủ công dưới áp lực sự cố.

Trong AI-Native SDLC, Claude Code chạy không tương tác (non-interactively với claude -p) trong pipeline cho các bước phán đoán, được cô lập trong sandbox với scoped credentials. Công cụ triển khai được expose cho agent qua MCP, nhờ đó workflow vừa lập trình và kiểm thử thay đổi cũng có thể tự ship và rollback trong phạm vi các cổng (gates) mà tổ chức quy định theo từng môi trường.

Ý chính

Pipeline kết hợp deterministic scripts cho kiểm tra cứng và Claude Code non-interactive cho các bước phán đoán. Thao tác deploy và rollback quản lý qua MCP tools, phân tầng quyền theo môi trường.

Khía cạnh CI/CD truyền thống AI-Native CI/CD Pipeline
Xử lý lỗi Build/Test Dừng pipeline, gửi alert; kỹ sư đọc log thủ công để tìm nguyên nhân và phân loại flaky test. claude -p phân tích log không tương tác, phân biệt lỗi flaky hay lỗi thực, tóm tắt nguyên nhân trực tiếp lên PR thread.
Soạn thảo Changelog Kỹ sư tổng hợp commit logs thủ công trước khi release. Agent tự động tổng hợp changelog dựa trên các PR đã merge và commit history.
Quyền Triển khai Lưu credential tĩnh trong CI secrets; rủi ro rò rỉ khi lộ pipeline runner. Expose qua MCP tools với short-lived scoped tokens và audit trail phân tách danh tính.
Quy trình Rollback Runbook thủ công mà con người phải làm theo dưới áp lực cao; dễ sai sót. Rollback là lệnh đơn qua MCP, được diễn tập thường xuyên trên staging và kích hoạt tức thì khi vi phạm control bands.

2. Sơ đồ Canary Deployment & Rollback Gate

Quy trình triển khai áp dụng cơ chế canary deployment (triển khai thử nghiệm trên tỷ lệ nhỏ lưu lượng thực tế, ví dụ 5%) kết hợp rollback gate (chốt chặn tự động revert khi vượt ngưỡng lỗi):

  • Agent chuẩn bị release và đóng gói artifact trong sandbox container, mở PR.
  • Production Deploy Hook chặn lại chờ release manager phê duyệt trước khi phát hành.
  • Triển khai canary 5% lưu lượng và giám sát Telemetry Metrics theo control bands (dải chỉ số giới hạn vận hành như CPU, tỷ lệ lỗi, độ trễ).
  • Tự động promote lên 100% nếu metrics ổn định, hoặc kích hoạt rollback gate (chốt chặn tự động revert khi vượt ngưỡng lỗi) phục hồi tức thì nếu vi phạm control bands (dải chỉ số giới hạn vận hành như CPU, tỷ lệ lỗi, độ trễ).
Sơ đồ tương tác: Canary Deployment & Rollback Gate Mở toàn màn hình ↗

3. Bắt đầu: Điều kiện tiên quyết & Sandbox

Trước khi kích hoạt agent trong pipeline CI/CD, hệ thống cần đáp ứng các điều kiện tiên quyết về hạ tầng và thiết lập sandbox an toàn:

  • Prerequisites (Điều kiện tiên quyết): Đã tích hợp AI vào PR review loop và thiết lập hooks làm approval gates, vì các cổng kiểm soát phải tồn tại trước khi tự động hóa đẩy nhanh tốc độ luồng công việc qua chúng.
  • Infrastructure (Hạ tầng kỹ thuật):
    • Nền tảng CI có cài đặt claude-code-action, hoặc bất kỳ runner nào có thể gọi claude -p.
    • Truy cập mô hình qua API, hoặc Amazon Bedrock, Microsoft Foundry, Google Cloud Vertex AI khi lưu lượng mạng bắt buộc phải nằm trong thỏa thuận điện toán đám mây của tổ chức.
    • Các MCP servers cho các môi trường đích triển khai.
    • Sandbox profile cho các agent job, đảm bảo không nắm giữ production credentials tĩnh.
Môi trường thực thi Sandbox & Scoped Tokens

Các job của agent chạy trong container cách ly với network policy nghiêm ngặt, sử dụng short-lived scoped tokens và theo mặc định không nắm giữ bất kỳ production credentials nào.

4. Các bước thực thi

Quy trình thực thi của Agent trong pipeline CI/CD tuân thủ lộ trình phân định rõ ràng giữa các tác vụ chỉ đọc, tác vụ ghi sau gate, sandbox, kiểm soát qua MCP và phân tầng quyền tự chủ theo môi trường:

1

Bắt đầu bằng các bước phán đoán chỉ đọc (Read-only judgment steps)

Kỹ sư platform bắt đầu bằng việc chạy claude -p trong pipeline job để thực hiện incident triage (phân loại và cô lập sự cố sản xuất) cho build thất bại, tóm tắt flaky test, hoặc dự thảo changelog.

read-only incident triage
2

Thêm các bước ghi sau Gate (Write steps behind existing gates)

Áp dụng cho các công việc như sửa lỗi lint, cập nhật tài liệu sinh tự động, hoặc phản hồi review comment thông qua lượt nhắc @claude. Mọi nội dung agent tạo ra đều đi qua Pull Request dưới sự bảo vệ của branch protection; agent không có đường dẫn (no route) để push trực tiếp lên main.

write-steps branch protection
3

Thực thi trong Sandbox (Sandboxed execution)

Các job của agent chạy trong container cách ly với network policy nghiêm ngặt, sử dụng short-lived scoped tokens và theo mặc định không nắm giữ bất kỳ production credentials nào.

sandbox scoped tokens
4

Expose công cụ triển khai qua MCP (Expose deployment through MCP)

Thay vì cung cấp một shell script chứa credentials với phạm vi quyền hạn rộng, toàn bộ năng lực triển khai được expose cho agent dưới dạng allowlist MCP tools định phạm vi (scoped) theo từng môi trường:

  • deploy(target_env, image_tag, traffic_percentage): Triển khai phiên bản với tỷ lệ phân luồng xác định.
  • status(target_env): Truy vấn tình trạng pod, health check và độ trễ.
  • rollback(target_env, reason): Phục hồi tức thì về phiên bản ổn định trước đó.
mcp allowlist
5

Phân tầng quyền tự chủ theo môi trường (Tier the autonomy by environment)

Mức độ tự chủ của Agent được phân cấp rõ ràng theo môi trường:

  • Development: Triển khai tự do (deploys freely), tự thực hiện build, deploy, test và dọn dẹp mà không cần phê duyệt thủ công.
  • Staging: Bán tự động, agent tự động triển khai sau khi PR được merge vào main; chạy test tích hợp mở rộng và diễn tập quy trình rollback định kỳ.
  • Production: Hard gate phê duyệt. Agent chỉ chuẩn bị bản phát hành (prepares the release), release manager đích danh ủy quyền (authorizes it), và production deploy hook tự động cưỡng chế chốt chặn.
dev / staging / prod governance

5. Cấu hình mẫu CI/CD Pipeline

Dưới đây là cấu hình pipeline step thực thi chẩn đoán lỗi build tự động bằng claude -p khi có failure trong CI workflow:

- name: Triage failed build
  if: failure()
  run: >
    claude -p "Read the build log at out/build.log. Identify the most
    likely cause, say whether the failure looks flaky or real, and write a
    three-line summary for the PR thread." >> triage.md

Trong cấu hình này:

  • Điều kiện if: failure() kích hoạt tác vụ chỉ khi các bước build hoặc test phía trước gặp sự cố.
  • Lệnh claude -p nhận input là đường dẫn log build (out/build.log), phân loại nguyên nhân là lỗi flaky hay lỗi thực tế, và xuất tóm tắt ngắn gọn vào triage.md để gắn vào PR comment.
  • Kỹ sư nhận được báo cáo incident triage (phân loại và cô lập sự cố sản xuất) ngay trong luồng công việc mà không phải đọc log thủ công.

6. Diễn tập Rollback Gate & Đóng chu trình

Rollback phải là đường dẫn được diễn tập kỹ lưỡng nhất trong toàn bộ pipeline: một lệnh duy nhất mà agent có thể thực thi và được chạy thử nghiệm đều đặn trên staging.

Rehearsed Rollback Contract

Lệnh rollback qua MCP là thao tác đơn lệnh, được kiểm tra định kỳ trên staging. Khi chuyển sang giai đoạn vận hành bảo trì (Stage 6: Maintain - Closing the loop), hệ thống sẽ gọi rollback gate (chốt chặn tự động revert khi vượt ngưỡng lỗi) này ngay khi vi phạm control bands (dải chỉ số giới hạn vận hành như CPU, tỷ lệ lỗi, độ trễ). Do đó, đường dẫn rollback bắt buộc phải được chứng minh độ tin cậy từ trước.

7. Kiểm soát & Chỉ số DORA

Nguyên tắc quản trị cốt lõi là agent được phép hành động tự động cho đến trước production gate và không được tự ý vượt qua cổng này. Ba cơ chế kiểm soát bên dưới thực thi nguyên tắc này:

  • Branch protection: Chuyển mọi nội dung agent ghi thành Pull Request, không có đường dẫn trực tiếp để push vào main.
  • Production deploy hook: Chặn release cho đến khi release manager đích danh phê duyệt. Mỗi phiên chạy không tương tác hoạt động dưới danh tính riêng của agent, phân tách rõ log giữa hành động của agent và kỹ sư kích hoạt.
  • Per-environment permission tiers: Thiết lập các tầng quyền hạn quy định mức độ agent được phép thực hiện trên đường tiến tới gate.

Đo lường hiệu quả

Đo lường hiệu quả CI/CD qua leading indicator và bộ chỉ số tiêu chuẩn DORA do hệ thống CI và công cụ triển khai phát ra:

Loại chỉ số Chỉ số kỹ thuật Cách tính & Nguồn dữ liệu Mục tiêu & Tác động
Leading Indicator Tỷ lệ incident triage tự động trong CI Tỷ lệ lỗi pipeline (build/test failure) được claude -p phân loại tự động (incident triage (phân loại và cô lập sự cố sản xuất)) mà không cần page kỹ sư con người (trích xuất từ CI/CD logs). Đạt > 75%, giảm tải trực tiếp thời gian trực pipeline cho đội ngũ platform.
Lagging Indicator (DORA) Deployment Frequency Tần suất phát hành thành công ra production hoặc staging. Tăng từ chu kỳ hàng tuần lên nhiều lần mỗi ngày nhờ cơ chế canary deployment (triển khai thử nghiệm trên tỷ lệ nhỏ lưu lượng thực tế, ví dụ 5%) tự động.
Lagging Indicator (DORA) Lead Time for Changes Thời gian từ commit đầu tiên đến khi chạy ổn định trên production. Rút ngắn đáng kể nhờ loại bỏ độ trễ chờ đợi thủ công trong review và incident triage (phân loại và cô lập sự cố sản xuất).
Lagging Indicator (DORA) Time to Restore Service (MTTR) Thời gian khôi phục dịch vụ khi môi trường production gặp sự cố. Giảm xuống dưới 2 phút nhờ rollback gate (chốt chặn tự động revert khi vượt ngưỡng lỗi) tự động kích hoạt ngay khi vi phạm control bands (dải chỉ số giới hạn vận hành như CPU, tỷ lệ lỗi, độ trễ).