Skip to Content
Tuan Tran
Platform Controllers & Operators

Bài 04 — Argo CD ApplicationSet & GitOps đa cluster

ApplicationSet generators, templating, triển khai đa cluster và bootstrap

Mục tiêu học tập

  • Kiến trúc hai vòng lặp reconciliation: Tách bạch việc ApplicationSet controller quản lý các Application CR khỏi việc Application controller reconcile manifest workload trên các cluster đích.
  • Lựa chọn generator và templating: Cấu hình các generator List, Git directory/file, Cluster, Matrix và Merge cùng Go template để tự động hóa onboarding đa môi trường và đa cluster.
  • Phân bổ đa cluster và tham số hóa Helm: Sử dụng label trên Secret đăng ký cluster để chọn cluster đích và file Helm values theo môi trường, đồng thời nắm cách ApplicationSet bổ trợ cho GKE Fleet.
  • Rủi ro mở rộng quy mô và ranh giới bảo mật: Kiểm soát phạm vi ảnh hưởng (blast radius) do tích Đề-các trong Matrix generator và thực thi nguyên tắc đặc quyền tối thiểu qua danh sách cho phép của AppProject, Kubernetes RBAC và bảo vệ repository.
  • Chính sách vòng đời, xóa và bảo toàn tài nguyên: Theo dõi các luồng xóa qua ownerReferences, finalizer của Argo CD, applicationsSync, preserveResourcesOnDeletion và ignoreApplicationDifferences để tránh xóa nhầm workload.

1. ApplicationSet bổ sung điều gì cho Argo CD?

Một Application của Argo CD mô tả một đơn vị triển khai duy nhất lên một cluster và namespace. Khi có nhiều microservice, môi trường hoặc cluster, việc viết tay hàng trăm Application dễ gây trùng lặp và sai lệch cấu hình. ApplicationSet là một Kubernetes custom resource có controller chuyên sinh ra các Argo CD Application từ template và dữ liệu đầu vào của generator.

flowchart TD
  A[ApplicationSet] --> B[Generator]
  B --> C[Template]
  C --> D[Application dev]
  C --> E[Application staging]
  C --> F[Application prod]
  D --> G[Argo CD App Controller]
  E --> G
  F --> G

Có hai vòng lặp reconciliation tách biệt: ApplicationSet controller quyết định những đối tượng Application nào cần tồn tại; còn Application controller quyết định những tài nguyên Kubernetes nào cần tồn tại cho từng Application.

Theo dõi một ApplicationSet qua quá trình reconciliation

Với 20 microservice và 2 cluster cho mỗi môi trường qua ba môi trường dev, staging và production, việc triển khai mọi dịch vụ lên mọi cluster sẽ tạo ra 120 Application CR. Một ApplicationSet duy nhất có thể sinh toàn bộ số CR đó từ các đầu vào đã phê duyệt và một template dùng chung.

Trách nhiệmApplicationSet controllerApplication controller
Desired stateCác Application được render từ tham số generator và templateCác manifest workload được render từ nguồn của từng Application
Observed stateCác đối tượng Application đã được sinh raCác tài nguyên được quản lý trên từng cluster đích
Thao tác ghiTạo, patch hoặc xóa Application CR theo chính sáchApply tài nguyên workload và prune khi thao tác sync cho phép
Tín hiệuCondition của ApplicationSet và spec của các Application được sinhRevision của Application, trạng thái sync, health và operation state

API server lưu trữ ApplicationSet và các Application được sinh dưới dạng tài nguyên Kubernetes. Controller quan sát tài nguyên cha cùng các nguồn generator của nó, tạo ra các bộ tham số, render template một lần cho mỗi bộ tham số và reconcile kết quả đó với các Application hiện có. Nó có thể tái dựng lại trạng thái này sau khi khởi động lại bằng cách đọc các đối tượng đã lưu và dữ liệu generator. Một ApplicationSet có thể sinh Application thành công trong khi workload của chúng vẫn ở trạng thái OutOfSync, Progressing hoặc không khỏe mạnh. ApplicationSet được tích hợp sẵn cùng Argo CD từ phiên bản 2.3. Tổng quan ApplicationSet

