<初心者向け>ローカル環境でKubernetesクラスタを構築し、Argo CDでGitOpsデプロイを体験してみた

# kind（Kubernetes in Docker）をインストール
# ローカルPCにDockerコンテナを使って軽量なKubernetesクラスタを作れるツール
brew install kind

# kubectl（クーベシーティーエル）をインストール
# Kubernetesクラスタに命令を送るための公式CLI。Podの作成・削除・ログ確認など何でもできる
brew install kubectl

# Argo CD CLIをインストール
# Argo CDの操作をターミナルから行うためのCLI
brew install argocd

# kindのバージョンを表示
kind version

# kubectlのバージョンを表示
# --client を付けることで、クラスタに接続せずCLI自身のバージョンだけを表示する
# （まだクラスタを作っていないので、--client がないとエラーになる）
kubectl version --client

# Argo CD CLIのバージョンを表示
# --client を付ける理由はkubectlと同じ
argocd version --client

# このファイルがkindのクラスタ設定であることを示す
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
  # control-plane = マスターノード（クラスタ全体を管理する司令塔）
  # kindではこの1台がワーカーノード（実際にアプリが動く場所）も兼務する
  - role: control-plane
    kubeadmConfigPatches:
      - |
        kind: InitConfiguration
        nodeRegistration:
          kubeletExtraArgs:
            # Ingress Controllerがこのノードで動けるように目印（ラベル）を付ける
            node-labels: "ingress-ready=true"
    # extraPortMappings = DockerコンテナのポートをローカルPCに公開する設定
    # これがないと、ローカルPCのブラウザやcurlからクラスタ内のアプリにアクセスできない
    extraPortMappings:
      # ポート80（HTTP）をローカルPCに公開 → curlやブラウザでアクセスできるようになる
      - containerPort: 80
        hostPort: 80
        protocol: TCP
      # ポート443（HTTPS）をローカルPCに公開
      - containerPort: 443
        hostPort: 443
        protocol: TCP
      # ポート30080はNodePort用（Ingress導入前のアクセス手段として残しておく）
      - containerPort: 30080
        hostPort: 30080
        protocol: TCP

# kindクラスタを作成する
# --name k8s-learn → クラスタに「k8s-learn」という名前を付ける
# --config kind-config.yaml → 上で作った設定ファイルを使う
kind create cluster --name k8s-learn --config kind-config.yaml

# クラスタが正常に作成されたか確認する
# --context kind-k8s-learn → kindが自動で作成したコンテキスト名を指定
# （コンテキスト = 「どのクラスタに接続するか」という設定のこと）
kubectl cluster-info --context kind-k8s-learn

# NGINX Ingress Controllerをインストール
# Ingress Controller = 外部からのHTTPリクエストを受け取り、クラスタ内の適切なサービスに振り分ける門番
# kind専用のマニフェストを使う（クラウド版とはLoadBalancerの扱いが異なるため）
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/kind/deploy.yaml

# Ingress ControllerのPodが起動するまで待つ（最大5分）
# --for=condition=ready → Podが「準備完了」状態になるまで待機する
kubectl wait --namespace ingress-nginx \
  --for=condition=ready pod \
  --selector=app.kubernetes.io/component=controller \
  --timeout=300s

mkdir -p k8s/base

apiVersion: v1
kind: Namespace
metadata:
  name: test

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test-app
  namespace: test
spec:
  replicas: 2
  selector:
    matchLabels:
      app: test-app
  template:
    metadata:
      labels:
        app: test-app
    spec:
      containers:
        - name: nginx
          image: nginx:latest
          ports:
            - containerPort: 80

apiVersion: v1
kind: Service
metadata:
  name: test-app
  namespace: test
spec:
  selector:
    app: test-app
  ports:
    - port: 80
      targetPort: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: test-app
  namespace: test
spec:
  ingressClassName: nginx
  rules:
    - http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: test-app
                port:
                  number: 80

# k8s/base/ にあるマニフェスト（設定ファイル群）を一括でクラスタに適用する
# -f → 指定したディレクトリ内のYAMLファイルをまとめて適用する
# これにより Namespace、Deployment、Service、Ingressなどが一度に作成される
kubectl apply -f k8s/base/

# Podの起動状態をリアルタイムで監視する
# -n test → testというNamespace（名前空間）の中を見る
# -w → watchモード。状態が変わるたびに画面が更新される。全てRunningになったらCtrl+Cで終了
kubectl get pods -n test -w

# nginxのデフォルトページが表示されることを確認
# 期待結果: 「Welcome to nginx!」を含むHTMLが返ってくる
curl http://localhost/

# Argo CD専用のNamespace（名前空間）を作成する
# Argo CDのコンポーネントを他のアプリから分離するため
kubectl create namespace argocd

