Thuật Ngữ ArgoCD: Hướng Dẫn Nhanh Cho Developer

Đọc Docs ArgoCD — Bị Ngợp Vì Thuật Ngữ?

Bắt đầu với ArgoCD dễ. Cài, kết nối Git repo, chỉ Helm chart hoặc Kubernetes manifest, xong. Nhưng khi đi sâu hơn — đọc docs, cấu hình multi-cluster, debug sync — mới thấy thuật ngữ xuất hiện dày đặc. Application, Sync, Refresh, Health, Source, Destination... mỗi cái một nghĩa.

Đây không phải vấn đề lớn nếu có thời gian đọc hết docs. Nhưng nếu cần debug nhanh hoặc review PR cấu hình ArgoCD — việc nắm rõ thuật ngữ giúp tiết kiệm rất nhiều thời gian.

10 Thuật Ngữ Cần Nắm

Application

Đơn vị cơ bản nhất. Mỗi Ứng dụng đại diện cho một ứng dụng Kubernetes đang được quản lý bởi ArgoCD. Gồm: source (Git repo + path), destination (cluster + namespace), sync policy.

Source

Nơi chứa cấu hình Kubernetes — Git repo, Helm chart repo, hoặc OCI registry. ArgoCD theo dõi source để phát hiện thay đổi.

Sync

Quá trình ArgoCD đưa trạng thái actual (trên cluster) về trạng thái desired (trong Git). Sync = "cập nhật cluster theo Git". Nếu Git có version mới → sync = deploy.

Refresh

ArgoCD kiểm tra Git repo xem có commit mới không. Refresh ≠ sync. Refresh chỉ "nhìn", sync mới "làm".

Health

Trạng thái của tài nguyên trên cluster — Healthy, Degraded, Progressing, Unknown. ArgoCD dùng health để quyết định sync có thành công không.

Destination

Cluster và namespace mà Ứng dụng deploy tới. Mỗi Ứng dụng chỉ deploy vào một destination duy nhất.

Sync Policy

Cách ArgoCD tự động sync. Có thể là manual (phải click), automatic (tự sync khi phát hiện thay đổi), hoặc pruning (tự xóa tài nguyên không còn trong Git).

Pruning

Tự động xóa tài nguyên đã bị xóa khỏi Git repo. Ví dụ: xóa file deployment.yaml trong Git → pruning sẽ xóa deployment tương ứng trên cluster.

Rollback

Quay lại phiên bản trước đó. ArgoCD lưu lịch sử sync, có thể rollback bất cứ lúc nào. Giống git revert nhưng cho Kubernetes deployment.

ApplicationSet

Template tạo nhiều Ứng dụng cùng lúc. Thay vì tạo 10 Ứng dụng thủ công cho 10 service — ApplicationSet tạo tự động từ list cluster, namespace, hoặc Git paths.

Kết Luận

Thuật ngữ ArgoCD không khó, nhưng nếu không nắm rõ sẽ rất dễ bị lạc khi đọc docs hoặc debug. Lưu lại danh sách này, mỗi lần gặp thuật ngữ mới — tra thêm và ghi chú. Kiến thức nhỏ, nhưng tích lũy sẽ giúp làm việc với GitOps hiệu quả hơn rất nhiều.