Files

Mayne0213 9763b1e682 INIT(repo): apps setup with all user-facing servic

2025-12-17 15:11:34 +09:00

3.4 KiB

Raw Blame History

sidebar_position

sidebar_position
2

ArgoCD

Overview

ArgoCD is our GitOps continuous delivery tool. It automatically synchronizes applications from our Git repository to Kubernetes.

How It Works

graph LR
    A[Git Repository] -->|Watch| B[ArgoCD]
    B -->|Compare| C[Desired State]
    B -->|Compare| D[Actual State in K8s]
    B -->|Sync| E[Deploy Changes]

Application Structure

Each service has an ArgoCD Application definition:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: example-service
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://gitea0213.kro.kr/bluemayne/infrastructure.git
    targetRevision: main
    path: example-service
  destination:
    server: https://kubernetes.default.svc
    namespace: example-service
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

Key Features

Automated Sync

prune: true: Removes resources deleted from Git
selfHeal: true: Reverts manual changes to match Git
allowEmpty: false: Prevents accidental empty deployments

Manual Operations

# List applications
sudo kubectl get applications -n argocd

# View application status
sudo kubectl get application -n argocd <app-name> -o yaml

# Force refresh
argocd app get <app-name> --refresh

Deployment Workflow

1. Make Changes

Edit files in the infrastructure repository:

cd /path/to/infrastructure
vim example-service/deployment.yaml
git add .
git commit -m "update deployment"
git push

2. ArgoCD Detects Changes

Polls Git repository every 3 minutes
Or immediately via webhook (if configured)

3. Automatic Sync

Compares desired state (Git) vs actual state (K8s)
Applies changes automatically
Reports status

4. Monitor Deployment

# Check application sync status
sudo kubectl get applications -n argocd

# Watch pod rollout
sudo kubectl rollout status deployment/<name> -n <namespace>

Common Patterns

Adding a New Service

Create service directory: infrastructure/my-service/
Add Kubernetes manifests
Create kustomization.yaml
Add ArgoCD Application: infrastructure/my-service/argocd/my-service.yaml
Reference in main kustomization.yaml
Git push → ArgoCD deploys automatically

Updating a Service

Edit deployment.yaml or other files
Git commit & push
Wait for ArgoCD sync (or force refresh)
Verify deployment

Rolling Back

# Method 1: Git revert
git revert <commit-hash>
git push

# Method 2: Sync to specific commit
argocd app sync <app-name> --revision <commit-hash>

Troubleshooting

Sync Stuck

# Force hard refresh
sudo kubectl patch application -n argocd <app-name> \
  -p '{"metadata": {"annotations": {"argocd.argoproj.io/refresh": "hard"}}}' \
  --type merge

Out of Sync

Check what's different:

argocd app diff <app-name>

Sync Failed

View detailed error:

sudo kubectl describe application -n argocd <app-name>

Best Practices

Always use Git: Don't make manual kubectl changes
Small commits: Easier to review and rollback
Test locally: Use kubectl apply --dry-run=client
Use pruning: Keep cluster clean with prune: true
Enable selfHeal: Prevent configuration drift

3.4 KiB Raw Blame History