์ฝ˜ํ…์ธ  ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ - ๐Ÿš€ ArgoCD๋กœ GitOps ๋ฐฐํฌ ์ž๋™ํ™” ๊ตฌ์ถ•ํ•˜๊ธฐ: ๊ฐœ๋ฐœ์ž์˜ ์ƒˆ๋กœ์šด ๋ฌด๊ธฐ

๐Ÿš€ ArgoCD๋กœ GitOps ๋ฐฐํฌ ์ž๋™ํ™” ๊ตฌ์ถ•ํ•˜๊ธฐ: ๊ฐœ๋ฐœ์ž์˜ ์ƒˆ๋กœ์šด ๋ฌด๊ธฐ

์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ๋ฐฐํฌ๋ฅผ Git์œผ๋กœ ๊ด€๋ฆฌํ•˜๋Š” ํ˜์‹ ์ ์ธ ๋ฐฉ๋ฒ•

์•ˆ๋…•! ํ˜น์‹œ ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ๋ฐฐํฌํ•  ๋•Œ๋งˆ๋‹ค kubectl ๋ช…๋ น์–ด ์น˜๋А๋ผ ์†๊ฐ€๋ฝ ์•„ํ”„์ง€ ์•Š์•„? ๐Ÿค”
๋ฐฐํฌ ํžˆ์Šคํ† ๋ฆฌ ๊ด€๋ฆฌ๋„ ์• ๋งคํ•˜๊ณ , ๋ˆ„๊ฐ€ ๋ญ˜ ๋ฐฐํฌํ–ˆ๋Š”์ง€ ์ถ”์ ํ•˜๊ธฐ๋„ ํž˜๋“ค๊ณ ...
์˜ค๋Š˜์€ ์ด๋Ÿฐ ๊ณ ๋ฏผ์„ ํ•œ ๋ฐฉ์— ๋‚ ๋ ค์ค„ ArgoCD๋ฅผ ํ™œ์šฉํ•œ GitOps ๋ฐฐํฌ ์ž๋™ํ™”์— ๋Œ€ํ•ด ์ด์•ผ๊ธฐํ•ด๋ณผ๊ฒŒ!

์ด ๊ธ€์„ ๋‹ค ์ฝ๊ณ  ๋‚˜๋ฉด ๋„ˆ๋„ Git Push ํ•œ ๋ฒˆ์œผ๋กœ ํ”„๋กœ๋•์…˜ ๋ฐฐํฌ๋ฅผ ์ž๋™ํ™”ํ•  ์ˆ˜ ์žˆ์„ ๊ฑฐ์•ผ. ๐Ÿ’ช

Git Repository YAML ํŒŒ์ผ Deployment Service ConfigMap ๐Ÿ“ Git Push ArgoCD ๐Ÿ”„ ์ž๋™ ๋™๊ธฐํ™” ์ƒํƒœ ๋ชจ๋‹ˆํ„ฐ๋ง ๋กค๋ฐฑ ๊ด€๋ฆฌ Deploy Kubernetes โ˜ธ๏ธ Pod Service Ingress GitOps ๋ฐฐํฌ ํ”Œ๋กœ์šฐ

๐ŸŽฏ GitOps๊ฐ€ ๋ญ๊ธธ๋ž˜ ์ด๋ ‡๊ฒŒ ๋‚œ๋ฆฌ์•ผ?

๋จผ์ € GitOps๊ฐ€ ๋ญ”์ง€๋ถ€ํ„ฐ ์•Œ์•„์•ผ๊ฒ ์ง€? ๊ฐ„๋‹จํ•˜๊ฒŒ ๋งํ•˜๋ฉด Git์„ ๋‹จ์ผ ์ง„์‹ค ๊ณต๊ธ‰์›(Single Source of Truth)์œผ๋กœ ์‚ฌ์šฉํ•˜๋Š” ์šด์˜ ๋ฐฉ์‹์ด์•ผ. ๐Ÿ˜Ž

์ „ํ†ต์ ์ธ ๋ฐฉ์‹์—์„œ๋Š” ๊ฐœ๋ฐœ์ž๊ฐ€ ์ง์ ‘ kubectl ๋ช…๋ น์–ด๋ฅผ ์น˜๊ฑฐ๋‚˜ CI/CD ํŒŒ์ดํ”„๋ผ์ธ์—์„œ ๋ฐฐํฌ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‹คํ–‰ํ–ˆ์–ด. ๊ทผ๋ฐ ์ด ๋ฐฉ์‹์€ ๋ช‡ ๊ฐ€์ง€ ๋ฌธ์ œ๊ฐ€ ์žˆ์–ด:

์ „ํ†ต์  ๋ฐฐํฌ ๋ฐฉ์‹์˜ ๋ฌธ์ œ์ :
โ€ข ๋ˆ„๊ฐ€ ์–ธ์ œ ๋ฌด์—‡์„ ๋ฐฐํฌํ–ˆ๋Š”์ง€ ์ถ”์ ์ด ์–ด๋ ค์›Œ ๐Ÿ”
โ€ข ๋ฐฐํฌ ์‹คํŒจ ์‹œ ๋กค๋ฐฑ์ด ๋ณต์žกํ•ด
โ€ข ์—ฌ๋Ÿฌ ํ™˜๊ฒฝ(dev, staging, prod)์˜ ์ผ๊ด€์„ฑ ์œ ์ง€๊ฐ€ ํž˜๋“ค์–ด
โ€ข ๋ฐฐํฌ ๊ถŒํ•œ ๊ด€๋ฆฌ๊ฐ€ ๊นŒ๋‹ค๋กœ์›Œ
โ€ข ์žฌํ•ด ๋ณต๊ตฌ ์‹œ ํ˜„์žฌ ์ƒํƒœ๋ฅผ ์ •ํ™•ํžˆ ์žฌํ˜„ํ•˜๊ธฐ ์–ด๋ ค์›Œ

GitOps๋Š” ์ด๋Ÿฐ ๋ฌธ์ œ๋“ค์„ Git์˜ ๊ฐ•๋ ฅํ•œ ๋ฒ„์ „ ๊ด€๋ฆฌ ๊ธฐ๋Šฅ์œผ๋กœ ํ•ด๊ฒฐํ•ด. ๋ชจ๋“  ์ธํ”„๋ผ ์ƒํƒœ๋ฅผ Git ์ €์žฅ์†Œ์— ์ฝ”๋“œ๋กœ ์ •์˜ํ•˜๊ณ , ์‹ค์ œ ํด๋Ÿฌ์Šคํ„ฐ ์ƒํƒœ๋ฅผ Git ์ €์žฅ์†Œ์˜ ์ƒํƒœ์™€ ์ž๋™์œผ๋กœ ๋™๊ธฐํ™”ํ•˜๋Š” ๊ฑฐ์ง€! ๐ŸŽ‰

๐Ÿ’ก GitOps์˜ ํ•ต์‹ฌ ์›์น™

1. ์„ ์–ธ์  ์ •์˜ (Declarative)
์‹œ์Šคํ…œ์˜ ์›ํ•˜๋Š” ์ƒํƒœ๋ฅผ ์„ ์–ธ์ ์œผ๋กœ ์ •์˜ํ•ด. "์ด๋ ‡๊ฒŒ ํ•ด๋ผ"๊ฐ€ ์•„๋‹ˆ๋ผ "์ด๋Ÿฐ ์ƒํƒœ์—ฌ์•ผ ํ•ด"๋ผ๊ณ  ๋งํ•˜๋Š” ๊ฑฐ์•ผ.

2. ๋ฒ„์ „ ๊ด€๋ฆฌ (Versioned and Immutable)
๋ชจ๋“  ๋ณ€๊ฒฝ์‚ฌํ•ญ์ด Git์— ๊ธฐ๋ก๋˜๊ณ , ์–ธ์ œ๋“  ์ด์ „ ๋ฒ„์ „์œผ๋กœ ๋Œ์•„๊ฐˆ ์ˆ˜ ์žˆ์–ด.

3. ์ž๋™ ์ ์šฉ (Pulled Automatically)
์—์ด์ „ํŠธ๊ฐ€ Git ์ €์žฅ์†Œ๋ฅผ ์ง€์†์ ์œผ๋กœ ๋ชจ๋‹ˆํ„ฐ๋งํ•˜๊ณ  ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ์ž๋™์œผ๋กœ ์ ์šฉํ•ด.

4. ์ง€์†์  ์กฐ์ • (Continuously Reconciled)
์‹ค์ œ ์ƒํƒœ์™€ ์›ํ•˜๋Š” ์ƒํƒœ๊ฐ€ ๋‹ค๋ฅด๋ฉด ์ž๋™์œผ๋กœ ๋งž์ถฐ์ค˜.

๐ŸŒŸ ArgoCD๋ฅผ ์„ ํƒํ•ด์•ผ ํ•˜๋Š” ์ด์œ 

GitOps๋ฅผ ๊ตฌํ˜„ํ•  ์ˆ˜ ์žˆ๋Š” ๋„๊ตฌ๋Š” ์—ฌ๋Ÿฌ ๊ฐ€์ง€๊ฐ€ ์žˆ์–ด. Flux, Jenkins X, GitLab ๋“ฑ๋“ฑ... ๊ทธ๋Ÿฐ๋ฐ ์™œ ArgoCD์ผ๊นŒ? ๐Ÿค”

ArgoCD์˜ ๊ฐ•๋ ฅํ•œ ์žฅ์ ๋“ค:

ํŠน์ง• ์„ค๋ช… ์‹ค๋ฌด ํ™œ์šฉ๋„
๐ŸŽจ ์ง๊ด€์ ์ธ UI ์›น ๊ธฐ๋ฐ˜ ๋Œ€์‹œ๋ณด๋“œ๋กœ ๋ฐฐํฌ ์ƒํƒœ๋ฅผ ํ•œ๋ˆˆ์— ํ™•์ธ โญโญโญโญโญ
๐Ÿ”„ ์ž๋™ ๋™๊ธฐํ™” Git ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ์ž๋™์œผ๋กœ ๊ฐ์ง€ํ•˜๊ณ  ๋ฐฐํฌ โญโญโญโญโญ
๐ŸŽฏ ๋ฉ€ํ‹ฐ ํด๋Ÿฌ์Šคํ„ฐ ํ•˜๋‚˜์˜ ArgoCD๋กœ ์—ฌ๋Ÿฌ ํด๋Ÿฌ์Šคํ„ฐ ๊ด€๋ฆฌ โญโญโญโญ
๐Ÿ” RBAC ์ง€์› ์„ธ๋ฐ€ํ•œ ๊ถŒํ•œ ๊ด€๋ฆฌ ๊ฐ€๋Šฅ โญโญโญโญโญ
๐Ÿ“Š ํ—ฌ์Šค ์ฒดํฌ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ƒํƒœ๋ฅผ ์‹ค์‹œ๊ฐ„ ๋ชจ๋‹ˆํ„ฐ๋ง โญโญโญโญโญ
โฎ๏ธ ์‰ฌ์šด ๋กค๋ฐฑ ํด๋ฆญ ํ•œ ๋ฒˆ์œผ๋กœ ์ด์ „ ๋ฒ„์ „์œผ๋กœ ๋ณต๊ตฌ โญโญโญโญโญ