2. Các generator phổ biến

GeneratorNguồn dữ liệuTrường hợp sử dụng
ListDanh sách phần tử khai báo ngay trong manifestTập môi trường cố định
Git Directory/FileCác đường dẫn hoặc file trong GitOnboarding ứng dụng qua Git
ClusterCác Secret của những cluster đã đăng ký với Argo CDTriển khai đa cluster
MatrixTích Đề-các (Cartesian product) của các generatorỨng dụng × môi trường
MergeGộp tham số theo khóa mergeGiá trị mặc định + ghi đè
SCM/PRMetadata từ nhà cung cấp GitMôi trường preview được kiểm soát bằng chính sách phù hợp

Tự động phát hiện Application từ thư mục và file Git

Directory generator biến các đường dẫn khớp mẫu thành tham số. Khi bật Go templating, .path.basename là đoạn tên thư mục cuối cùng còn .path.path là đường dẫn đầy đủ khớp mẫu. Ở ví dụ này, apps/payment, apps/order và apps/inventory sẽ sinh ra ba Application riêng biệt. Hãy sử dụng độc lập ví dụ này và các ví dụ sau trừ khi các tài nguyên đích có quyền sở hữu tách biệt.

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: microservices
  namespace: argocd
spec:
  goTemplate: true
  goTemplateOptions: [missingkey=error]
  generators:
    - git:
        repoURL: https://github.com/example/gitops.git
        revision: main
        requeueAfterSeconds: 180
        directories:
          - path: apps/*
  template:
    metadata:
      name: '{{.path.basenameNormalized}}'
    spec:
      project: microservices
      source:
        repoURL: https://github.com/example/gitops.git
        targetRevision: main
        path: '{{.path.path}}'
      destination:
        server: https://kubernetes.default.svc
        namespace: '{{.path.basenameNormalized}}'
      syncPolicy:
        syncOptions:
          - CreateNamespace=true

Thêm thư mục apps/shipping có thể tạo ra một Application mới sau khi generator nhìn thấy commit. Với manifest này, việc sync workload vẫn là thủ công. Nếu bạn bật automated sync, việc thêm thư mục cũng có thể dẫn đến triển khai tự động. Thay vào đó, Git file generator đọc các file JSON hoặc YAML khớp mẫu và cung cấp các thuộc tính của chúng làm tham số. Dùng file generator khi quá trình onboarding đòi hỏi metadata tường minh như tên dịch vụ, môi trường hoặc đích triển khai được phê duyệt.

Chu kỳ poll mặc định của Git generator theo tài liệu là 3 phút và có thể ghi đè theo từng generator bằng requeueAfterSeconds. Cơ chế cache revision của repo-server có thể khiến thời gian phát hiện kéo dài hơn chu kỳ poll. Annotation argocd.argoproj.io/application-set-refresh có thể yêu cầu refresh bỏ qua lớp cache đó. ApplicationSet cũng có endpoint Git webhook riêng. Quá trình refresh Application và sync manifest chạy theo lịch riêng của chúng. Git generator polling, caching và webhooks

3. List generator kết hợp Go template

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: payment-environments
  namespace: argocd
spec:
  goTemplate: true
  goTemplateOptions: [missingkey=error]
  generators:
    - list:
        elements:
          - env: dev
            namespace: payment-dev
          - env: staging
            namespace: payment-staging
  template:
    metadata:
      name: 'payment-{{.env}}'
    spec:
      project: payment-team
      source:
        repoURL: https://github.com/example/payment-gitops.git
        targetRevision: main
        path: 'overlays/{{.env}}'
      destination:
        server: https://kubernetes.default.svc
        namespace: '{{.namespace}}'

Trên production, hãy kiểm tra chắc chắn AppProject cho phép các đích triển khai này. Template không thể vượt qua các giới hạn của project.

Liệt kê đích triển khai đa cluster tường minh

Ví dụ trước chọn các namespace trên cùng một cluster. Để chọn giữa nhiều cluster, hãy truyền tham số server cho từng đích đã đăng ký rồi đưa vào template. Lưu nội dung này thành một ApplicationSet khác. Repository và các endpoint chỉ là giá trị giữ chỗ, và AppProject payment-team phải cho phép chúng.

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: payment-clusters
  namespace: argocd
spec:
  goTemplate: true
  goTemplateOptions: [missingkey=error]
  generators:
    - list:
        elements:
          - {cluster: dev, server: "https://dev.example.com"}
          - {cluster: prod, server: "https://prod.example.com"}
  template:
    metadata:
      name: 'payment-{{.cluster}}'
    spec:
      project: payment-team
      source:
        repoURL: https://github.com/example/payment-gitops.git
        targetRevision: main
        path: apps/payment
      destination:
        server: '{{.server}}'
        namespace: payment

Cấu hình này render ra payment-dev và payment-prod. Thêm phần tử staging sẽ đưa payment-staging vào tập mong muốn. Việc đăng ký cluster và cấp quyền truy cập vẫn là các bước tách biệt. List generator

4. Triển khai đa cluster

Giả sử gke-dev, gke-staging và gke-prod đã được đăng ký. Cluster generator của ApplicationSet có thể chọn các bản ghi cluster theo label và sinh ra các Application với đích tương ứng. Cách này điều phối quá trình triển khai, nhưng không tự động đảm bảo mạng (networking), IAM hay database migration sẽ vận hành trơn tru trên nhiều cluster.

Git repository
  ├── base/
  └── overlays/
      ├── dev/
      ├── staging/
      └── prod/

Hãy dùng image digest bất biến trên production và yêu cầu review trước khi promote, để một commit duy nhất vào main không vô tình thay đổi hàng loạt cluster cùng lúc.

Chọn Helm values bằng label đăng ký cluster

Một Secret đăng ký cluster trong namespace argocd có thể mang các label như gitops-managed=true, environment=prod và label vùng như region=asia-southeast1. Cluster generator cung cấp các tham số gồm name, nameNormalized, server và metadata.labels. Đó là thuộc tính của bản đăng ký trong Argo CD, độc lập với label của node hay tư cách thành viên fleet. Cluster cục bộ ngầm định (implicit local cluster) thường không có registration Secret, nên selector yêu cầu label trên Secret sẽ loại trừ nó trừ khi bạn khai báo và gắn label cho nó một cách tường minh. Cluster generator

Kiểm tra các bản đăng ký mà không làm lộ thông tin xác thực:

argocd cluster list
kubectl -n argocd get secrets -l argocd.argoproj.io/secret-type=cluster --show-labels

Đăng ký các cluster đích trong lab trước. Gắn hai label mẫu lên từng Secret dự định chọn, đặt giá trị environment phù hợp cho từng bản đăng ký. Một bản đăng ký production mới khớp điều kiện có thể lập tức thêm một Application ngay sau khi reconcile.

Bản đăng kýLabel môi trườngSố replicaImage tag
gke-devdev1v1.3.0
gke-stagingstaging2v1.3.0
gke-prodprod5v1.2.0

Dùng một chart chung và chọn đúng một file values cho mỗi Application được sinh:

gitops/
├── charts/payment-service/
│   ├── Chart.yaml
│   ├── values.yaml
│   └── templates/
│       ├── deployment.yaml
│       └── service.yaml
├── values/payment-service/
│   ├── dev.yaml
│   ├── staging.yaml
│   └── prod.yaml
└── applicationsets/payment-service.yaml

Ví dụ, file values/payment-service/prod.yaml có nội dung:

replicaCount: 5
image:
  repository: registry.example.com/payment
  tag: v1.2.0

Tạo các file tương đương cho dev và staging dựa theo bảng trên. Registry và tag chỉ mang tính minh họa. Hãy dùng một image có thể truy cập được và một chart đọc các khóa này. Nếu bạn dùng chart mẫu của cẩm nang làm điểm khởi đầu, hãy giữ lại các giá trị mặc định bắt buộc của nó. Xem trước bản render production ở máy cục bộ bằng helm template payment ./charts/payment-service -f ./values/payment-service/prod.yaml. Xem hướng dẫn Helm để tham khảo ví dụ chart đầy đủ.

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: payment-multicluster
  namespace: argocd
spec:
  goTemplate: true
  goTemplateOptions: [missingkey=error]
  generators:
    - clusters:
        selector:
          matchLabels:
            gitops-managed: "true"
          matchExpressions:
            - key: environment
              operator: In
              values: [dev, staging, prod]
  template:
    metadata:
      name: 'payment-{{.nameNormalized}}'
    spec:
      project: payment-team
      source:
        repoURL: https://github.com/example/gitops.git
        targetRevision: main
        path: charts/payment-service
        helm:
          valueFiles:
            - '../../values/payment-service/{{index .metadata.labels "environment"}}.yaml'
      destination:
        server: '{{.server}}'
        namespace: payment
      syncPolicy:
        automated:
          prune: false
          selfHeal: true
        syncOptions:
          - CreateNamespace=true

Selector đảm bảo label môi trường nằm trong ba giá trị được hỗ trợ. Đường dẫn được tính tương đối so với thư mục chart trong cùng Git repository. Với gke-prod, controller tạo payment-gke-prod sử dụng ../../values/payment-service/prod.yaml, endpoint API production đã đăng ký và namespace payment. Application controller yêu cầu render Helm, tạo ra một Deployment có 5 replica và image tag v1.2.0. Sau đó nó apply các manifest đã render theo sync policy của Application được sinh. AppProject payment-team phải cho phép repository cùng các đích triển khai, và thông tin xác thực đích phải có đủ quyền ghi. Argo CD Helm values

Chẩn đoán vòng lặp reconciliation nào sẽ hành động

Thay đổiController và kết quả kỳ vọng
Đổi replicaCount thành 8 trong prod.yamlApplication controller phát hiện revision nguồn mới và Deployment đã render mới. Spec của Application vẫn có thể giữ nguyên.
Đăng ký và gắn label cho gke-prod-2ApplicationSet thêm một Application mong muốn. Application controller xử lý đích mới.
Sửa thủ công namespace của một Application đã sinhApplicationSet có thể khôi phục giá trị template nếu được phép cập nhật và trường đó tham gia so sánh. Application controller có thể quan sát đích tạm thời đó, nên tránh thử nghiệm này trên production.
Scale trực tiếp Deployment ở cluster đíchApplication controller có thể phát hiện drift và tự phục hồi (self-heal) nếu được cấu hình.
Loại một cluster khỏi đầu ra generatorApplicationSet xử lý Application lỗi thời theo chính sách hiệu lực. Kiểm tra finalizer trước khi gỡ các label khớp điều kiện.

Kiểm tra condition của ApplicationSet trước tiên khi thiếu một cluster trong tập mong muốn. Nếu Application đã tồn tại với đúng nguồn và đích, hãy kiểm tra status, lỗi render và operation state của nó. Bài lab GitOps thực hành

kubectl -n argocd get applicationset payment-multicluster -o yaml
kubectl -n argocd get application payment-gke-prod \
  -o jsonpath='{.spec.destination.server}{"\n"}{.spec.source.helm.valueFiles[0]}{"\n"}'
argocd app get payment-gke-prod
argocd app manifests payment-gke-prod

Spec được sinh phải trỏ đúng tới endpoint production và file prod.yaml. Kiểm tra spec thành công xác nhận ApplicationSet đã phân bổ vị trí đúng. Xác minh số replica và image sau khi render, rồi đọc trạng thái Deployment và rollout trên cluster đích để xác nhận bàn giao hoàn tất.

5. Matrix generator và rủi ro mở rộng quy mô

Matrix có thể sinh ra services × environments. Với 100 dịch vụ và 4 môi trường, nó tạo ra 400 Application. Điều này làm tăng lưu lượng lên Kubernetes API, tải render trên repo-server và tải xử lý của controller. Hãy lập kế hoạch mở rộng ngay từ đầu: tính đến quyền sở hữu Application, tần suất reconciliation, caching, giới hạn tài nguyên và phân quyền người dùng.

Kết hợp dịch vụ với các bản đăng ký cluster đủ điều kiện

Matrix generator kết hợp tham số từ hai generator con. Với 2 thư mục ứng dụng và 3 cluster được chọn, kết quả kỳ vọng là:

ClusterCác Application được sinh
gke-devpayment-gke-dev, order-gke-dev
gke-stagingpayment-gke-staging, order-gke-staging
gke-prodpayment-gke-prod, order-gke-prod

Dưới đây là ví dụ hoàn chỉnh cho các thư mục chứa manifest có thể render được. Giả định AppProject multi-cluster-apps cho phép nguồn và tất cả các đích được chọn.

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: services-by-cluster
  namespace: argocd
spec:
  goTemplate: true
  goTemplateOptions: [missingkey=error]
  generators:
    - matrix:
        generators:
          - git:
              repoURL: https://github.com/example/gitops.git
              revision: main
              directories:
                - path: matrix-apps/*
          - clusters:
              selector:
                matchLabels:
                  gitops-managed: "true"
  template:
    metadata:
      name: '{{.path.basenameNormalized}}-{{.nameNormalized}}'
    spec:
      project: multi-cluster-apps
      source:
        repoURL: https://github.com/example/gitops.git
        targetRevision: main
        path: '{{.path.path}}'
      destination:
        server: '{{.server}}'
        namespace: '{{.path.basenameNormalized}}'
      syncPolicy:
        syncOptions:
          - CreateNamespace=true

Kiểm tra các tên đã chuẩn hóa (normalized names) để tránh trùng lặp. Matrix mở rộng mọi tổ hợp do hai generator con cung cấp. Trong ví dụ này, label của cluster quyết định tư cách tham gia, nên mọi thư mục khớp mẫu đều nhắm vào mọi cluster được chọn. Khi điều kiện tham gia phụ thuộc vào từng ứng dụng, hãy tách thành các ApplicationSet riêng hoặc dùng tham số từ generator con thứ nhất để ràng buộc cluster selector của generator con thứ hai. Ví dụ, môi trường được phê duyệt trong một file Git có thể điều khiển bộ lọc label cluster. Cách này yêu cầu generator con sinh tham số phải chạy trước. Nếu cả hai generator con đều là Git generator và phát ra các tham số đường dẫn khác nhau, hãy dùng pathParamPrefix để đặt tên phân biệt cho đầu ra của chúng. Matrix generator

Sử dụng trình mô phỏng Matrix generator để kiểm tra tên và số lượng Application mong muốn trước khi bước vào bài lab.

6. Bảo mật cho ApplicationSet

Nếu một nhóm có thể sửa đổi đầu vào hoặc template của một ApplicationSet có đặc quyền cao, họ có thể chi phối nguồn nào được triển khai và triển khai đi đâu. Không cho phép các nhóm không tin cậy chỉnh sửa project: default hoặc các đích do đội nền tảng quản lý nếu cấu hình cấp quyền phạm vi toàn cluster. Hãy sử dụng AppProject, bảo vệ nhánh Git (branch protection), RBAC và kiểm soát quyền sở hữu repository.

7. Dọn dẹp, pruning và nguy cơ xóa nhầm

Khi đầu vào generator thay đổi, ApplicationSet controller có thể xác định một Application không còn cần thiết nữa. Hãy nắm vững chuỗi quyền sở hữu và các chính sách như applicationsSync cùng cơ chế bảo toàn tài nguyên để tránh xóa nhầm. Rà soát chính sách lưu giữ và finalizer, đặc biệt với PVC, Secret và hạ tầng đám mây.

Phân biệt quyền sở hữu spec được sinh và theo dõi workload

Các Application được sinh có mục ownerReferences trỏ tới ApplicationSet. Bộ thu gom rác (garbage collection) của Kubernetes có thể dựa vào mối quan hệ đó khi tài nguyên cha bị xóa. Cơ chế theo dõi workload của Application và finalizer xóa Application thuộc về Argo CD, kể cả khi workload nằm trên cluster khác. managedFields của Kubernetes SSA lại theo dõi riêng API manager nào sở hữu các trường trên từng đối tượng.

Mọi thay đổi spec lâu dài cần thực hiện trong template hoặc đầu vào generator. Đối với ngoại lệ có chủ đích, hãy giới hạn ignoreApplicationDifferences cho đúng một Application được sinh cụ thể. Ví dụ sau cho phép tạm thời thay đổi cấu hình automated sync trên production:

spec:
  ignoreApplicationDifferences:
    - name: payment-gke-prod
      jsonPointers:
        - /spec/syncPolicy/automated

Quy tắc bỏ qua của ApplicationSet so sánh các Application CR được sinh. Quy tắc ignoreDifferences của Application so sánh các tài nguyên workload. ApplicationSet sử dụng JSON Merge Patch để cập nhật Application. Nếu một ngoại lệ nhắm vào một phần tử trong spec.sources, thay đổi ở một nguồn cùng cấp có thể khiến toàn bộ danh sách bị thay thế và chỉnh sửa được bỏ qua sẽ bị mất. Chính sách chỉnh sửa và quy tắc bỏ qua của ApplicationSet

Theo dõi ba luồng xóa riêng biệt

Sự kiệnTác nhânĐiều gì có thể biến mất
Một cluster hoặc thư mục không còn khớp generatorApplicationSet controllerCác Application lỗi thời nếu chính sách cho phép xóa. Một Application có Argo CD resources finalizer sau đó có thể xóa luôn workload của nó.
ApplicationSet cha bị xóa theo kiểu cascading deletionKubernetes garbage collector, sau đó là Argo CD với các Application finalizerCác Application được sinh qua ownerReferences và có khả năng cả workload của chúng.
Một manifest biến mất khỏi nguồn của Application hiện cóArgo CD Application controller trong lúc pruneTài nguyên đang được theo dõi, khi thao tác sync cho phép prune. Bản thân Application vẫn có thể tồn tại.
spec:
  syncPolicy:
    applicationsSync: create-update
    preserveResourcesOnDeletion: true

Các tùy chọn này thuộc sync policy của ApplicationSet cha. Các thiết lập automated sync và prune của Application được sinh nằm dưới spec.template.spec.syncPolicy. Chính sách của tài nguyên cha chi phối các thao tác ghi khi reconcile:

Chính sách hiệu lựcTạo (Create)Cập nhật (Update)Xóa Application lỗi thời
syncCóCóCó
create-onlyCóKhôngKhông
create-updateCóCóKhông
create-deleteCóKhôngCó

Chính sách ở cấp controller có thể được ưu tiên hơn. Quyền ghi đè chính sách theo từng ApplicationSet mặc định bị tắt trong cấu hình tài liệu và phải do quản trị viên nền tảng bật lên. Bản thân chính sách tạo/cập nhật hiệu lực không tự ngăn Kubernetes garbage collection xóa các Application thuộc sở hữu khi tài nguyên cha bị xóa.

preserveResourcesOnDeletion: true ngăn ApplicationSet gắn finalizer xóa workload. Nó không giữ lại Application CR và cũng không ngăn một lần sync thực hiện prune workload. Hãy kiểm tra finalizer trên các Application hiện có trước khi tin cậy vào cơ chế bảo toàn. Khi ngừng sử dụng một ApplicationSet nhưng muốn giữ lại các Application đã sinh, thao tác xóa tài nguyên cha không lan truyền (non-cascading) bằng --cascade=orphan sẽ giữ lại các CR con. Một CR mồ côi vẫn có thể còn mang Argo CD deletion finalizer, nên hãy kiểm tra nó trước khi xóa về sau. Chỉ tắt automated prune thôi không bảo vệ được workload khi Application bị xóa. Chính sách chỉnh sửa tài nguyên · Pruning và xóa tài nguyên Application

Kết nối việc phân bổ triển khai với GKE Fleet

Khía cạnhGKE FleetArgo CD ApplicationSet
Tư cách thành viên nhómCác đăng ký fleet membershipĐầu vào generator, bao gồm các bản đăng ký cluster trong Argo CD
Cấu hình dùng chung cho clusterCó thể dùng Config Sync và các tính năng bật theo fleet khácSinh ra các Application workload từ template chung
Quyền truy cập triển khaiCác tích hợp Fleet có mô hình danh tính và truy cập riêngApplication controller cần thông tin xác thực API đích và quyền từ AppProject

Đăng ký vào Fleet không tự động đưa cluster vào Argo CD. Một nền tảng có thể dùng Fleet để phân nhóm và quan sát, dùng Config Sync cho cấu hình dùng chung và dùng ApplicationSet để phân bổ workload. Hãy thống nhất quyền sở hữu cho Namespace, RBAC và các policy để các bộ reconcile riêng biệt không cạnh tranh lẫn nhau. Xem thêm Argo CD, Config Sync và Quản lý GKE Fleet.

8. Bài lab

  1. Tạo hai Kustomize overlay: dev và staging.
  2. Apply ApplicationSet dùng List generator và kiểm tra các Application được sinh bằng kubectl get applications -n argocd.
  3. Thêm một môi trường mới và quan sát Application mới được sinh ra.
  4. Gỡ bỏ một môi trường và xác định rõ chính sách tài nguyên cùng vòng đời trước khi thực sự thử nghiệm xóa.
  5. Xác minh rằng AppProject từ chối một namespace nằm ngoài phạm vi cho phép.

Tài liệu: ApplicationSet · Generators · Bảo mật.

Phân tích chuyên sâu: ApplicationSet controller, generators và phạm vi ảnh hưởng (blast radius)

ApplicationSet sinh ra các Application CR từ template và dữ liệu generator; sau đó Application controller sẽ reconcile từng Application. ApplicationSet không thay thế argocd-application-controller. Hãy tách bạch hai vòng lặp này:

flowchart LR
  subgraph Loop1["Vòng lặp ApplicationSet"]
    Gen["Trạng thái Generator"] --> AppSet["Reconciliation của ApplicationSet"]
    AppSet --> GenApps["Các Application được sinh"]
  end
  subgraph Loop2["Vòng lặp Application"]
    GenApps --> AppCtrl["Reconciliation của Argo CD Application"]
    AppCtrl --> K8sRes["Tài nguyên Kubernetes"]
  end

Chọn đúng loại generator

GeneratorKhi nào nên dùngRủi ro
ListDanh sách nhỏ, tường minhPhải cập nhật thủ công
Git directory/fileMỗi thư mục hoặc file đại diện cho một môi trườngQuyền trên nhánh và repository quyết định phạm vi triển khai
ClusterTriển khai tới các cluster được chọn theo labelSửa trái phép label của cluster Secret có thể mở rộng tập đích
MatrixKết hợp nhiều tập đầu vàoTích Đề-các có thể sinh ra quá nhiều Application
MergeKết hợp cấu hình theo khóaCấu hình chồng chéo đòi hỏi nắm rõ thứ tự ưu tiên
Pull RequestMôi trường previewPull request từ nguồn không tin cậy có thể làm tăng rủi ro

Ví dụ: đặt tên Application nhất quán

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: tenant-apps
  namespace: argocd
spec:
  goTemplate: true
  goTemplateOptions: ["missingkey=error"]
  generators:
    - list:
        elements:
          - {name: payment, namespace: payments}
          - {name: order, namespace: orders}
  template:
    metadata:
      name: '{{.name}}-app'
    spec:
      project: platform-tenant
      source:
        repoURL: https://github.com/example/cluster-gitops.git
        targetRevision: main
        path: 'apps/{{.name}}'
      destination:
        server: https://kubernetes.default.svc
        namespace: '{{.namespace}}'

Trước khi apply manifest này, hãy kiểm tra rằng AppProject platform-tenant đã tồn tại, repository truy cập được, namespace cùng phân quyền đều phù hợp, và ApplicationSet controller đã được cài đặt. Đây là template ví dụ; URL chỉ mang tính minh họa.

Rủi ro khi thay đổi đầu vào generator

Giả sử một thư mục Git bị xóa. Generator ngừng sinh Application tương ứng, nên ApplicationSet controller sẽ xử lý Application không còn trong tập mong muốn đó theo chính sách xóa và thiết lập owner-reference đã cấu hình. Nếu Application có finalizer resources-finalizer.argocd.argoproj.io, việc xóa có thể lan truyền xuống các tài nguyên trong cluster tùy theo cách Application bị xóa. Hãy thiết kế hành vi này thật cẩn thận khi có liên quan đến PVC hoặc tài nguyên đám mây bên ngoài.

Thông tin xác thực đa cluster và nguyên tắc đặc quyền tối thiểu

Cluster Secret và thông tin xác thực trong Argo CD quyết định thao tác API nào được phép thực hiện. Tên cluster trong một Application không phải là ranh giới bảo mật; Kubernetes RBAC và danh sách đích cho phép (destination allowlist) của AppProject mới là các lớp kiểm soát thực sự. Hãy bảo vệ mọi danh tính có quyền chỉnh sửa template hoặc generator của ApplicationSet thuộc project đặc quyền cao như một danh tính đặc quyền.

Bài lab và thử nghiệm tiêm lỗi (failure injection)

  1. Dùng List generator với hai namespace trên một cluster thử nghiệm để tạo hai Application.
  2. Xác minh tên được sinh, AppProject và các đích triển khai.
  3. Thêm phần tử thứ ba và quan sát ApplicationSet controller tạo Application mới.
  4. Trước khi gỡ bỏ một phần tử, xác nhận chính sách chỉnh sửa hiệu lực của ApplicationSet và kiểm tra finalizer trên Application được sinh. Thử nghiệm bảo toàn hoặc xóa trên môi trường dùng một lần không có dữ liệu bền vững.
  5. Thay đổi label cluster trong lab để kiểm tra phạm vi tác động của Cluster generator. Xác minh các nhóm thông thường không thể sửa những label làm thay đổi đích triển khai.

Nguồn kiểm chứng: Giới thiệu ApplicationSet, ApplicationSet generators, Argo CD Projects.

Tóm tắt và các khái niệm liên quan

  • Tách bạch desired state khỏi observed state và xác định rõ chủ sở hữu của từng trường hoặc tài nguyên.
  • Không giả định rằng một thao tác API thành công đồng nghĩa hệ thống bên ngoài đã sẵn sàng phục vụ yêu cầu.
  • Kiểm tra IAM và RBAC, readiness, vòng đời dữ liệu và quy trình khôi phục trước khi đưa thiết lập này lên production.

Kiểm tra mức độ hiểu bài với bài trắc nghiệm ApplicationSet. Sau đó, theo dõi hành trình của một image digest qua CI, dev, staging và lần sync production được phê duyệt trong Thiết kế GitOps Repository và Promote giữa các môi trường. Khi production theo dõi một nhánh main chung có thể thay đổi, bất kỳ commit được duyệt nào làm thay đổi manifest đã render đều có thể bị auto-sync áp dụng. Hãy dùng đầu vào production được review riêng, cố định (pin) artifact đã duyệt và chọn chiến lược revision phù hợp với quy trình phê duyệt thay đổi trên production.

Quay lại Lộ trình học tập

On this page