このガイドでは、クラスターに Argo CD をインストールし、Web UI にサインインするところまで進めます。自由に試せるクラスターに対して kubectl が設定されている必要があります。ローカルの kind や minikube のクラスターが最適です。

namespace を作成してインストールマニフェストを適用する

Argo CD は専用の namespace で動作します。作成してから、公式のインストールマニフェストを適用します。

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts \
  -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

最近の Argo CD のリリースでは、同梱されている CRD の一部が client-side apply のアノテーション制限には大きすぎるため、server-side apply が推奨されています。インストールするバージョンの正確なコマンドは、Getting Started ページで確認してください。実行する内容を確認したい場合は、先にマニフェストをダウンロードして読んでください。

コンポーネントが起動するのを待つ

kubectl get pods -n argocd
kubectl wait --for=condition=Ready pods --all -n argocd --timeout=300s

アプリケーションコントローラー、repo server、API サーバー、Redis、いくつかの補助コントローラーが表示されるはずです。Pod の準備完了までに 1 分ほどかかるものもあるため、最初は ContainerCreating が表示されても正常です。

Web UI にアクセスする

API サーバーは argocd-server という名前の ClusterIP サービスで公開されています。ローカルクラスターでは port-forward を使います。

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

https://localhost:8080 を開きます。Argo CD はデフォルトで自己署名証明書を生成するため、ブラウザは証明書について警告を表示します。このローカル環境では警告を承認してください。

初期 admin パスワードを取得してサインインする

ユーザー名は admin です。初期パスワードはインストール時に生成され、Secret に保存されます。

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

これをログインフォームに貼り付けます。まだアプリケーションが登録されていないため、UI は空です。それは次のガイドで行います。

ローカルでの実験を超えて使う前に、2 つのことを行ってください。admin パスワードを変更して初期パスワードの Secret を削除すること、そして port-forward に頼らず、Ingress や LoadBalancer と正式な TLS 証明書で Argo CD を公開することです。