ํŠนํžˆ ์žฌ๋Šฅ๋„ท ๊ฐ™์€ ํ”Œ๋žซํผ์—์„œ DevOps ๊ด€๋ จ ์žฌ๋Šฅ์„ ๊ฑฐ๋ž˜ํ•  ๋•Œ, ArgoCD ๊ตฌ์ถ• ๊ฒฝํ—˜์€ ์ •๋ง ํฐ ๊ฐ•์ ์ด ๋  ์ˆ˜ ์žˆ์–ด! ๋งŽ์€ ๊ธฐ์—…๋“ค์ด GitOps๋กœ ์ „ํ™˜ํ•˜๊ณ  ์žˆ๊ฑฐ๋“ . ๐Ÿ’ผ

๐Ÿ› ๏ธ ArgoCD ์„ค์น˜ํ•˜๊ธฐ - ์‹ค์ „ ๊ฐ€์ด๋“œ

์ž, ์ด์ œ ๋ณธ๊ฒฉ์ ์œผ๋กœ ArgoCD๋ฅผ ์„ค์น˜ํ•ด๋ณด์ž! ์ƒ๊ฐ๋ณด๋‹ค ๊ฐ„๋‹จํ•ด. ๐Ÿ˜Š

์‚ฌ์ „ ์ค€๋น„์‚ฌํ•ญ:
โ€ข Kubernetes ํด๋Ÿฌ์Šคํ„ฐ (v1.19 ์ด์ƒ ๊ถŒ์žฅ)
โ€ข kubectl ๋ช…๋ น์–ด ๋„๊ตฌ
โ€ข ์ตœ์†Œ 2GB RAM, 2 CPU ์ฝ”์–ด
โ€ข Git ์ €์žฅ์†Œ (GitHub, GitLab, Bitbucket ๋“ฑ)

Step 1: ArgoCD ๋„ค์ž„์ŠคํŽ˜์ด์Šค ์ƒ์„ฑ

๋จผ์ € ArgoCD๋ฅผ ์œ„ํ•œ ์ „์šฉ ๋„ค์ž„์ŠคํŽ˜์ด์Šค๋ฅผ ๋งŒ๋“ค์–ด์ค˜:

kubectl create namespace argocd

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ArgoCD ๊ด€๋ จ ๋ฆฌ์†Œ์Šค๋“ค์ด ๊น”๋”ํ•˜๊ฒŒ ๋ถ„๋ฆฌ๋ผ์„œ ๊ด€๋ฆฌํ•˜๊ธฐ ํŽธํ•ด! ๐Ÿ—‚๏ธ

Step 2: ArgoCD ์„ค์น˜

๊ณต์‹ ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•ด์„œ ์„ค์น˜ํ•ด๋ณด์ž:

kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

์ด ๋ช…๋ น์–ด ํ•˜๋‚˜๋กœ ArgoCD์˜ ๋ชจ๋“  ์ปดํฌ๋„ŒํŠธ๊ฐ€ ์„ค์น˜๋ผ:
โ€ข argocd-server (API ์„œ๋ฒ„ ๋ฐ ์›น UI)
โ€ข argocd-repo-server (Git ์ €์žฅ์†Œ ์—ฐ๋™)
โ€ข argocd-application-controller (์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ƒํƒœ ๊ด€๋ฆฌ)
โ€ข argocd-dex-server (SSO ์ธ์ฆ)
โ€ข argocd-redis (์บ์‹œ ์ €์žฅ์†Œ)

Step 3: ์„ค์น˜ ํ™•์ธ

๋ชจ๋“  Pod๊ฐ€ ์ •์ƒ์ ์œผ๋กœ ์‹คํ–‰๋˜๋Š”์ง€ ํ™•์ธํ•ด๋ณด์ž:

kubectl get pods -n argocd

๋ชจ๋“  Pod์˜ STATUS๊ฐ€ Running์ด๋ฉด ์„ฑ๊ณต! ๐ŸŽ‰
๋ณดํ†ต 1-2๋ถ„ ์ •๋„ ๊ฑธ๋ ค. ๋งŒ์•ฝ Pending ์ƒํƒœ๊ฐ€ ๊ณ„์†๋˜๋ฉด ๋ฆฌ์†Œ์Šค๊ฐ€ ๋ถ€์กฑํ•œ ๊ฑฐ๋‹ˆ๊นŒ ๋…ธ๋“œ๋ฅผ ํ™•์ธํ•ด๋ด.

Step 4: ArgoCD CLI ์„ค์น˜ (์„ ํƒ์‚ฌํ•ญ)

CLI๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋” ํŽธํ•˜๊ฒŒ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด. macOS ๊ธฐ์ค€์œผ๋กœ:

brew install argocd

Linux์—์„œ๋Š”:

curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
chmod +x /usr/local/bin/argocd

Step 5: ArgoCD ์„œ๋ฒ„ ์ ‘์†ํ•˜๊ธฐ

ArgoCD UI์— ์ ‘์†ํ•˜๋ ค๋ฉด ์„œ๋น„์Šค๋ฅผ ์™ธ๋ถ€๋กœ ๋…ธ์ถœํ•ด์•ผ ํ•ด. ์—ฌ๋Ÿฌ ๋ฐฉ๋ฒ•์ด ์žˆ๋Š”๋ฐ, ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ๋Š” ํฌํŠธ ํฌ์›Œ๋”ฉ์ด ๊ฐ€์žฅ ๊ฐ„๋‹จํ•ด:

kubectl port-forward svc/argocd-server -n argocd 8080:443

์ด์ œ ๋ธŒ๋ผ์šฐ์ €์—์„œ https://localhost:8080์œผ๋กœ ์ ‘์†ํ•˜๋ฉด ArgoCD UI๋ฅผ ๋ณผ ์ˆ˜ ์žˆ์–ด! ๐ŸŒ

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” Ingress๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒŒ ์ข‹์•„:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: argocd-server-ingress
  namespace: argocd
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-prod
    nginx.ingress.kubernetes.io/ssl-passthrough: "true"
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
spec:
  ingressClassName: nginx
  rules:
  - host: argocd.yourdomain.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: argocd-server
            port:
              name: https
  tls:
  - hosts:
    - argocd.yourdomain.com
    secretName: argocd-secret

Step 6: ์ดˆ๊ธฐ ๋น„๋ฐ€๋ฒˆํ˜ธ ํ™•์ธ

ArgoCD๋Š” ์„ค์น˜ ์‹œ ์ž๋™์œผ๋กœ admin ๊ณ„์ •์„ ์ƒ์„ฑํ•ด. ์ดˆ๊ธฐ ๋น„๋ฐ€๋ฒˆํ˜ธ๋Š” Secret์— ์ €์žฅ๋˜์–ด ์žˆ์–ด:

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

์ด ๋น„๋ฐ€๋ฒˆํ˜ธ๋กœ ๋กœ๊ทธ์ธํ•œ ํ›„ ๊ผญ ๋ณ€๊ฒฝํ•ด์ค˜! ๋ณด์•ˆ์€ ์ค‘์š”ํ•˜๋‹ˆ๊นŒ. ๐Ÿ”

๐Ÿ’ก Pro Tip: ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” argocd-initial-admin-secret์„ ์‚ญ์ œํ•˜๊ณ  SSO(Single Sign-On)๋ฅผ ์„ค์ •ํ•˜๋Š” ๊ฒŒ ์ข‹์•„. OIDC, SAML, LDAP ๋“ฑ ๋‹ค์–‘ํ•œ ์ธ์ฆ ๋ฐฉ์‹์„ ์ง€์›ํ•ด!

๐ŸŽจ ์ฒซ ๋ฒˆ์งธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋ฐฐํฌํ•˜๊ธฐ

์ด์ œ ์‹ค์ œ๋กœ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋ฐฐํฌํ•ด๋ณด์ž! ๊ฐ„๋‹จํ•œ Nginx ์›น ์„œ๋ฒ„๋ฅผ ์˜ˆ์ œ๋กœ ์‚ฌ์šฉํ• ๊ฒŒ. ๐Ÿš€

Step 1: Git ์ €์žฅ์†Œ ์ค€๋น„

๋จผ์ € Git ์ €์žฅ์†Œ์— Kubernetes ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋ฅผ ์ค€๋น„ํ•ด์•ผ ํ•ด. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ตฌ์กฐ๋กœ ๋งŒ๋“ค์–ด๋ณด์ž:

my-app/
โ”œโ”€โ”€ deployment.yaml
โ”œโ”€โ”€ service.yaml
โ””โ”€โ”€ ingress.yaml

deployment.yaml:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-app
  labels:
    app: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.21
        ports:
        - containerPort: 80
        resources:
          requests:
            memory: "64Mi"
            cpu: "100m"
          limits:
            memory: "128Mi"
            cpu: "200m"

service.yaml:

apiVersion: v1
kind: Service
metadata:
  name: nginx-service
spec:
  selector:
    app: nginx
  ports:
  - protocol: TCP
    port: 80
    targetPort: 80
  type: ClusterIP

์ด ํŒŒ์ผ๋“ค์„ Git ์ €์žฅ์†Œ์— ์ปค๋ฐ‹ํ•˜๊ณ  ํ‘ธ์‹œํ•ด์ค˜! ๐Ÿ“ค

Step 2: ArgoCD Application ์ƒ์„ฑ (UI ๋ฐฉ์‹)

ArgoCD UI์— ๋กœ๊ทธ์ธํ•œ ํ›„:

1. + NEW APP ๋ฒ„ํŠผ ํด๋ฆญ
2. ๋‹ค์Œ ์ •๋ณด ์ž…๋ ฅ:
โ€ข Application Name: nginx-app
โ€ข Project: default
โ€ข Sync Policy: Automatic (์ž๋™ ๋™๊ธฐํ™” ์›ํ•˜๋ฉด)
โ€ข Repository URL: ๋„ˆ์˜ Git ์ €์žฅ์†Œ URL
โ€ข Revision: HEAD ๋˜๋Š” ํŠน์ • ๋ธŒ๋žœ์น˜
โ€ข Path: my-app (๋งค๋‹ˆํŽ˜์ŠคํŠธ๊ฐ€ ์žˆ๋Š” ๊ฒฝ๋กœ)
โ€ข Cluster URL: https://kubernetes.default.svc
โ€ข Namespace: default

3. CREATE ๋ฒ„ํŠผ ํด๋ฆญ! ๐ŸŽฏ

Step 3: ArgoCD Application ์ƒ์„ฑ (CLI ๋ฐฉ์‹)

CLI๋ฅผ ์„ ํ˜ธํ•œ๋‹ค๋ฉด ์ด๋ ‡๊ฒŒ ํ•ด๋„ ๋ผ:

argocd app create nginx-app \
  --repo https://github.com/your-username/your-repo.git \
  --path my-app \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace default \
  --sync-policy automated \
  --auto-prune \
  --self-heal

