GitOps 운영 흐름:

개발자                 Git 리포지토리           ArgoCD            Kubernetes
  │                        │                     │                   │
  │── git commit ─────────▶│                     │                   │
  │   (image tag 변경)      │                     │                   │
  │                        │── 폴링 (60초마다) ──▶│                   │
  │                        │                     │── 차이 감지       │
  │                        │                     │── kubectl apply ─▶│
  │                        │                     │                   │
  │                        │       (누군가 직접 kubectl edit 실행)    │
  │                        │                     │◀── 드리프트 감지  │
  │                        │                     │── selfHeal ──────▶│
  │                        │                     │   (Git 상태로 복원)│

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: payment-service
  namespace: argocd            # Application 객체는 argocd 네임스페이스에 생성
  labels:
    environment: production
    team: backend
spec:
  project: default

  # 소스: Git 리포지토리에서 읽을 매니페스트
  source:
    repoURL: https://github.com/myorg/k8s-manifests.git
    targetRevision: main        # 브랜치, 태그, 커밋 SHA 모두 가능
    path: apps/payment/production  # 리포지토리 내 경로

  # 목적지: 어느 클러스터, 어느 네임스페이스에 배포할지
  destination:
    server: https://kubernetes.default.svc   # 현재 클러스터
    namespace: production

  # 동기화 정책
  syncPolicy:
    automated:
      prune: true       # Git에서 삭제된 리소스 자동 제거
      selfHeal: true    # 수동 변경 감지 시 자동 복원
    syncOptions:
      - CreateNamespace=true   # 네임스페이스 없으면 자동 생성
      - PrunePropagationPolicy=foreground  # 종속 리소스 먼저 삭제
      - RespectIgnoreDifferences=true
    retry:
      limit: 5          # 실패 시 재시도 횟수
      backoff:
        duration: 5s
        factor: 2
        maxDuration: 3m

  # 비교 시 무시할 필드 (Kubernetes 자동 추가 필드)
  ignoreDifferences:
    - group: apps
      kind: Deployment
      jsonPointers:
        - /spec/replicas   # HPA가 레플리카를 변경해도 OutOfSync로 표시 안 함

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: nginx-ingress
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://kubernetes.github.io/ingress-nginx
    chart: ingress-nginx
    targetRevision: 4.8.3      # Chart 버전 고정
    helm:
      releaseName: ingress-nginx
      values: |                # 인라인 values (또는 valuesFiles 사용)
        controller:
          replicaCount: 2
          service:
            type: LoadBalancer
          metrics:
            enabled: true
  destination:
    server: https://kubernetes.default.svc
    namespace: ingress-nginx
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

# CLI 로그인
argocd login localhost:8080 \
  --username admin \
  --password $(kubectl -n argocd get secret argocd-initial-admin-secret \
    -o jsonpath='{.data.password}' | base64 -d) \
  --insecure

# Application 목록
argocd app list

# 특정 Application 상태 확인
argocd app get payment-service

# 수동 동기화 (즉시 반영)
argocd app sync payment-service

# 특정 커밋으로 동기화 (rollback)
argocd app sync payment-service --revision abc1234

# Git과 클러스터 차이 확인
argocd app diff payment-service

# 롤백 (이전 성공 배포로)
argocd app rollback payment-service

# Application 삭제 (리소스도 함께 삭제)
argocd app delete payment-service --cascade

# 환경 목록 기반 ApplicationSet
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: payment-service-all-envs
  namespace: argocd
spec:
  generators:
    # List 생성기: 환경 목록을 직접 정의
    - list:
        elements:
          - environment: dev
            cluster: https://dev-cluster.example.com
            namespace: payment-dev
            replicaCount: "1"
            imageTag: latest
          - environment: staging
            cluster: https://staging-cluster.example.com
            namespace: payment-staging
            replicaCount: "2"
            imageTag: "{{ .values.stagingTag }}"
          - environment: production
            cluster: https://prod-cluster.example.com
            namespace: payment-production
            replicaCount: "5"
            imageTag: "1.2.3"

  template:
    metadata:
      name: "payment-{{ environment }}"    # 각 환경별 Application 이름
      labels:
        environment: "{{ environment }}"
    spec:
      project: default
      source:
        repoURL: https://github.com/myorg/k8s-manifests.git
        targetRevision: main
        path: "apps/payment/{{ environment }}"
        helm:
          parameters:
            - name: replicaCount
              value: "{{ replicaCount }}"
            - name: image.tag
              value: "{{ imageTag }}"
      destination:
        server: "{{ cluster }}"
        namespace: "{{ namespace }}"
      syncPolicy:
        automated:
          prune: true
          selfHeal: true
        syncOptions:
          - CreateNamespace=true

# ApplicationSet 적용 후 생성된 Application 확인
kubectl apply -f applicationset.yaml -n argocd
argocd app list | grep payment
# NAME                  CLUSTER                            NAMESPACE
# payment-dev           https://dev-cluster.example.com    payment-dev
# payment-staging       https://staging-cluster.example.com payment-staging
# payment-production    https://prod-cluster.example.com   payment-production

# apps/ 디렉토리의 각 서브디렉토리를 자동으로 Application으로 생성
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: all-apps
  namespace: argocd
spec:
  generators:
    - git:
        repoURL: https://github.com/myorg/k8s-manifests.git
        revision: main
        directories:
          - path: "apps/*/production"  # apps/payment/production, apps/order/production 등
  template:
    metadata:
      name: "{{ path.basenameNormalized }}"
    spec:
      project: default
      source:
        repoURL: https://github.com/myorg/k8s-manifests.git
        targetRevision: main
        path: "{{ path }}"
      destination:
        server: https://kubernetes.default.svc
        namespace: production
      syncPolicy:
        automated:
          prune: true
          selfHeal: true

# DB 마이그레이션 Job (wave: -1 → 앱보다 먼저 실행)
apiVersion: batch/v1
kind: Job
metadata:
  name: db-migration
  annotations:
    argocd.argoproj.io/hook: Sync          # Sync 단계에서 실행
    argocd.argoproj.io/hook-delete-policy: BeforeHookCreation
    argocd.argoproj.io/sync-wave: "-1"     # 음수일수록 먼저 실행
spec:
  template:
    spec:
      containers:
        - name: migration
          image: myapp:latest
          command: ["python", "manage.py", "migrate"]
      restartPolicy: Never
---
# 앱 Deployment (wave: 0 — 마이그레이션 성공 후 배포)
apiVersion: apps/v1
kind: Deployment
metadata:
  name: payment
  annotations:
    argocd.argoproj.io/sync-wave: "0"
spec:
  # ...
---
# 스모크 테스트 Job (wave: 1 → 앱 배포 후 실행)
apiVersion: batch/v1
kind: Job
metadata:
  name: smoke-test
  annotations:
    argocd.argoproj.io/hook: PostSync      # 배포 완료 후 실행
    argocd.argoproj.io/hook-delete-policy: HookSucceeded
    argocd.argoproj.io/sync-wave: "1"
spec:
  template:
    spec:
      containers:
        - name: test
          image: curlimages/curl
          command:
            - sh
            - -c
            - "curl -f http://payment:8080/health || exit 1"
      restartPolicy: Never

k8s-manifests/
├── apps/
│   ├── payment/
│   │   ├── base/           # 공통 매니페스트
│   │   ├── dev/            # dev 오버레이 (kustomize)
│   │   ├── staging/
│   │   └── production/
│   └── order/
└── infrastructure/
    ├── cert-manager/
    ├── ingress-nginx/
    └── monitoring/