Cấu trúc buổi học

GitOps là gì?

Git là single source of truth cho trạng thái mong muốn, và một controller liên tục đối chiếu trạng thái thực tế của cluster với Git rồi tự hội tụ về đúng trạng thái đó.

Bốn nguyên tắc

Push-based vs Pull-based

Mạnh, yếu & cách kết hợp

Reconciliation & Drift

Các thành phần ArgoCD

Application — mổ xẻ

spec:
  project: mention-mate            # thuộc AppProject nào (RBAC, repo/dest cho phép)
  sources:                         # multi-source — CẢ HAI cùng repo, cùng main
    - repoURL: .../gitops-training
      path: helm-charts/app        # 1 base chart duy nhất, không version
      targetRevision: main
      helm: {valueFiles: [$values/apps/.../values.yaml]}
    - repoURL: .../gitops-training
      targetRevision: main           # bắt buộc cùng main: $values không trỏ revision khác
      ref: values
  destination: {namespace: mention-mate-dev}
  syncPolicy: {automated: {prune: true, selfHeal: true}}

AppProject

• Whitelist sourceRepos — repo nào được phép làm nguồn
• Whitelist destinations — cặp cluster + namespace được deploy
• Whitelist loại tài nguyên: clusterResourceWhitelist / namespaceResourceWhitelist

Sync Waves & Hooks

Health vs Sync status

App of Apps

Một Application "cha" trỏ tới thư mục chứa các manifest con. Sync cha → tạo/cập nhật loạt con. Là pattern, không có CRD riêng.

ApplicationSet

CRD + controller sinh Application từ template theo generator (động, theo dữ liệu).

generators: [ ... ]      # nguồn dữ liệu sinh app
template:                  # khuôn Application, nội suy {{...}}
  metadata: {name: '{{.project}}-{{.app}}-{{.env}}'}

Các generator chính

App of Apps vs ApplicationSet

Chọn cái nào?

Hai trường phái

Directory vs Branch

Mỗi cái hợp với gì

Directory-based + 2 tier theo cluster

gitops-training · single branch

Một lệnh apply / cluster

Bootstrap chain (mỗi tier)

1 chart cho mọi app

components:
  backend:
    image: {repository: ..., tag: ...}
    port: 80
    httpRoute: {enabled: true}
  worker:                # không port → chỉ Deployment
    image: {repository: ...}

Dựng cluster & cài ArgoCD

# 1) Cluster (lab: kind; production: EKS/GKE/AKS/kubeadm)
kind create cluster --name gitops-nonprod
kubectl get nodes

# 2) Cài ArgoCD (≥ 3.1 cho native OCI Helm; lab pin 3.3.x)
kubectl create namespace argocd
kubectl apply -n argocd -f .../argo-cd/v3.3.0/manifests/install.yaml
kubectl -n argocd rollout status deploy/argocd-server

# mật khẩu admin ban đầu
argocd admin initial-password -n argocd

Đăng ký repo & deploy root

# repo gitops-training PUBLIC → clone không cần creds. Chỉ thêm OCI kgateway:
argocd repo add cr.kgateway.dev/kgateway-dev/charts --type helm --enable-oci

# 1 lệnh tay / cluster → cả chain tự sinh
kubectl apply -f root-nonproduction.yaml      # cluster nonprod
kubectl apply -f root-production.yaml          # cluster prod
argocd app list      # 6 app nonprod: <project>-<app>-<env>

Trục trặc bootstrap hay gặp

App đa môi trường

# overlays/dev/values.yaml
components:
  app:
    image: {repository: traefik/whoami}
    replicaCount: 1
    port: 80
    httpRoute:
      enabled: true
      hostnames: [...-dev.duongot.work]

Nhiều Deployment trong 1 app

Promotion & Drift / Self-heal

# overlays/prod/values.yaml
components.app.replicaCount:
  3 → 5
git commit -am "promote" && git push

kubectl -n birdnet-market-dev scale \
  deploy ...-frontend-dev-app --replicas=5
# OutOfSync → ArgoCD tự về 1 replica

Sealed Secrets

# secret-name = <release>-secret = {project}-{app}-{env}-secret
./scripts/seal.sh mention-mate-dev mention-mate-app-dev-secret DB_PASSWORD=...
# dán encryptedData vào values.yaml; đặt sealedSecret.enabled: true

Tự làm sau buổi học

1. Fork repo, sửa repoURL khớp; bootstrap cả 2 tier (6 app nonprod, 3 app prod).
2. Thêm env uat cho frontend: tạo overlay + thêm path vào directories của appset → app birdnet-market-frontend-uat tự sinh.
3. Thêm deployment scheduler vào mention-mate/app: thêm khoá vào components (không sửa base chart).
4. Thêm app mới pipeline cho birdnet-market → appset tự quét.
5. (Nâng cao) Thêm project notification: app + appproject + per-project appset → tự sinh ở cả 2 tier.