์—ฌ๊ธฐ์„œ ์ค‘์š”ํ•œ ์˜ต์…˜๋“ค:
โ€ข --sync-policy automated: Git ๋ณ€๊ฒฝ์‚ฌํ•ญ ์ž๋™ ๋™๊ธฐํ™”
โ€ข --auto-prune: Git์—์„œ ์‚ญ์ œ๋œ ๋ฆฌ์†Œ์Šค ์ž๋™ ์ œ๊ฑฐ
โ€ข --self-heal: ํด๋Ÿฌ์Šคํ„ฐ์—์„œ ์ˆ˜๋™ ๋ณ€๊ฒฝ ์‹œ ์ž๋™ ๋ณต๊ตฌ

Step 4: ๋ฐฐํฌ ์ƒํƒœ ํ™•์ธ

ArgoCD UI์—์„œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์นด๋“œ๋ฅผ ํด๋ฆญํ•˜๋ฉด ๋ฉ‹์ง„ ์‹œ๊ฐํ™” ํ™”๋ฉด์ด ๋‚˜์™€! ๐Ÿ˜

์—ฌ๊ธฐ์„œ ๋ณผ ์ˆ˜ ์žˆ๋Š” ๊ฒƒ๋“ค:
โ€ข ๋ชจ๋“  Kubernetes ๋ฆฌ์†Œ์Šค์˜ ๊ด€๊ณ„๋„
โ€ข ๊ฐ ๋ฆฌ์†Œ์Šค์˜ ํ—ฌ์Šค ์ƒํƒœ (Healthy, Progressing, Degraded)
โ€ข ๋™๊ธฐํ™” ์ƒํƒœ (Synced, OutOfSync)
โ€ข ์ตœ๊ทผ ๋ฐฐํฌ ํžˆ์Šคํ† ๋ฆฌ
โ€ข ์‹ค์‹œ๊ฐ„ ๋กœ๊ทธ

CLI๋กœ๋„ ํ™•์ธ ๊ฐ€๋Šฅํ•ด:

argocd app get nginx-app
ArgoCD ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ƒํƒœ ๋ชจ๋‹ˆํ„ฐ๋ง nginx-app โœ“ Healthy โŸณ Synced Last Sync: 2 minutes ago Revision: main/abc1234 ๋ฆฌ์†Œ์Šค ํŠธ๋ฆฌ Deployment Pod 1 Pod 2 Pod 3 Service Ingress

๐Ÿ”ง ๊ณ ๊ธ‰ ์„ค์ •๊ณผ ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค

๊ธฐ๋ณธ ๋ฐฐํฌ๋Š” ์„ฑ๊ณตํ–ˆ์–ด! ์ด์ œ ์‹ค๋ฌด์—์„œ ๊ผญ ํ•„์š”ํ•œ ๊ณ ๊ธ‰ ๊ธฐ๋Šฅ๋“ค์„ ์•Œ์•„๋ณด์ž. ๐Ÿ’ช

1. ๋ฉ€ํ‹ฐ ํ™˜๊ฒฝ ๊ด€๋ฆฌ (Kustomize ํ™œ์šฉ)

๋ณดํ†ต ๊ฐœ๋ฐœ, ์Šคํ…Œ์ด์ง•, ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์ด ๋”ฐ๋กœ ์žˆ์ž–์•„? ๊ฐ ํ™˜๊ฒฝ๋งˆ๋‹ค ์„ค์ •์ด ์กฐ๊ธˆ์”ฉ ๋‹ค๋ฅธ๋ฐ, ์ด๊ฑธ ์–ด๋–ป๊ฒŒ ๊ด€๋ฆฌํ• ๊นŒ? ๐Ÿค”

Kustomize๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋ฒ ์ด์Šค ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋ฅผ ๊ณต์œ ํ•˜๋ฉด์„œ ํ™˜๊ฒฝ๋ณ„ ์ฐจ์ด๋งŒ ์˜ค๋ฒ„๋ ˆ์ด๋กœ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด!

my-app/
โ”œโ”€โ”€ base/
โ”‚   โ”œโ”€โ”€ kustomization.yaml
โ”‚   โ”œโ”€โ”€ deployment.yaml
โ”‚   โ””โ”€โ”€ service.yaml
โ””โ”€โ”€ overlays/
    โ”œโ”€โ”€ dev/
    โ”‚   โ”œโ”€โ”€ kustomization.yaml
    โ”‚   โ””โ”€โ”€ replica-patch.yaml
    โ”œโ”€โ”€ staging/
    โ”‚   โ”œโ”€โ”€ kustomization.yaml
    โ”‚   โ””โ”€โ”€ replica-patch.yaml
    โ””โ”€โ”€ prod/
        โ”œโ”€โ”€ kustomization.yaml
        โ”œโ”€โ”€ replica-patch.yaml
        โ””โ”€โ”€ resource-patch.yaml

base/kustomization.yaml:

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - deployment.yaml
  - service.yaml
commonLabels:
  app: nginx

overlays/prod/kustomization.yaml:

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
bases:
  - ../../base
patchesStrategicMerge:
  - replica-patch.yaml
  - resource-patch.yaml
namespace: production
commonLabels:
  environment: prod

overlays/prod/replica-patch.yaml:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-app
spec:
  replicas: 10

์ด์ œ ArgoCD Application์„ ํ™˜๊ฒฝ๋ณ„๋กœ ๋งŒ๋“ค ๋•Œ path๋งŒ ๋‹ค๋ฅด๊ฒŒ ์ง€์ •ํ•˜๋ฉด ๋ผ:

argocd app create nginx-prod \
  --repo https://github.com/your-username/your-repo.git \
  --path my-app/overlays/prod \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace production

2. Helm ์ฐจํŠธ ํ†ตํ•ฉ

Helm ์ฐจํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ๋„ ๋งŽ์ง€? ArgoCD๋Š” Helm๋„ ์™„๋ฒฝํ•˜๊ฒŒ ์ง€์›ํ•ด! ๐ŸŽฉ

values.yaml์„ Git์—์„œ ๊ด€๋ฆฌ:

argocd app create my-helm-app \
  --repo https://charts.bitnami.com/bitnami \
  --helm-chart nginx \
  --revision 13.2.0 \
  --values-literal-file values.yaml \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace default

๋˜๋Š” Git ์ €์žฅ์†Œ์— ์žˆ๋Š” Helm ์ฐจํŠธ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜๋„ ์žˆ์–ด:

my-helm-app/
โ”œโ”€โ”€ Chart.yaml
โ”œโ”€โ”€ values.yaml
โ”œโ”€โ”€ values-dev.yaml
โ”œโ”€โ”€ values-prod.yaml
โ””โ”€โ”€ templates/
    โ”œโ”€โ”€ deployment.yaml
    โ””โ”€โ”€ service.yaml

ํ™˜๊ฒฝ๋ณ„๋กœ ๋‹ค๋ฅธ values ํŒŒ์ผ์„ ์‚ฌ์šฉํ•˜๋ ค๋ฉด:

argocd app create my-helm-app-prod \
  --repo https://github.com/your-username/your-repo.git \
  --path my-helm-app \
  --helm-set-file values=values-prod.yaml \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace production

3. ๋™๊ธฐํ™” ์ •์ฑ… ์„ธ๋ฐ€ํ•˜๊ฒŒ ์กฐ์ •ํ•˜๊ธฐ

์ž๋™ ๋™๊ธฐํ™”๋Š” ํŽธํ•˜์ง€๋งŒ, ํ”„๋กœ๋•์…˜์—์„œ๋Š” ์ข€ ๋” ์‹ ์ค‘ํ•ด์•ผ ํ•  ๋•Œ๊ฐ€ ์žˆ์–ด. ๋‹ค์–‘ํ•œ ๋™๊ธฐํ™” ์˜ต์…˜์„ ์•Œ์•„๋ณด์ž! โš™๏ธ

์˜ต์…˜ ์„ค๋ช… ์ถ”์ฒœ ํ™˜๊ฒฝ
Manual ์ˆ˜๋™์œผ๋กœ๋งŒ ๋™๊ธฐํ™” ํ”„๋กœ๋•์…˜ (์Šน์ธ ํ”„๋กœ์„ธ์Šค ํ•„์š”)
Automatic Git ๋ณ€๊ฒฝ ์‹œ ์ž๋™ ๋™๊ธฐํ™” ๊ฐœ๋ฐœ, ์Šคํ…Œ์ด์ง•
Auto-Prune Git์—์„œ ์‚ญ์ œ๋œ ๋ฆฌ์†Œ์Šค ์ž๋™ ์ œ๊ฑฐ ๋ชจ๋“  ํ™˜๊ฒฝ (์ฃผ์˜ ํ•„์š”)
Self-Heal ํด๋Ÿฌ์Šคํ„ฐ ๋ณ€๊ฒฝ ์‹œ Git ์ƒํƒœ๋กœ ๋ณต๊ตฌ ํ”„๋กœ๋•์…˜ (์„ค์ • ๋“œ๋ฆฌํ”„ํŠธ ๋ฐฉ์ง€)

Application ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋กœ ์„ธ๋ฐ€ํ•˜๊ฒŒ ์„ค์ •:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: nginx-app
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/your-username/your-repo.git
    targetRevision: HEAD
    path: my-app
  destination:
    server: https://kubernetes.default.svc
    namespace: default
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
      allowEmpty: false
    syncOptions:
    - CreateNamespace=true
    - PrunePropagationPolicy=foreground
    - PruneLast=true
    retry:
      limit: 5
      backoff:
        duration: 5s
        factor: 2
        maxDuration: 3m
๐Ÿ’ก ์‹ค๋ฌด ํŒ: ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” automated๋ฅผ ๋„๊ณ  ์ˆ˜๋™ ๋™๊ธฐํ™”๋ฅผ ์‚ฌ์šฉํ•˜๋˜, selfHeal๋งŒ ์ผœ๋‘๋Š” ๊ฑธ ์ถ”์ฒœํ•ด. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ์˜๋„ํ•˜์ง€ ์•Š์€ ๋ฐฐํฌ๋Š” ๋ง‰์œผ๋ฉด์„œ๋„ ๋ˆ„๊ตฐ๊ฐ€ kubectl๋กœ ์ง์ ‘ ์ˆ˜์ •ํ•˜๋Š” ๊ฑธ ๋ฐฉ์ง€ํ•  ์ˆ˜ ์žˆ์–ด! ๐Ÿ›ก๏ธ

๐Ÿ” ๋ณด์•ˆ ๊ฐ•ํ™”ํ•˜๊ธฐ

ArgoCD๋Š” ํด๋Ÿฌ์Šคํ„ฐ์˜ ํ•ต์‹ฌ ์ธํ”„๋ผ๋ฅผ ๊ด€๋ฆฌํ•˜๋‹ˆ๊นŒ ๋ณด์•ˆ์ด ์ •๋ง ์ค‘์š”ํ•ด! ์‹ค๋ฌด์—์„œ ๊ผญ ์ ์šฉํ•ด์•ผ ํ•  ๋ณด์•ˆ ์„ค์ •๋“ค์„ ์•Œ์•„๋ณด์ž. ๐Ÿ”’

1. RBAC (์—ญํ•  ๊ธฐ๋ฐ˜ ์ ‘๊ทผ ์ œ์–ด)

ํŒ€์›๋งˆ๋‹ค ๋‹ค๋ฅธ ๊ถŒํ•œ์„ ์ค˜์•ผ ํ•  ๋•Œ๊ฐ€ ์žˆ์ง€? ArgoCD๋Š” ๊ฐ•๋ ฅํ•œ RBAC์„ ์ง€์›ํ•ด!

