🚀 ArgoCD & GitOps

GitOps đổi câu hỏi từ "làm sao đẩy thay đổi lên cluster" sang "làm sao giữ cluster luôn khớp với Git". Khác biệt nghe nhỏ nhưng thay đổi mọi thứ: rollback thành git revert, audit thành git log, và không ai cần credential ghi vào production.

Mười mục: nguyên lý GitOps (1) → kiến trúc ArgoCD (2) → Application (3) → App of Apps và ApplicationSet (4) → sync policy (5) → sync wave và hook (6) → rollback và khôi phục (7) → nhiều môi trường (8) → bảo mật (9) → checklist (10).

Nguyên lý GitOps

Bốn nguyên tắc: trạng thái mong muốn được khai báo; nó được version hoá trong Git; thay đổi được kéo tự động vào hệ thống; và một agent liên tục điều chỉnh thực tế về khớp với khai báo.

Push so với Pull — khác biệt cốt lõi

Push (CI tự deploy)Pull (GitOps)
Ai khởi độngCI gọi kubectl/helm vào cluster Agent trong cluster tự kéo từ Git
CredentialCI phải giữ credential ghi vào production CI chỉ cần quyền ghi một repo Git. Không credential cluster nào ra ngoài.
MạngCI phải tới được API server (thường phải mở đường vào VPC) Chỉ cần cluster ra được Git. API server có thể hoàn toàn private.
Sai lệch thủ côngKhông phát hiện. Ai sửa bằng kubectl thì nó tồn tại tới lần deploy sau. Phát hiện trong vài giây và tự kéo về nếu bật self-heal.
RollbackChạy lại job cũ — mà job cũ có thể không còn tái lập được git revert. Luôn tái lập được.
AuditLog CI, bị xoá theo retention git log — vĩnh viễn, có review, có người phê duyệt
Dựng lại clusterChạy lại hàng chục job theo đúng thứ tự Trỏ agent vào repo, cluster tự dựng lại

Vòng lặp điều chỉnh của ArgoCD

        ┌──────────────────────────────────────────┐
        │                                          │
        ▼                                          │
 1. Đọc Git (mỗi 3 phút, hoặc ngay khi có webhook) │
        │                                          │
        ▼                                          │
 2. Render manifest (helm template / kustomize)    │
        │                                          │
        ▼                                          │
 3. So với trạng thái THẬT trong cluster           │
        │                                          │
        ├── Khớp     → Synced, không làm gì ────────┤
        │                                          │
        └── Lệch     → OutOfSync                   │
                 │                                 │
                 ├── automated: tự apply ──────────┤
                 └── manual: chờ người bấm ────────┘

Hai trạng thái độc lập — đừng nhầm

Trạng tháiNghĩa là gìVí dụ dễ nhầm
Sync status
Synced / OutOfSync
Manifest trong cluster có khớp với Git hay không Synced nhưng mọi pod CrashLoopBackOff: manifest đúng y như Git, chỉ là ứng dụng lỗi.
Health status
Healthy / Degraded / Progressing
Tài nguyên có đang hoạt động tốt hay không Healthy nhưng OutOfSync: app chạy tốt, nhưng ai đó vừa commit thay đổi chưa được sync.
Cặp trạng thái bạn muốn thấy là Synced + Healthy. Mọi tổ hợp khác đều cần xem:
  • OutOfSync + Healthy → có thay đổi chờ sync, hoặc có sai lệch thủ công
  • Synced + Degraded → manifest đúng nhưng app lỗi. Vấn đề ở ứng dụng, không ở GitOps. Quay lại chặng 04, mục 9.
  • Synced + Progressing kéo dài → rollout bị kẹt, thường do probe fail hoặc không đủ tài nguyên để xếp pod mới

Những gì phải nằm trong Git, và những gì không

Nằm trong GitKHÔNG nằm trong Git
  • Mọi manifest Kubernetes
  • Helm values theo môi trường
  • Image tag (git SHA)
  • Số replica, resource, probe
  • Tham chiếu tới secret (ExternalSecret)
  • Định nghĩa ArgoCD Application
  • Cấu hình hạ tầng trong cluster (Prometheus, cert-manager)
  • Giá trị secret thật → Secrets Manager
  • Dữ liệu người dùng
  • Số replica nếu đang do HPA/KEDA điều khiển (xem mục 5)
  • Thứ do controller sinh ra (ReplicaSet, Endpoints, Secret do ESO tạo)
  • Trạng thái runtime
Application báo Synced nhưng mọi pod CrashLoopBackOff. Nghĩa là gì?
◀ Chặng trước06 · CI/CD với Jenkins Chặng tiếp theo ▶08 · AWS cho EKS