Bộ sưu tập Helm Charts dành cho các dự án Argo được cộng đồng phát triển và duy trì, với tên gọi Argo Helm, cung cấp các công cụ cần thiết để triển khai hiệu quả các thành phần như Argo CD, Argo Workflows, Argo Events và Argo Rollouts trên nền tảng Kubernetes. Các công cụ này đóng vai trò quan trọng trong việc tự động hóa quá trình phân phối liên tục, quản lý luồng công việc, xử lý sự kiện và triển khai từng bước trong môi trường Kubernetes. Vì chủ yếu tập trung vào việc định nghĩa tài nguyên Kubernetes và cấu hình Helm Charts, YAML là ngôn ngữ chính được sử dụng trong dự án Argo Helm.

1. Sự cố cài đặt Định nghĩa Tài nguyên Tùy chỉnh (CRD)

Khi mới bắt đầu với Argo Helm Charts, người dùng thường gặp phải tình trạng các Định nghĩa Tài nguyên Tùy chỉnh (CRD) không thể cài đặt thành công. Điều này xảy ra do những hạn chế cố hữu của Helm trong việc quản lý CRD, đặc biệt là khi nâng cấp chúng.

Các bước khắc phục:

1. Xác minh phiên bản Helm: Đảm bảo rằng phiên bản Helm đang dùng có khả năng hỗ trợ việc cài đặt CRD. Phiên bản Helm 3.2.0 trở lên thường được khuyến nghị.
2. Cài đặt CRD thủ công: Trong trường hợp Helm không thể tự động cài đặt CRD, bạn có thể thực hiện việc này một cách thủ công. Sử dụng lệnh kubectl apply để áp dụng các CRD trực tiếp từ thư mục manifests của dự án Argo tương ứng:

   kubectl apply -k "https://github.com/argoproj/argo-cd/manifests/crds?ref=<phiên_bản_ứng_dụng>"
   

   Ví dụ, để cài đặt CRD cho Argo CD với phiên bản cụ thể:

   kubectl apply -k "https://github.com/argoproj/argo-cd/manifests/crds?ref=v2.4.9"
   

3. Ngừng tính năng cài đặt CRD của Helm: Một phương pháp khác là vô hiệu hóa chức năng cài đặt CRD của Helm trong quá trình triển khai Chart. Bạn có thể làm điều này bằng cách thêm cờ --set crds.install=false vào lệnh helm install:

   helm install argo-cd argo/argo-cd --set crds.install=false
   

2. Chart Helm không tương thích với phiên bản Kubernetes

Một thách thức phổ biến khác mà người dùng mới gặp phải là sự không tương thích giữa phiên bản Helm Chart và phiên bản của cụm Kubernetes hiện tại, dẫn đến việc các tài nguyên không thể được triển khai hoặc hoạt động không chính xác.

Các bước khắc phục:

1. Xác định phiên bản Kubernetes: Kiểm tra phiên bản Kubernetes của cụm bằng lệnh sau:

   kubectl version --short
   

2. Lựa chọn phiên bản Chart phù hợp: Dựa trên phiên bản Kubernetes của bạn, hãy tìm kiếm và chọn một phiên bản Helm Chart tương thích. Thông tin về khả năng tương thích thường được cung cấp trên trang Releases của dự án Argo Helm.
3. Sử dụng tham số --kube-version: Khi thực hiện lệnh cài đặt Helm Chart, bạn có thể chỉ định phiên bản Kubernetes mục tiêu bằng cách sử dụng tùy chọn --kube-version:

   helm install argo-cd argo/argo-cd --kube-version=<phiên_bản_Kubernetes>
   

3. Vấn đề về quyền hạn trong quá trình cài đặt

Trong quá trình triển khai Helm Chart, người dùng mới có thể gặp phải các lỗi liên quan đến việc thiếu quyền, đặc biệt khi làm việc với các vùng tên (namespace) tùy chỉnh trong Kubernetes.

Các bước khắc phục:

1. Kiểm tra quyền hạn hiện tại: Đảm bảo rằng tài khoản người dùng Kubernetes hoặc tài khoản dịch vụ (ServiceAccount) mà bạn đang sử dụng có đủ quyền để tạo và quản lý các tài nguyên. Bạn có thể xác minh quyền bằng lệnh sau:

   kubectl auth can-i create deployments --namespace=<tên_vùng_tên>
   

2. Sử dụng tài khoản có quyền quản trị: Nếu phát hiện thiếu quyền, bạn có thể thực hiện cài đặt bằng một tài khoản có quyền quản trị. Cụ thể, bạn có thể gán vai trò cluster-admin cho người dùng của mình:

   kubectl create clusterrolebinding admin-role-binding --clusterrole=cluster-admin --user=<tên_người_dùng>
   

3. Chỉ định vùng tên chính xác: Khi cài đặt Helm Chart, luôn đảm bảo bạn đã chỉ định đúng vùng tên nơi các tài nguyên sẽ được triển khai:

   helm install argo-cd argo/argo-cd --namespace=<tên_vùng_tên>