argocd-rbac-cm ConfigMap ์ˆ˜์ •:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-rbac-cm
  namespace: argocd
data:
  policy.default: role:readonly
  policy.csv: |
    # ๊ฐœ๋ฐœ์ž ๊ทธ๋ฃน - dev ๋„ค์ž„์ŠคํŽ˜์ด์Šค๋งŒ ์ ‘๊ทผ
    p, role:developer, applications, get, */*, allow
    p, role:developer, applications, sync, dev/*, allow
    g, dev-team, role:developer
    
    # ์šด์˜ํŒ€ - ๋ชจ๋“  ๊ถŒํ•œ
    p, role:operator, applications, *, */*, allow
    p, role:operator, clusters, *, *, allow
    p, role:operator, repositories, *, *, allow
    g, ops-team, role:operator
    
    # ์ฝ๊ธฐ ์ „์šฉ ์‚ฌ์šฉ์ž
    p, role:readonly, applications, get, */*, allow
    p, role:readonly, logs, get, */*, allow
    g, viewer-team, role:readonly

์ด๋ ‡๊ฒŒ ์„ค์ •ํ•˜๋ฉด:
โ€ข ๊ฐœ๋ฐœ์ž๋Š” dev ๋„ค์ž„์ŠคํŽ˜์ด์Šค๋งŒ ๋ฐฐํฌ ๊ฐ€๋Šฅ โœ…
โ€ข ์šด์˜ํŒ€์€ ๋ชจ๋“  ๊ถŒํ•œ ๋ณด์œ  โœ…
โ€ข ๋ทฐ์–ด๋Š” ์กฐํšŒ๋งŒ ๊ฐ€๋Šฅ โœ…

2. SSO ํ†ตํ•ฉ (OIDC)

ํšŒ์‚ฌ์—์„œ Google Workspace๋‚˜ Okta๋ฅผ ์“ด๋‹ค๋ฉด SSO๋ฅผ ์—ฐ๋™ํ•˜๋Š” ๊ฒŒ ์ข‹์•„! ๐ŸŽซ

Google OAuth ์˜ˆ์ œ:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
data:
  url: https://argocd.yourdomain.com
  oidc.config: |
    name: Google
    issuer: https://accounts.google.com
    clientID: your-client-id.apps.googleusercontent.com
    clientSecret: $oidc.google.clientSecret
    requestedScopes:
      - openid
      - profile
      - email
    requestedIDTokenClaims:
      groups:
        essential: true

Secret์— ํด๋ผ์ด์–ธํŠธ ์‹œํฌ๋ฆฟ ์ €์žฅ:

kubectl create secret generic argocd-secret \
  -n argocd \
  --from-literal=oidc.google.clientSecret=YOUR_CLIENT_SECRET

3. Private Git ์ €์žฅ์†Œ ์—ฐ๋™

ํšŒ์‚ฌ ์ฝ”๋“œ๋Š” ๋‹น์—ฐํžˆ Private ์ €์žฅ์†Œ์— ์žˆ๊ฒ ์ง€? SSH ํ‚ค๋‚˜ Personal Access Token์œผ๋กœ ์—ฐ๋™ํ•  ์ˆ˜ ์žˆ์–ด! ๐Ÿ”‘

SSH ํ‚ค ๋ฐฉ์‹:

argocd repo add git@github.com:your-org/your-repo.git \
  --ssh-private-key-path ~/.ssh/id_rsa

HTTPS + Token ๋ฐฉ์‹:

argocd repo add https://github.com/your-org/your-repo.git \
  --username your-username \
  --password ghp_yourpersonalaccesstoken

UI์—์„œ๋„ Settings > Repositories์—์„œ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด!

4. Secret ๊ด€๋ฆฌ

๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋น„๋ฐ€๋ฒˆํ˜ธ ๊ฐ™์€ ๋ฏผ๊ฐํ•œ ์ •๋ณด๋Š” Git์— ํ‰๋ฌธ์œผ๋กœ ์˜ฌ๋ฆฌ๋ฉด ์•ˆ ๋˜์ง€? ์—ฌ๋Ÿฌ ํ•ด๊ฒฐ์ฑ…์ด ์žˆ์–ด:

๋ฐฉ๋ฒ• 1: Sealed Secrets

# Sealed Secrets ์ปจํŠธ๋กค๋Ÿฌ ์„ค์น˜
kubectl apply -f https://github.com/bitnami-labs/sealed-secrets/releases/download/v0.18.0/controller.yaml

# Secret์„ SealedSecret์œผ๋กœ ์•”ํ˜ธํ™”
kubeseal --format yaml < secret.yaml > sealed-secret.yaml

# ์•”ํ˜ธํ™”๋œ ํŒŒ์ผ์„ Git์— ์ปค๋ฐ‹
git add sealed-secret.yaml
git commit -m "Add sealed secret"

๋ฐฉ๋ฒ• 2: External Secrets Operator
AWS Secrets Manager, HashiCorp Vault ๋“ฑ ์™ธ๋ถ€ ์‹œํฌ๋ฆฟ ์ €์žฅ์†Œ์™€ ์—ฐ๋™!

๋ฐฉ๋ฒ• 3: SOPS (Mozilla์˜ ์•”ํ˜ธํ™” ๋„๊ตฌ)
Git์— ์•”ํ˜ธํ™”๋œ ํŒŒ์ผ์„ ์ €์žฅํ•˜๊ณ  ArgoCD๊ฐ€ ์ž๋™์œผ๋กœ ๋ณตํ˜ธํ™”!

โš ๏ธ ๋ณด์•ˆ ์ฃผ์˜์‚ฌํ•ญ: โ€ข ์ ˆ๋Œ€ ํ‰๋ฌธ Secret์„ Git์— ์ปค๋ฐ‹ํ•˜์ง€ ๋งˆ! ๐Ÿšซ
โ€ข ArgoCD admin ๋น„๋ฐ€๋ฒˆํ˜ธ๋Š” ์„ค์น˜ ํ›„ ์ฆ‰์‹œ ๋ณ€๊ฒฝํ•ด
โ€ข ํ”„๋กœ๋•์…˜์—์„œ๋Š” ๋ฐ˜๋“œ์‹œ TLS/HTTPS ์‚ฌ์šฉ
โ€ข ์ •๊ธฐ์ ์œผ๋กœ ์ ‘๊ทผ ๋กœ๊ทธ๋ฅผ ๊ฒ€ํ† ํ•ด
โ€ข ์ตœ์†Œ ๊ถŒํ•œ ์›์น™์„ ์ ์šฉํ•ด (Principle of Least Privilege)

๐Ÿ“Š ๋ชจ๋‹ˆํ„ฐ๋ง๊ณผ ์•Œ๋ฆผ ์„ค์ •

๋ฐฐํฌ๊ฐ€ ์‹คํŒจํ•˜๊ฑฐ๋‚˜ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด Unhealthy ์ƒํƒœ๊ฐ€ ๋˜๋ฉด ์ฆ‰์‹œ ์•Œ์•„์•ผ๊ฒ ์ง€? ArgoCD์˜ ๋ชจ๋‹ˆํ„ฐ๋ง๊ณผ ์•Œ๋ฆผ ๊ธฐ๋Šฅ์„ ํ™œ์šฉํ•ด๋ณด์ž! ๐Ÿ“ข

1. Prometheus ๋ฉ”ํŠธ๋ฆญ ์ˆ˜์ง‘

ArgoCD๋Š” ๊ธฐ๋ณธ์ ์œผ๋กœ Prometheus ๋ฉ”ํŠธ๋ฆญ์„ ๋…ธ์ถœํ•ด. ์ด๊ฑธ ์ˆ˜์ง‘ํ•ด์„œ Grafana๋กœ ์‹œ๊ฐํ™”ํ•˜๋ฉด ์™„๋ฒฝ! ๐Ÿ“ˆ

apiVersion: v1
kind: Service
metadata:
  name: argocd-metrics
  namespace: argocd
  labels:
    app.kubernetes.io/name: argocd-metrics
spec:
  ports:
  - name: metrics
    port: 8082
    protocol: TCP
    targetPort: 8082
  selector:
    app.kubernetes.io/name: argocd-application-controller

Prometheus ServiceMonitor ์„ค์ •:

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: argocd-metrics
  namespace: argocd
spec:
  selector:
    matchLabels:
      app.kubernetes.io/name: argocd-metrics
  endpoints:
  - port: metrics
    interval: 30s

์ฃผ์š” ๋ฉ”ํŠธ๋ฆญ๋“ค:
โ€ข argocd_app_info: ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ •๋ณด
โ€ข argocd_app_sync_total: ๋™๊ธฐํ™” ํšŸ์ˆ˜
โ€ข argocd_app_health_status: ํ—ฌ์Šค ์ƒํƒœ
โ€ข argocd_app_sync_status: ๋™๊ธฐํ™” ์ƒํƒœ

2. Slack ์•Œ๋ฆผ ์„ค์ •

๋ฐฐํฌ ์‹คํŒจ๋‚˜ ์ƒํƒœ ๋ณ€๊ฒฝ์„ Slack์œผ๋กœ ๋ฐ›์•„๋ณด์ž! ๐Ÿ’ฌ

argocd-notifications-cm ConfigMap ์„ค์ •:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  service.slack: |
    token: $slack-token
  template.app-deployed: |
    message: |
      Application {{.app.metadata.name}} is now running new version.
    slack:
      attachments: |
        [{
          "title": "{{ .app.metadata.name}}",
          "title_link":"{{.context.argocdUrl}}/applications/{{.app.metadata.name}}",
          "color": "#18be52",
          "fields": [
          {
            "title": "Sync Status",
            "value": "{{.app.status.sync.status}}",
            "short": true
          },
          {
            "title": "Repository",
            "value": "{{.app.spec.source.repoURL}}",
            "short": true
          }
          ]
        }]
  template.app-health-degraded: |
    message: |
      Application {{.app.metadata.name}} has degraded.
    slack:
      attachments: |
        [{
          "title": "{{ .app.metadata.name}}",
          "title_link": "{{.context.argocdUrl}}/applications/{{.app.metadata.name}}",
          "color": "#f4c030",
          "fields": [
          {
            "title": "Health Status",
            "value": "{{.app.status.health.status}}",
            "short": true
          }
          ]
        }]
  trigger.on-deployed: |
    - when: app.status.operationState.phase in ['Succeeded']
      send: [app-deployed]
  trigger.on-health-degraded: |
    - when: app.status.health.status == 'Degraded'
      send: [app-health-degraded]

Slack ํ† ํฐ์„ Secret์— ์ €์žฅ:

kubectl create secret generic argocd-notifications-secret \
  -n argocd \
  --from-literal=slack-token=xoxb-your-slack-bot-token

Application์— ์•Œ๋ฆผ ์„ค์ • ์ถ”๊ฐ€:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: nginx-app
  namespace: argocd
  annotations:
    notifications.argoproj.io/subscribe.on-deployed.slack: your-channel
    notifications.argoproj.io/subscribe.on-health-degraded.slack: your-channel