# Argo CDの公式マニフェストを適用してインストール
# -n argocd → argocd Namespaceにインストールする
# --server-side=true → サーバー側で差分管理するモード
#   Argo CDのマニフェストは非常に大きく、通常のapplyだとサイズ上限を超えてエラーになるため
# --force-conflicts → フィールドの所有権の競合を強制的に解決する（初回インストール時に安全に使える）
kubectl apply -n argocd \
  -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml \
  --server-side=true --force-conflicts

# Argo CDのサーバーが起動するまで待つ（最大5分）
# Argo CDのDockerイメージのダウンロードに時間がかかる場合があるため、余裕を持って300秒に設定
kubectl wait --for=condition=available --timeout=300s \
  deployment/argocd-server -n argocd

# まず、ログインに必要な初期パスワードを取得する
# Argo CDインストール時にadminユーザーの初期パスワードが自動生成されている
# このパスワードをメモしておく
argocd admin initial-password -n argocd

# ポートフォワードを実行する
# ローカルPCのポート8443をクラスタ内のArgo CDサーバー（ポート443）に接続するトンネルを作る
# 重要: このターミナルは閉じないこと！閉じるとArgo CDにアクセスできなくなる
kubectl port-forward svc/argocd-server -n argocd 8443:443

# Gitリポジトリとして初期化する（まだの場合）
git init

# 全ファイルをステージング（コミット対象に追加）
git add .

# 最初のコミットを作成
git commit -m "initial commit"

# GitHubにリモートリポジトリを登録する
# YOUR_USERNAME → 自分のGitHubユーザー名に置き換えてください
git remote add origin git@github.com:YOUR_USERNAME/kubernetes-beginner.git

# GitHubにpushする
# -u → upstream（上流）を設定。以降は「git push」だけでpushできるようになる
git push -u origin main

# Argo CD CLIでログインする
# localhost:8443 → ポートフォワード先のアドレス
# --insecure → 自己署名証明書のTLS検証をスキップ（ローカル環境用）
argocd login localhost:8443 --insecure
# プロンプトが表示されたら、ユーザー名「admin」と初期パスワードを入力する

# SSH秘密鍵を使ってプライベートリポジトリを登録する
# この鍵がクラスタ内のSecretとしてコピーされ、
# Argo CDはこの鍵を使ってGitHubリポジトリを定期的にチェック（デフォルト3分間隔）する
argocd repo add git@github.com:YOUR_USERNAME/kubernetes-beginner.git \
  --ssh-private-key-path ~/.ssh/argocd_k8s_learn

# Step 5で手動デプロイしたリソースを全て削除する
# 同じリソースを2つの方法（手動 + Argo CD）で管理すると競合が起きるため、
# Argo CDに管理を任せる前に手動デプロイ分を削除する
kubectl delete -f k8s/base/

# k8s/argocd/application.yaml の内容（参考）
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: test-app
  namespace: argocd
spec:
  project: default
  source:
    # 監視するGitリポジトリのURL
    repoURL: git@github.com:YOUR_USERNAME/kubernetes-beginner.git
    # 監視するブランチ（HEADは最新のコミットを指す）
    targetRevision: HEAD
    # リポジトリ内の監視対象パス
    path: k8s/base
  destination:
    # デプロイ先のクラスタ（kubernetes.default.svc = 自分自身のクラスタ）
    server: https://kubernetes.default.svc
    namespace: test
  syncPolicy:
    automated:
      # prune: true → Gitから削除されたリソースはクラスタからも削除する
      prune: true
      # selfHeal: true → クラスタ側で手動変更されてもGitの状態に自動で戻す
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

# Argo CD Applicationをクラスタに適用する
# これによりArgo CDがGitHubリポジトリのk8s/base/を監視し始める
kubectl apply -f k8s/argocd/application.yaml

# 同期状態を確認する
# Synced = GitとクラスタがSynced（一致）、OutOfSync = 差分あり
argocd app get test-app

# 手動で同期を実行する（初回は手動で正しく動くか確認する）
argocd app sync test-app

# k8s/base/deployment.yaml の該当部分
spec:
  replicas: 3  # ← この数字を変更する（例: 2 → 3）

# 変更をステージングする
git add k8s/base/deployment.yaml

# コミットする
git commit -m "scale to 3 replicas"

# GitHubにpushする（upstream設定済みなのでブランチ指定不要）
git push

# Argo CDがGitの変更を検知して同期したか確認する
# selfHeal: true に設定しているので、自動で同期される
# ※ デフォルトでは最大3分間隔でリポジトリをチェックしている
argocd app get test-app

# Podの数が変更後の値になっていることを確認
kubectl get pods -n test

# kindクラスタを完全に削除する（クラスタ内の全リソースも一緒に消える）
kind delete cluster --name k8s-learn