EKS + Argo CD GitOps ハンズオン

eksctl は EKS クラスターを簡単に作成・管理できる CLI ツールです。

# macOS / Linux
curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz"
tar -xzf eksctl_$(uname -s)_amd64.tar.gz
sudo mv eksctl /usr/local/bin/
eksctl version

# Windows（PowerShell）
choco install eksctl

以下のコマンドで EKS クラスターを作成します（作成に 15〜20 分かかります）。

eksctl create cluster \
  --name gitops-handson \
  --version 1.33 \
  --region ap-northeast-1 \
  --nodegroup-name workers \
  --node-type t3.medium \
  --nodes 2 \
  --managed

aws eks update-kubeconfig --name <クラスター名> --region ap-northeast-1

kubectl cluster-info
kubectl get nodes

kubectl create namespace argocd

公式の stable マニフェストを適用します。

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

kubectl -n argocd rollout status deployment/argocd-server
kubectl get pods -n argocd

すべての Pod が Running になるまで 2〜3 分待ちます。

Argo CD の初期管理者パスワードは Secret に格納されています。

# Linux / macOS
kubectl -n argocd get secret argocd-initial-admin-secret \
  -o jsonpath="{.data.password}" | base64 -d; echo

# Windows PowerShell
$encoded = kubectl -n argocd get secret argocd-initial-admin-secret `
  -o jsonpath="{.data.password}"
[System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($encoded))

表示されたパスワードをメモしてください。

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

ブラウザで https://localhost:8080 を開きます（証明書の警告は「詳細設定」→「続行」で進んでください）。

ブラウザで以下の URL を開き、画面右上の 「Fork」 をクリックして自分のアカウントにフォークします。

URL: https://github.com/argoproj/argocd-example-apps

「Create fork」をクリックします。

フォーク後、guestbook/ ディレクトリを確認します。これがサンプルアプリ（Guestbook）のマニフェストです。

guestbook/
├── guestbook-ui-deployment.yaml   # Deployment
└── guestbook-ui-svc.yaml          # Service

フォークしたリポジトリの HTTPS URL をメモします。

Argo CD UI（https://localhost:8080）を開き、「+ NEW APP」 をクリックします。

「AUTO-CREATE NAMESPACE」と「SELF HEAL」にもチェックを入れます。

「CREATE」 をクリックします。

Argo CD UI でアプリが Synced・Healthy になるまで待ちます（通常 1〜2 分）。

# CLI でも確認できます
kubectl get pods -n guestbook
kubectl get svc -n guestbook

git clone https://github.com/<ユーザー名>/argocd-example-apps.git
cd argocd-example-apps

guestbook/guestbook-ui-deployment.yaml をエディタで開き、replicas を 1 から 3 に変更します。

spec:
  replicas: 3   # 1 から 3 に変更

git add guestbook/guestbook-ui-deployment.yaml
git commit -m "scale guestbook to 3 replicas"
git push origin main

Argo CD UI に戻り、guestbook Application をクリックします。約 30 秒〜1 分後に自動的に同期が始まり、Pod が 3 つになります。

# ターミナルで確認
kubectl get pods -n guestbook -w

Git を経由せずに直接 kubectl でレプリカ数を 0 に変更します（本来は禁止される操作）。

kubectl scale deployment guestbook-ui -n guestbook --replicas=0

Argo CD UI を観察します。Application が一時的に OutOfSync になり、Self-Heal が有効なため数秒〜30 秒以内に自動的に Synced に戻ります。

# Pod が 0 → 3 に戻るのを観察
kubectl get pods -n guestbook -w

最も推奨される方法です。Git の履歴を書き換えずにリバートコミットを作成します。

git log --oneline -5

# 前のコミットに戻す
git revert HEAD --no-edit
git push origin main

Argo CD が自動的にレプリカ数を 1 に戻します。

Argo CD UI を使って以前の同期済み状態に戻す方法です（緊急対応時に有用）。

1. Application をクリックして詳細画面を開く
2. 右上の 「HISTORY AND ROLLBACK」 をクリック
3. ロールバックしたいリビジョンを選択
4. 「Rollback」 をクリック

kubectl delete application guestbook -n argocd

または Argo CD UI で Application を選択 → 「DELETE」 をクリック（「Also delete resources」にチェックを入れると guestbook namespace も削除されます）。

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

kubectl delete namespace guestbook

eksctl delete cluster --name gitops-handson --region ap-northeast-1

削除には 10〜15 分かかります。完了まで待ちます。

EKS コンソール・EC2 コンソール（ノード確認）・CloudFormation コンソール（eksctl が作成したスタック確認）でリソースが削除されていることを確認します。