spec:
  # ... ๋‚˜๋จธ์ง€ ์„ค์ •

3. ์ปค์Šคํ…€ ํ—ฌ์Šค ์ฒดํฌ

๊ธฐ๋ณธ ํ—ฌ์Šค ์ฒดํฌ๋กœ๋Š” ๋ถ€์กฑํ•  ๋•Œ๊ฐ€ ์žˆ์–ด. ์ปค์Šคํ…€ ํ—ฌ์Šค ์ฒดํฌ๋ฅผ ์ •์˜ํ•  ์ˆ˜ ์žˆ์–ด! ๐Ÿฅ

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
data:
  resource.customizations: |
    argoproj.io/Rollout:
      health.lua: |
        hs = {}
        if obj.status ~= nil then
          if obj.status.phase == "Healthy" then
            hs.status = "Healthy"
            hs.message = "Rollout is healthy"
            return hs
          end
          if obj.status.phase == "Degraded" then
            hs.status = "Degraded"
            hs.message = "Rollout is degraded"
            return hs
          end
        end
        hs.status = "Progressing"
        hs.message = "Waiting for rollout to finish"
        return hs

๐Ÿš€ CI/CD ํŒŒ์ดํ”„๋ผ์ธ ํ†ตํ•ฉ

ArgoCD๋Š” CD(Continuous Deployment) ๋ถ€๋ถ„์„ ๋‹ด๋‹นํ•ด. ๊ทธ๋Ÿผ CI(Continuous Integration)๋Š”? Jenkins, GitLab CI, GitHub Actions ๊ฐ™์€ CI ๋„๊ตฌ์™€ ํ†ตํ•ฉํ•ด์•ผ์ง€! ๐Ÿ”—

GitHub Actions ํ†ตํ•ฉ ์˜ˆ์ œ

์ฝ”๋“œ๊ฐ€ ํ‘ธ์‹œ๋˜๋ฉด ์ž๋™์œผ๋กœ ๋นŒ๋“œํ•˜๊ณ , ์ด๋ฏธ์ง€๋ฅผ ๋งŒ๋“ค๊ณ , ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋ฅผ ์—…๋ฐ์ดํŠธํ•˜๋Š” ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ๋งŒ๋“ค์–ด๋ณด์ž!

name: CI/CD Pipeline

on:
  push:
    branches: [ main ]

env:
  DOCKER_REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}

jobs:
  build-and-push:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      packages: write
    
    steps:
    - name: Checkout code
      uses: actions/checkout@v3
    
    - name: Set up Docker Buildx
      uses: docker/setup-buildx-action@v2
    
    - name: Login to GitHub Container Registry
      uses: docker/login-action@v2
      with:
        registry: ${{ env.DOCKER_REGISTRY }}
        username: ${{ github.actor }}
        password: ${{ secrets.GITHUB_TOKEN }}
    
    - name: Extract metadata
      id: meta
      uses: docker/metadata-action@v4
      with:
        images: ${{ env.DOCKER_REGISTRY }}/${{ env.IMAGE_NAME }}
        tags: |
          type=sha,prefix={{branch}}-
          type=ref,event=branch
    
    - name: Build and push Docker image
      uses: docker/build-push-action@v4
      with:
        context: .
        push: true
        tags: ${{ steps.meta.outputs.tags }}
        labels: ${{ steps.meta.outputs.labels }}
        cache-from: type=gha
        cache-to: type=gha,mode=max
    
    - name: Update Kubernetes manifests
      run: |
        IMAGE_TAG=$(echo ${{ github.sha }} | cut -c1-7)
        sed -i "s|image:.*|image: ${{ env.DOCKER_REGISTRY }}/${{ env.IMAGE_NAME }}:main-${IMAGE_TAG}|g" k8s/deployment.yaml
    
    - name: Commit and push changes
      run: |
        git config --global user.name 'GitHub Actions'
        git config --global user.email 'actions@github.com'
        git add k8s/deployment.yaml
        git commit -m "Update image to ${{ github.sha }}"
        git push

์ด ์›Œํฌํ”Œ๋กœ์šฐ๋Š”:
1. ์ฝ”๋“œ๋ฅผ ์ฒดํฌ์•„์›ƒํ•ด ๐Ÿ“ฅ
2. Docker ์ด๋ฏธ์ง€๋ฅผ ๋นŒ๋“œํ•˜๊ณ  ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ์— ํ‘ธ์‹œํ•ด ๐Ÿณ
3. Kubernetes ๋งค๋‹ˆํŽ˜์ŠคํŠธ์˜ ์ด๋ฏธ์ง€ ํƒœ๊ทธ๋ฅผ ์—…๋ฐ์ดํŠธํ•ด โœ๏ธ
4. ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ Git์— ์ปค๋ฐ‹ํ•ด ๐Ÿ“ค
5. ArgoCD๊ฐ€ ์ž๋™์œผ๋กœ ๊ฐ์ง€ํ•˜๊ณ  ๋ฐฐํฌํ•ด! ๐Ÿš€

Image Updater ์‚ฌ์šฉํ•˜๊ธฐ

๋งค๋ฒˆ ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋ฅผ ์ˆ˜๋™์œผ๋กœ ์—…๋ฐ์ดํŠธํ•˜๊ธฐ ๊ท€์ฐฎ๋‹ค๋ฉด? ArgoCD Image Updater๋ฅผ ์‚ฌ์šฉํ•ด! ๐Ÿค–

์„ค์น˜:

kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj-labs/argocd-image-updater/stable/manifests/install.yaml

Application์— ์–ด๋…ธํ…Œ์ด์…˜ ์ถ”๊ฐ€:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: nginx-app
  namespace: argocd
  annotations:
    argocd-image-updater.argoproj.io/image-list: nginx=nginx
    argocd-image-updater.argoproj.io/nginx.update-strategy: latest
    argocd-image-updater.argoproj.io/write-back-method: git
spec:
  # ... ๋‚˜๋จธ์ง€ ์„ค์ •

์ด์ œ ์ƒˆ ์ด๋ฏธ์ง€๊ฐ€ ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ์— ํ‘ธ์‹œ๋˜๋ฉด ์ž๋™์œผ๋กœ ๊ฐ์ง€ํ•˜๊ณ  ๋ฐฐํฌํ•ด! ์™„์ „ ์ž๋™ํ™”! ๐ŸŽ‰

๐Ÿ’ก ์žฌ๋Šฅ๋„ท ํ™œ์šฉ ํŒ: CI/CD ํŒŒ์ดํ”„๋ผ์ธ ๊ตฌ์ถ•์ด ์ฒ˜์Œ์ด๋ผ๋ฉด ์žฌ๋Šฅ๋„ท์—์„œ DevOps ์ „๋ฌธ๊ฐ€์˜ ๋„์›€์„ ๋ฐ›์•„๋ณด๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ! ์‹ค๋ฌด ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ ์ „๋ฌธ๊ฐ€๋“ค์ด ํ”„๋กœ์ ํŠธ์— ๋งž๋Š” ์ตœ์ ์˜ ํŒŒ์ดํ”„๋ผ์ธ์„ ์„ค๊ณ„ํ•ด์ค„ ์ˆ˜ ์žˆ์–ด. ๐ŸŽ“

๐Ÿ› ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ๊ฐ€์ด๋“œ

์‹ค๋ฌด์—์„œ ์ž์ฃผ ๋งˆ์ฃผ์น˜๋Š” ๋ฌธ์ œ๋“ค๊ณผ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•์„ ์ •๋ฆฌํ•ด๋ดค์–ด! ์ด๊ฑฐ ์•Œ์•„๋‘๋ฉด ์‚ฝ์งˆ ์‹œ๊ฐ„์„ ์—„์ฒญ ์ค„์ผ ์ˆ˜ ์žˆ์–ด. ๐Ÿ˜…

๋ฌธ์ œ 1: Application์ด OutOfSync ์ƒํƒœ์—์„œ ๋ฉˆ์ถค

์ฆ์ƒ: Git์— ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ํ‘ธ์‹œํ–ˆ๋Š”๋ฐ ArgoCD๊ฐ€ ๊ฐ์ง€๋ฅผ ๋ชป ํ•ด.

์›์ธ:
โ€ข Git ์ €์žฅ์†Œ ์—ฐ๊ฒฐ ๋ฌธ์ œ
โ€ข Webhook ์„ค์ • ๋ˆ„๋ฝ
โ€ข ํด๋ง ์ฃผ๊ธฐ๊ฐ€ ๋„ˆ๋ฌด ๊ธธ์–ด์„œ

ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•:

# 1. ์ €์žฅ์†Œ ์—ฐ๊ฒฐ ํ™•์ธ
argocd repo list

# 2. ์ˆ˜๋™์œผ๋กœ ๋ฆฌํ”„๋ ˆ์‹œ
argocd app get nginx-app --refresh

# 3. Webhook ์„ค์ • ํ™•์ธ (GitHub ์˜ˆ์ œ)
# Settings > Webhooks์—์„œ ๋‹ค์Œ URL ์ถ”๊ฐ€:
# https://argocd.yourdomain.com/api/webhook

# 4. ํด๋ง ์ฃผ๊ธฐ ์กฐ์ • (argocd-cm ConfigMap)
data:
  timeout.reconciliation: 60s  # ๊ธฐ๋ณธ๊ฐ’์€ 180s

๋ฌธ์ œ 2: Sync ์‹คํŒจ - "resource already exists"

์ฆ์ƒ: ๋™๊ธฐํ™” ์‹œ๋„ ์‹œ ๋ฆฌ์†Œ์Šค๊ฐ€ ์ด๋ฏธ ์กด์žฌํ•œ๋‹ค๋Š” ์—๋Ÿฌ

์›์ธ: kubectl๋กœ ์ง์ ‘ ์ƒ์„ฑํ•œ ๋ฆฌ์†Œ์Šค์™€ ์ถฉ๋Œ

ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•:

# 1. ๊ธฐ์กด ๋ฆฌ์†Œ์Šค ์‚ญ์ œ
kubectl delete deployment nginx-app -n default

# 2. ๋˜๋Š” ArgoCD๊ฐ€ ๊ด€๋ฆฌํ•˜๋„๋ก ์„ค์ •
kubectl label deployment nginx-app -n default \
  app.kubernetes.io/instance=nginx-app

# 3. Application์— force sync ์˜ต์…˜ ์ถ”๊ฐ€
argocd app sync nginx-app --force

๋ฌธ์ œ 3: ํ—ฌ์Šค ์ฒดํฌ ์‹คํŒจ - Progressing ์ƒํƒœ ์ง€์†

์ฆ์ƒ: ๋ฐฐํฌ๋Š” ์„ฑ๊ณตํ–ˆ๋Š”๋ฐ ๊ณ„์† Progressing ์ƒํƒœ

์›์ธ:
โ€ข Pod๊ฐ€ Ready ์ƒํƒœ๊ฐ€ ์•ˆ ๋จ
โ€ข Readiness Probe ์‹คํŒจ
โ€ข ์ด๋ฏธ์ง€ Pull ์‹คํŒจ

ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•:

# 1. Pod ์ƒํƒœ ํ™•์ธ
kubectl get pods -n default
kubectl describe pod <pod-name> -n default

# 2. ๋กœ๊ทธ ํ™•์ธ
kubectl logs <pod-name> -n default

# 3. ์ด๋ฒคํŠธ ํ™•์ธ
kubectl get events -n default --sort-by='.lastTimestamp'

# 4. ArgoCD์—์„œ ๋ฆฌ์†Œ์Šค ์ƒ์„ธ ๋ณด๊ธฐ
argocd app resources nginx-app

๋ฌธ์ œ 4: Private ์ €์žฅ์†Œ ์ธ์ฆ ์‹คํŒจ

์ฆ์ƒ: "authentication failed" ๋˜๋Š” "repository not found"

ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•:

# SSH ํ‚ค ๊ถŒํ•œ ํ™•์ธ
chmod 600 ~/.ssh/id_rsa

# Personal Access Token ๊ถŒํ•œ ํ™•์ธ
# GitHub: repo ์ „์ฒด ๊ถŒํ•œ ํ•„์š”
# GitLab: read_repository ๊ถŒํ•œ ํ•„์š”

# ์ €์žฅ์†Œ ์žฌ๋“ฑ๋ก
argocd repo rm git@github.com:your-org/your-repo.git
argocd repo add git@github.com:your-org/your-repo.git \
  --ssh-private-key-path ~/.ssh/id_rsa

# ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ
argocd repo get git@github.com:your-org/your-repo.git

๋ฌธ์ œ 5: ๋ฉ”๋ชจ๋ฆฌ ๋ถ€์กฑ์œผ๋กœ ArgoCD Pod ์žฌ์‹œ์ž‘

์ฆ์ƒ: argocd-application-controller๊ฐ€ OOMKilled

์›์ธ: ๊ด€๋ฆฌํ•˜๋Š” ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ๋„ˆ๋ฌด ๋งŽ๊ฑฐ๋‚˜ ํฐ ๋งค๋‹ˆํŽ˜์ŠคํŠธ

ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•:

# argocd-application-controller์˜ ๋ฆฌ์†Œ์Šค ์ฆ๊ฐ€
kubectl edit deployment argocd-application-controller -n argocd

# resources ์„น์…˜ ์ˆ˜์ •:
resources:
  requests:
    memory: "1Gi"
    cpu: "500m"
  limits:
    memory: "2Gi"
    cpu: "1000m"

# ๋˜๋Š” ์ƒค๋”ฉ ์„ค์ • (๋Œ€๊ทœ๋ชจ ํ™˜๊ฒฝ)
# argocd-cmd-params-cm ConfigMap์— ์ถ”๊ฐ€:
data:
  application.controller.replicas: "3"

๐Ÿ“š ์‹ค์ „ ์‹œ๋‚˜๋ฆฌ์˜ค: ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๋ฐฐํฌ

์ด๋ก ์€ ์ถฉ๋ถ„ํžˆ ๋ฐฐ์› ์œผ๋‹ˆ, ์‹ค์ œ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜๋ฅผ ArgoCD๋กœ ๋ฐฐํฌํ•˜๋Š” ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ์‚ดํŽด๋ณด์ž! ๐Ÿ—๏ธ

๊ฐ€์ƒ์˜ ์‡ผํ•‘๋ชฐ ์„œ๋น„์Šค๋ฅผ ์˜ˆ๋กœ ๋“ค๊ฒŒ:

๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜ API Gateway User Service ํšŒ์› ๊ด€๋ฆฌ ์ธ์ฆ/์ธ๊ฐ€ Product Service ์ƒํ’ˆ ๊ด€๋ฆฌ ์žฌ๊ณ  ๊ด€๋ฆฌ Order Service ์ฃผ๋ฌธ ์ฒ˜๋ฆฌ ๊ฒฐ์ œ ์—ฐ๋™ PostgreSQL User DB MongoDB Product DB Redis Cache / Session Message Queue (RabbitMQ) ๋น„๋™๊ธฐ ์ด๋ฒคํŠธ ์ฒ˜๋ฆฌ ์„œ๋น„์Šค ๊ฐ„ ํ†ต์‹ 

ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ

shopping-mall/
โ”œโ”€โ”€ apps/
โ”‚   โ”œโ”€โ”€ api-gateway/
โ”‚   โ”‚   โ”œโ”€โ”€ base/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ kustomization.yaml
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ deployment.yaml
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ service.yaml
โ”‚   โ”‚   โ””โ”€โ”€ overlays/
โ”‚   โ”‚       โ”œโ”€โ”€ dev/
โ”‚   โ”‚       โ”œโ”€โ”€ staging/
โ”‚   โ”‚       โ””โ”€โ”€ prod/
โ”‚   โ”œโ”€โ”€ user-service/
โ”‚   โ”‚   โ””โ”€โ”€ ... (๋™์ผ ๊ตฌ์กฐ)
โ”‚   โ”œโ”€โ”€ product-service/
โ”‚   โ”‚   โ””โ”€โ”€ ... (๋™์ผ ๊ตฌ์กฐ)
โ”‚   โ””โ”€โ”€ order-service/
โ”‚       โ””โ”€โ”€ ... (๋™์ผ ๊ตฌ์กฐ)
โ”œโ”€โ”€ infrastructure/
โ”‚   โ”œโ”€โ”€ postgres/
โ”‚   โ”œโ”€โ”€ mongodb/
โ”‚   โ”œโ”€โ”€ redis/
โ”‚   โ””โ”€โ”€ rabbitmq/
โ””โ”€โ”€ argocd/
    โ”œโ”€โ”€ projects/
    โ”‚   โ””โ”€โ”€ shopping-mall-project.yaml
    โ””โ”€โ”€ applications/
        โ”œโ”€โ”€ api-gateway.yaml
        โ”œโ”€โ”€ user-service.yaml
        โ”œโ”€โ”€ product-service.yaml
        โ””โ”€โ”€ order-service.yaml

ArgoCD Project ์ •์˜

๋จผ์ € ํ”„๋กœ์ ํŠธ๋ฅผ ๋งŒ๋“ค์–ด์„œ ๋ฆฌ์†Œ์Šค๋ฅผ ๋…ผ๋ฆฌ์ ์œผ๋กœ ๊ทธ๋ฃนํ™”ํ•˜์ž:

apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: shopping-mall
  namespace: argocd
spec:
  description: Shopping Mall Microservices
  
  # ๋ฐฐํฌ ๊ฐ€๋Šฅํ•œ ๋„ค์ž„์ŠคํŽ˜์ด์Šค ์ œํ•œ
  destinations:
  - namespace: 'shopping-mall-*'
    server: https://kubernetes.default.svc
  
  # ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ Git ์ €์žฅ์†Œ
  sourceRepos:
  - 'https://github.com/your-org/shopping-mall.git'
  
  # ๋ฐฐํฌ ๊ฐ€๋Šฅํ•œ ๋ฆฌ์†Œ์Šค ํƒ€์ž…
  clusterResourceWhitelist:
  - group: ''
    kind: Namespace
  - group: 'rbac.authorization.k8s.io'
    kind: ClusterRole
  - group: 'rbac.authorization.k8s.io'
    kind: ClusterRoleBinding
  
  # ๋„ค์ž„์ŠคํŽ˜์ด์Šค ๋ฆฌ์†Œ์Šค๋Š” ๋ชจ๋‘ ํ—ˆ์šฉ
  namespaceResourceWhitelist:
  - group: '*'
    kind: '*'
  
  # RBAC ์„ค์ •
  roles:
  - name: developer
    description: Developers can view and sync
    policies:
    - p, proj:shopping-mall:developer, applications, get, shopping-mall/*, allow
    - p, proj:shopping-mall:developer, applications, sync, shopping-mall/*, allow
    groups:
    - dev-team
  
  - name: operator
    description: Operators have full access
    policies:
    - p, proj:shopping-mall:operator, applications, *, shopping-mall/*, allow
    groups:
    - ops-team

Application of Applications ํŒจํ„ด

์—ฌ๋Ÿฌ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค๋ฅผ ํ•œ ๋ฒˆ์— ๊ด€๋ฆฌํ•˜๋ ค๋ฉด "App of Apps" ํŒจํ„ด์„ ์‚ฌ์šฉํ•ด! ๐ŸŽฏ

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: shopping-mall-apps
  namespace: argocd
spec:
  project: shopping-mall
  source:
    repoURL: https://github.com/your-org/shopping-mall.git
    targetRevision: HEAD
    path: argocd/applications
  destination:
    server: https://kubernetes.default.svc
    namespace: argocd
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
    - CreateNamespace=true

์ด์ œ argocd/applications/ ๋””๋ ‰ํ† ๋ฆฌ์— ๊ฐ ์„œ๋น„์Šค์˜ Application ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋ฅผ ๋„ฃ์œผ๋ฉด ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋ผ!

๊ฐœ๋ณ„ ์„œ๋น„์Šค Application ์˜ˆ์ œ

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: user-service-prod
  namespace: argocd
  finalizers:
  - resources-finalizer.argocd.argoproj.io
spec:
  project: shopping-mall
  source:
    repoURL: https://github.com/your-org/shopping-mall.git
    targetRevision: HEAD
    path: apps/user-service/overlays/prod
  destination:
    server: https://kubernetes.default.svc
    namespace: shopping-mall-prod
  syncPolicy:
    automated:
      prune: false  # ํ”„๋กœ๋•์…˜์€ ์ˆ˜๋™ ์‚ญ์ œ
      selfHeal: true
    syncOptions:
    - CreateNamespace=true
    retry:
      limit: 5
      backoff:
        duration: 5s
        factor: 2
        maxDuration: 3m
  ignoreDifferences:
  - group: apps
    kind: Deployment
    jsonPointers:
    - /spec/replicas  # HPA๊ฐ€ ๊ด€๋ฆฌํ•˜๋ฏ€๋กœ ๋ฌด์‹œ

์„œ๋น„์Šค ๊ฐ„ ์˜์กด์„ฑ ๊ด€๋ฆฌ

์„œ๋น„์Šค ๋ฐฐํฌ ์ˆœ์„œ๊ฐ€ ์ค‘์š”ํ•  ๋•Œ๊ฐ€ ์žˆ์ง€? Sync Waves๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์ˆœ์„œ๋ฅผ ์ œ์–ดํ•  ์ˆ˜ ์žˆ์–ด! ๐ŸŒŠ

# infrastructure/postgres/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: postgres
  annotations:
    argocd.argoproj.io/sync-wave: "0"  # ๊ฐ€์žฅ ๋จผ์ € ๋ฐฐํฌ
spec:
  # ...

# apps/user-service/base/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: user-service
  annotations:
    argocd.argoproj.io/sync-wave: "1"  # DB ๋‹ค์Œ์— ๋ฐฐํฌ
spec:
  # ...

# apps/api-gateway/base/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: api-gateway
  annotations:
    argocd.argoproj.io/sync-wave: "2"  # ๋งˆ์ง€๋ง‰์— ๋ฐฐํฌ
spec:
  # ...

Sync Wave ๋ฒˆํ˜ธ๊ฐ€ ๋‚ฎ์„์ˆ˜๋ก ๋จผ์ € ๋ฐฐํฌ๋ผ. ๊ฐ™์€ ๋ฒˆํ˜ธ๋Š” ๋ณ‘๋ ฌ๋กœ ๋ฐฐํฌ๋˜๊ณ ! ๐Ÿ“Š

๐ŸŽ“ ๊ณ ๊ธ‰ ๊ธฐ๋Šฅ: Progressive Delivery

์นด๋‚˜๋ฆฌ ๋ฐฐํฌ๋‚˜ ๋ธ”๋ฃจ-๊ทธ๋ฆฐ ๋ฐฐํฌ ๊ฐ™์€ ๊ณ ๊ธ‰ ๋ฐฐํฌ ์ „๋žต์„ ์‚ฌ์šฉํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด? Argo Rollouts๋ฅผ ํ•จ๊ป˜ ์‚ฌ์šฉํ•˜๋ฉด ๋ผ! ๐Ÿšข

Argo Rollouts ์„ค์น˜

kubectl create namespace argo-rollouts
kubectl apply -n argo-rollouts -f https://github.com/argoproj/argo-rollouts/releases/latest/download/install.yaml

์นด๋‚˜๋ฆฌ ๋ฐฐํฌ ์˜ˆ์ œ

apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
  name: user-service
spec:
  replicas: 10
  strategy:
    canary:
      steps:
      - setWeight: 10  # 10%์˜ ํŠธ๋ž˜ํ”ฝ์„ ์ƒˆ ๋ฒ„์ „์œผ๋กœ
      - pause: {duration: 5m}  # 5๋ถ„ ๋Œ€๊ธฐ
      - setWeight: 30
      - pause: {duration: 5m}
      - setWeight: 50
      - pause: {duration: 5m}
      - setWeight: 80
      - pause: {duration: 5m}
      # ๋ฌธ์ œ์—†์œผ๋ฉด 100% ์ „ํ™˜
      
      # ์ž๋™ ๋กค๋ฐฑ ์„ค์ •
      analysis:
        templates:
        - templateName: success-rate
        startingStep: 2
        args:
        - name: service-name
          value: user-service
      
      # ํŠธ๋ž˜ํ”ฝ ๋ผ์šฐํŒ… (Istio ์‚ฌ์šฉ ์‹œ)
      trafficRouting:
        istio:
          virtualService:
            name: user-service
            routes:
            - primary
  
  selector:
    matchLabels:
      app: user-service
  
  template:
    metadata:
      labels:
        app: user-service
    spec:
      containers:
      - name: user-service
        image: your-registry/user-service:v2.0.0
        ports:
        - containerPort: 8080

๋ถ„์„ ํ…œํ”Œ๋ฆฟ (์ž๋™ ๋กค๋ฐฑ ์กฐ๊ฑด)

apiVersion: argoproj.io/v1alpha1
kind: AnalysisTemplate
metadata:
  name: success-rate
spec:
  args:
  - name: service-name
  metrics:
  - name: success-rate
    interval: 1m
    successCondition: result[0] >= 0.95
    failureLimit: 3
    provider:
      prometheus:
        address: http://prometheus.monitoring:9090
        query: |
          sum(rate(
            http_requests_total{
              service="{{args.service-name}}",
              status=~"2.."
            }[5m]
          )) /
          sum(rate(
            http_requests_total{
              service="{{args.service-name}}"
            }[5m]
          ))

์ด๋ ‡๊ฒŒ ์„ค์ •ํ•˜๋ฉด:
โ€ข ์ƒˆ ๋ฒ„์ „์„ ์ ์ง„์ ์œผ๋กœ ๋ฐฐํฌํ•ด ๐Ÿฃ
โ€ข ๊ฐ ๋‹จ๊ณ„๋งˆ๋‹ค ์„ฑ๊ณต๋ฅ ์„ ์ฒดํฌํ•ด ๐Ÿ“Š
โ€ข ์„ฑ๊ณต๋ฅ ์ด 95% ๋ฏธ๋งŒ์ด๋ฉด ์ž๋™ ๋กค๋ฐฑ! ๐Ÿ”™
โ€ข ๋ฌธ์ œ์—†์œผ๋ฉด ์ž๋™์œผ๋กœ 100% ์ „ํ™˜! โœ…

๋ธ”๋ฃจ-๊ทธ๋ฆฐ ๋ฐฐํฌ

apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
  name: product-service
spec:
  replicas: 5
  strategy:
    blueGreen:
      activeService: product-service-active
      previewService: product-service-preview
      autoPromotionEnabled: false  # ์ˆ˜๋™ ์Šน์ธ
      scaleDownDelaySeconds: 300  # ์ด์ „ ๋ฒ„์ „ 5๋ถ„ ํ›„ ์‚ญ์ œ
  
  selector:
    matchLabels:
      app: product-service
  
  template:
    metadata:
      labels:
        app: product-service
    spec:
      containers:
      - name: product-service
        image: your-registry/product-service:v2.0.0
        ports:
        - containerPort: 8080

๋ธ”๋ฃจ-๊ทธ๋ฆฐ ๋ฐฐํฌ๋Š”:
โ€ข ์ƒˆ ๋ฒ„์ „(Green)์„ ์™„์ „ํžˆ ๋ฐฐํฌํ•œ ํ›„ ๐ŸŸข
โ€ข ํ”„๋ฆฌ๋ทฐ ์„œ๋น„์Šค๋กœ ํ…Œ์ŠคํŠธํ•˜๊ณ  ๐Ÿงช
โ€ข ๋ฌธ์ œ์—†์œผ๋ฉด ํŠธ๋ž˜ํ”ฝ์„ ํ•œ ๋ฒˆ์— ์ „ํ™˜ํ•ด ๐Ÿ”„
โ€ข ์ด์ „ ๋ฒ„์ „(Blue)์€ ์ผ์ • ์‹œ๊ฐ„ ์œ ์ง€ ํ›„ ์‚ญ์ œ ๐Ÿ”ต

๐Ÿ’ก ์–ธ์ œ ์–ด๋–ค ์ „๋žต์„ ์“ธ๊นŒ? ์นด๋‚˜๋ฆฌ ๋ฐฐํฌ: ์ ์ง„์ ์œผ๋กœ ์œ„ํ—˜์„ ์ค„์ด๊ณ  ์‹ถ์„ ๋•Œ. ์‚ฌ์šฉ์ž ์˜ํ–ฅ ์ตœ์†Œํ™”! ๐Ÿค
๋ธ”๋ฃจ-๊ทธ๋ฆฐ ๋ฐฐํฌ: ๋น ๋ฅธ ๋กค๋ฐฑ์ด ์ค‘์š”ํ•  ๋•Œ. ์ฆ‰์‹œ ์ด์ „ ๋ฒ„์ „์œผ๋กœ ๋ณต๊ตฌ ๊ฐ€๋Šฅ! ๐Ÿ”ต๐ŸŸข
์ผ๋ฐ˜ Rolling Update: ๊ฐ„๋‹จํ•œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜, ๋‹ค์šดํƒ€์ž„ ํ—ˆ์šฉ ๊ฐ€๋Šฅํ•  ๋•Œ ๐Ÿ“ฆ

๐Ÿ“ˆ ์„ฑ๋Šฅ ์ตœ์ ํ™” ํŒ

ArgoCD๋ฅผ ๋Œ€๊ทœ๋ชจ๋กœ ์šด์˜ํ•  ๋•Œ ์„ฑ๋Šฅ ์ตœ์ ํ™”๊ฐ€ ์ค‘์š”ํ•ด! ์‹ค์ „ ํŒ๋“ค์„ ๊ณต์œ ํ• ๊ฒŒ. ๐Ÿš€

1. ๋ฆฌ์†Œ์Šค ์ œํ•œ ์กฐ์ •

์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ๋งŽ์•„์ง€๋ฉด ArgoCD ์ปดํฌ๋„ŒํŠธ์˜ ๋ฆฌ์†Œ์Šค๋ฅผ ๋Š˜๋ ค์ค˜์•ผ ํ•ด:

# argocd-application-controller
resources:
  requests:
    memory: "2Gi"
    cpu: "1000m"
  limits:
    memory: "4Gi"
    cpu: "2000m"

# argocd-repo-server
resources:
  requests:
    memory: "1Gi"
    cpu: "500m"
  limits:
    memory: "2Gi"
    cpu: "1000m"

2. ๋™๊ธฐํ™” ์ฃผ๊ธฐ ์ตœ์ ํ™”

๋ถˆํ•„์š”ํ•˜๊ฒŒ ์ž์ฃผ ๋™๊ธฐํ™”ํ•˜๋ฉด ๋ฆฌ์†Œ์Šค ๋‚ญ๋น„์•ผ:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
data:
  # ๊ธฐ๋ณธ 3๋ถ„์—์„œ 5๋ถ„์œผ๋กœ ์ฆ๊ฐ€
  timeout.reconciliation: 300s
  
  # Git ํด๋ง ์ฃผ๊ธฐ (Webhook ์‚ฌ์šฉ ์‹œ ๊ธธ๊ฒŒ ์„ค์ •)
  timeout.reconciliation.jitter: 30s

3. ๋ฆฌ์†Œ์Šค ์ œ์™ธ ์„ค์ •

์ž์ฃผ ๋ณ€๊ฒฝ๋˜๋Š” ๋ฆฌ์†Œ์Šค๋Š” ArgoCD๊ฐ€ ๋ฌด์‹œํ•˜๋„๋ก ์„ค์ •:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
data:
  resource.exclusions: |
    - apiGroups:
      - "*"
      kinds:
      - Event
      - Pod
      clusters:
      - "*"
  
  # HPA๊ฐ€ ๊ด€๋ฆฌํ•˜๋Š” replicas ๋ฌด์‹œ
  resource.compareoptions: |
    ignoreAggregatedRoles: true
    ignoreResourceStatusField: all

4. ์ƒค๋”ฉ (Sharding) ์„ค์ •

์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด 100๊ฐœ ์ด์ƒ์ด๋ฉด ์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ์—ฌ๋Ÿฌ ๊ฐœ๋กœ ๋ถ„์‚ฐ:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cmd-params-cm
  namespace: argocd
data:
  # 3๊ฐœ์˜ ์ƒค๋“œ๋กœ ๋ถ„์‚ฐ
  application.controller.replicas: "3"
  
  # ๊ฐ ์ƒค๋“œ๊ฐ€ ์ฒ˜๋ฆฌํ•  ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ˆ˜
  application.controller.shard.replicas: "3"

5. Redis ์บ์‹œ ์ตœ์ ํ™”

Git ์ €์žฅ์†Œ ์บ์‹œ๋ฅผ ๋Š˜๋ ค์„œ ์„ฑ๋Šฅ ํ–ฅ์ƒ:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
data:
  # ์บ์‹œ ํฌ๊ธฐ ์ฆ๊ฐ€ (๊ธฐ๋ณธ 1GB)
  repository.credentials.cache.expiration: 24h
  
  # Redis ๋ฉ”๋ชจ๋ฆฌ ์ฆ๊ฐ€
  redis.max.memory: 2gb
  redis.max.memory.policy: allkeys-lru

๐ŸŒ ๋ฉ€ํ‹ฐ ํด๋Ÿฌ์Šคํ„ฐ ๊ด€๋ฆฌ

์—ฌ๋Ÿฌ Kubernetes ํด๋Ÿฌ์Šคํ„ฐ๋ฅผ ๊ด€๋ฆฌํ•ด์•ผ ํ•œ๋‹ค๋ฉด? ArgoCD ํ•˜๋‚˜๋กœ ๋ชจ๋‘ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด! ๐ŸŒ

ํด๋Ÿฌ์Šคํ„ฐ ์ถ”๊ฐ€ํ•˜๊ธฐ

# kubeconfig ์ปจํ…์ŠคํŠธ ํ™•์ธ
kubectl config get-contexts

# ์ƒˆ ํด๋Ÿฌ์Šคํ„ฐ ์ถ”๊ฐ€
argocd cluster add prod-cluster-context \
  --name prod-cluster \
  --server https://prod-k8s-api.example.com

# ํด๋Ÿฌ์Šคํ„ฐ ๋ชฉ๋ก ํ™•์ธ
argocd cluster list

ํด๋Ÿฌ์Šคํ„ฐ๋ณ„ Application ๋ฐฐํฌ

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: user-service-prod-us
  namespace: argocd
spec:
  project: shopping-mall
  source:
    repoURL: https://github.com/your-org/shopping-mall.git
    targetRevision: HEAD
    path: apps/user-service/overlays/prod
  destination:
    # ๋ฏธ๊ตญ ํด๋Ÿฌ์Šคํ„ฐ
    server: https://prod-us-k8s-api.example.com
    namespace: shopping-mall-prod
  syncPolicy:
    automated:
      selfHeal: true

---
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: user-service-prod-eu
  namespace: argocd
spec:
  project: shopping-mall
  source:
    repoURL: https://github.com/your-org/shopping-mall.git
    targetRevision: HEAD
    path: apps/user-service/overlays/prod
  destination:
    # ์œ ๋Ÿฝ ํด๋Ÿฌ์Šคํ„ฐ
    server: https://prod-eu-k8s-api.example.com
    namespace: shopping-mall-prod
  syncPolicy:
    automated:
      selfHeal: true

ApplicationSet์œผ๋กœ ์ž๋™ํ™”

์—ฌ๋Ÿฌ ํด๋Ÿฌ์Šคํ„ฐ์— ๋™์ผํ•œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋ฐฐํฌํ•  ๋•Œ๋Š” ApplicationSet์„ ์‚ฌ์šฉํ•˜๋ฉด ํŽธํ•ด! ๐ŸŽฏ

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: user-service-global
  namespace: argocd
spec:
  generators:
  - list:
      elements:
      - cluster: prod-us
        url: https://prod-us-k8s-api.example.com
        region: us-east-1
      - cluster: prod-eu
        url: https://prod-eu-k8s-api.example.com
        region: eu-west-1
      - cluster: prod-asia
        url: https://prod-asia-k8s-api.example.com
        region: ap-northeast-2
  
  template:
    metadata:
      name: 'user-service-{{cluster}}'
    spec:
      project: shopping-mall
      source:
        repoURL: https://github.com/your-org/shopping-mall.git
        targetRevision: HEAD
        path: apps/user-service/overlays/prod
        helm:
          parameters:
          - name: region
            value: '{{region}}'
      destination:
        server: '{{url}}'
        namespace: shopping-mall-prod
      syncPolicy:
        automated:
          selfHeal: true

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ํด๋Ÿฌ์Šคํ„ฐ๋ฅผ ์ถ”๊ฐ€ํ•  ๋•Œ๋งˆ๋‹ค ์ž๋™์œผ๋กœ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ์ƒ์„ฑ๋ผ! ์™„์ „ ์ž๋™ํ™”! ๐Ÿค–

๐ŸŽ‰ ๋งˆ๋ฌด๋ฆฌํ•˜๋ฉฐ

์™€! ์—ฌ๊ธฐ๊นŒ์ง€ ์ฝ์—ˆ๋‹ค๋ฉด ์ •๋ง ๋Œ€๋‹จํ•ด! ๐Ÿ‘

ArgoCD๋ฅผ ์‚ฌ์šฉํ•œ GitOps ๋ฐฐํฌ ์ž๋™ํ™”์— ๋Œ€ํ•ด ์ •๋ง ๋งŽ์€ ๊ฑธ ๋‹ค๋ค˜์–ด:

โœ… GitOps์˜ ๊ฐœ๋…๊ณผ ArgoCD์˜ ์žฅ์ 
โœ… ์„ค์น˜๋ถ€ํ„ฐ ์ฒซ ๋ฐฐํฌ๊นŒ์ง€ ๋‹จ๊ณ„๋ณ„ ๊ฐ€์ด๋“œ
โœ… ๋ฉ€ํ‹ฐ ํ™˜๊ฒฝ ๊ด€๋ฆฌ์™€ Kustomize/Helm ํ†ตํ•ฉ
โœ… ๋ณด์•ˆ ๊ฐ•ํ™”์™€ RBAC ์„ค์ •
โœ… ๋ชจ๋‹ˆํ„ฐ๋ง๊ณผ ์•Œ๋ฆผ ์‹œ์Šคํ…œ ๊ตฌ์ถ•
โœ… CI/CD ํŒŒ์ดํ”„๋ผ์ธ ํ†ตํ•ฉ
โœ… ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ๊ฐ€์ด๋“œ
โœ… ์‹ค์ „ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๋ฐฐํฌ ์‹œ๋‚˜๋ฆฌ์˜ค
โœ… Progressive Delivery์™€ ๊ณ ๊ธ‰ ๋ฐฐํฌ ์ „๋žต
โœ… ์„ฑ๋Šฅ ์ตœ์ ํ™”์™€ ๋ฉ€ํ‹ฐ ํด๋Ÿฌ์Šคํ„ฐ ๊ด€๋ฆฌ

์ด์ œ ๋„ˆ๋„ ArgoCD ์ „๋ฌธ๊ฐ€๊ฐ€ ๋œ ๊ฑฐ์•ผ! ๐ŸŽ“

์‹ค๋ฌด์—์„œ ArgoCD๋ฅผ ๋„์ž…ํ•˜๋ฉด:
โ€ข ๋ฐฐํฌ ์‹œ๊ฐ„์ด ํš๊ธฐ์ ์œผ๋กœ ์ค„์–ด๋“ค์–ด โฑ๏ธ
โ€ข ๋ฐฐํฌ ํžˆ์Šคํ† ๋ฆฌ๊ฐ€ Git์— ๋ชจ๋‘ ๊ธฐ๋ก๋ผ ๐Ÿ“š
โ€ข ๋กค๋ฐฑ์ด ํด๋ฆญ ํ•œ ๋ฒˆ์œผ๋กœ ๊ฐ€๋Šฅํ•ด ๐Ÿ”™
โ€ข ํŒ€์›๋“ค๊ณผ ํ˜‘์—…์ด ํ›จ์”ฌ ์ˆ˜์›”ํ•ด์ ธ ๐Ÿค
โ€ข ์žฌํ•ด ๋ณต๊ตฌ๊ฐ€ ๊ฐ„๋‹จํ•ด์ ธ ๐Ÿ›ก๏ธ

ํ˜น์‹œ ArgoCD ๊ตฌ์ถ•์ด๋‚˜ GitOps ์ „ํ™˜์ด ๋ง‰๋ง‰ํ•˜๋‹ค๋ฉด, ์žฌ๋Šฅ๋„ท์—์„œ DevOps ์ „๋ฌธ๊ฐ€์˜ ๋„์›€์„ ๋ฐ›์•„๋ณด๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ! ์‹ค๋ฌด ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ ์ „๋ฌธ๊ฐ€๋“ค์ด ํ”„๋กœ์ ํŠธ์— ๋งž๋Š” ์ตœ์ ์˜ ์†”๋ฃจ์…˜์„ ์ œ์‹œํ•ด์ค„ ์ˆ˜ ์žˆ๊ฑฐ๋“ . ๐Ÿ’ผ

์ž, ์ด์ œ ์‹ค์ „์— ์ ์šฉํ•ด๋ณผ ์‹œ๊ฐ„์ด์•ผ! ์ž‘์€ ํ”„๋กœ์ ํŠธ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด์„œ ์ ์ฐจ ํ™•์žฅํ•ด๋‚˜๊ฐ€๋ฉด ๋ผ. ์ฒ˜์Œ์—” ์–ด๋ ค์›Œ ๋ณด์—ฌ๋„ ํ•œ ๋ฒˆ ์ต์ˆ™ํ•ด์ง€๋ฉด ArgoCD ์—†์ด๋Š” ๋ชป ์‚ด๊ฒŒ ๋  ๊ฑฐ์•ผ! ๐Ÿ˜„

๊ถ๊ธˆํ•œ ์ ์ด ์žˆ๊ฑฐ๋‚˜ ๋ฌธ์ œ๊ฐ€ ์ƒ๊ธฐ๋ฉด ArgoCD ๊ณต์‹ ๋ฌธ์„œ์™€ ์ปค๋ฎค๋‹ˆํ‹ฐ๋ฅผ ํ™œ์šฉํ•ด๋ด. Slack ์ฑ„๋„๋„ ํ™œ๋ฐœํ•˜๊ณ  GitHub Issues๋„ ์นœ์ ˆํ•˜๊ฒŒ ๋‹ต๋ณ€ํ•ด์ค˜!

ํ–‰๋ณตํ•œ ๋ฐฐํฌ ๋˜๊ธธ ๋ฐ”๋ผ! Happy GitOps! ๐Ÿš€โœจ

๐ŸŽฏ ํ•ต์‹ฌ ์š”์•ฝ

GitOps = Git + Operations
๋ชจ๋“  ์ธํ”„๋ผ๋ฅผ ์ฝ”๋“œ๋กœ ๊ด€๋ฆฌํ•˜๊ณ , Git์„ ๋‹จ์ผ ์ง„์‹ค ๊ณต๊ธ‰์›์œผ๋กœ!

ArgoCD = GitOps์˜ ์ตœ๊ฐ• ๋„๊ตฌ
์ž๋™ ๋™๊ธฐํ™”, ์ง๊ด€์  UI, ๊ฐ•๋ ฅํ•œ RBAC, ๋ฉ€ํ‹ฐ ํด๋Ÿฌ์Šคํ„ฐ ์ง€์›!

์‹ค์ „ ์ ์šฉ = ์ ์ง„์  ํ™•์žฅ
์ž‘์€ ํ”„๋กœ์ ํŠธ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด์„œ ๋‹จ๊ณ„๋ณ„๋กœ ๊ธฐ๋Šฅ์„ ์ถ”๊ฐ€ํ•˜์ž!

๋Œ“๊ธ€ ์ž‘์„ฑ

์ด ๊ธ€์— ๋Œ€ํ•œ ์—ฌ๋Ÿฌ๋ถ„์˜ ์ƒ๊ฐ์„ ๋“ค๋ ค์ฃผ์„ธ์š”

๋Œ“๊ธ€ 0
๋Œ“๊ธ€์„ ๋ถˆ๋Ÿฌ์˜ค๋Š” ์ค‘์ž…๋‹ˆ๋‹ค.

์•„์ง ๋Œ“๊ธ€์ด ์—†์Šต๋‹ˆ๋‹ค.