argocd-login

ArgoCD CLI ログイン

Data Portal クラスター向けの SSO を使用した ArgoCD CLI 認証です。

このスキルを使用するタイミング

このスキルを使用する場合…	代わりに kubernetes-operations を使用する場合…
SSO 経由で ArgoCD CLI に認証する場合	クラスターに対して kubectl を直接使用する場合
argocd コマンドを実行する前に ArgoCD CLI の認証エラーを解決する場合	ArgoCD を経由せずに Kubernetes ワークロードを調査する場合
argocd.dataportal.fi への gRPC-Web アクセスを設定する場合	特定のポッドまたはノードをデバッグするために kubectl-debugging を使用する場合

使用するタイミング

次の場合に、このスキルを自動的に使用します。

• ユーザーが ArgoCD へのログインまたは認証を依頼した場合
• ユーザーが ArgoCD クラスターまたはアプリケーションへのアクセスについて言及した場合
• ユーザーが ArgoCD CLI ツールを操作する必要がある場合
• ArgoCD コマンドの使用中に認証エラーが発生した場合

認証コマンド

argocd login argocd.dataportal.fi --grpc-web --sso

コマンドの内訳

• argocd.dataportal.fi - Data Portal ArgoCD サーバーのエンドポイント
• --grpc-web - gRPC-Web プロトコルを有効にします（ウェブベースの SSO に必須）
• --sso - シングルサインオン認証を使用します（OAuth2 フローのためにブラウザーを開きます）

使用フロー

1. 認証が必要かどうかを判断します：

   • ユーザーが明示的にログインを依頼した場合
   • ArgoCD コマンドが認証エラーで失敗した場合
   • ユーザーが ArgoCD クラスターへのアクセスについて言及した場合

2. ログインコマンドを実行します：

   argocd login argocd.dataportal.fi --grpc-web --sso
   

3. SSO の手順をユーザーに案内します：

   • コマンドによってブラウザーが自動的に開きます
   • ユーザーがブラウザーで SSO 認証を完了します
   • 認証に成功すると、CLI がトークンを受け取ります
   • セッションは ~/.config/argocd/config に保存されます

4. 認証を確認します：

   argocd account get-user-info
   

よく使う ArgoCD 操作（ログイン後）

アプリケーション管理

# List applications
argocd app list

# Get application details
argocd app get <app-name>

# Sync application
argocd app sync <app-name>

# View application resources
argocd app resources <app-name>

クラスター情報

# List clusters
argocd cluster list

# Get cluster info
argocd cluster get <cluster-name>

プロジェクト管理

# List projects
argocd proj list

# Get project details
argocd proj get <project-name>

認証セッション

• セッションの保存先： ~/.config/argocd/config
• セッションの有効期間： トークンの有効期限は設定可能です
• 再認証： セッションの有効期限が切れたら、ログインコマンドを再実行します

トラブルシューティング

ブラウザーが開かない

• CLI が出力した URL を手動で開きます
• ブラウザーで認証を完了します
• CLI がトークンを受け取ります

gRPC-Web エラー

• --grpc-web フラグが指定されていることを確認します
• argocd.dataportal.fi へのネットワーク接続を確認します
• ファイアウォールとプロキシの設定で gRPC-Web トラフィックが許可されていることを確認します

SSO の失敗

• SSO プロバイダーにアクセスできることを確認します
• 認証プロンプトが表示されていないか、ブラウザーを確認します
• ポップアップブロッカーが妨げていないことを確認します
• シークレットモードまたはプライベートブラウジングモードを試します

トークンの有効期限切れ

• ログインコマンドを再実行します：argocd login argocd.dataportal.fi --grpc-web --sso
• トークンの有効性を確認します：argocd account get-user-info

ArgoCD MCP との連携

このスキルは ArgoCD MCP サーバーのツールを補完します。

• MCP ツール（mcp__argocd-mcp__*）には、認証済み CLI セッションが必要です
• MCP 操作の前に、このスキルを使用して認証を確立します
• どちらも同じ設定（~/.config/argocd/config）を使用します

セキュリティに関する考慮事項

• トークンの保存： CLI トークンはローカルの設定ファイルに保存されます
• トークンのスコープ： ArgoCD へのフルアクセス（RBAC に基づく読み取り／書き込み）
• トークンのローテーション： セキュリティのため、定期的に再認証します
• 共有セッション： CLI と MCP は認証状態を共有します

対話例

User: "I need to check the status of my ArgoCD applications"

Claude: I'll log you into ArgoCD first, then check the application status.

[Executes: argocd login argocd.dataportal.fi --grpc-web --sso]

Please complete the SSO authentication in the browser that just opened.
Once authenticated, I'll retrieve your application list.

[After successful auth, executes: argocd app list]

Here are your applications:
...

関連スキル

• Kubernetes Operations - ArgoCD が管理するリソースに対する kubectl 操作向け
• GitHub Actions Inspection - ArgoCD と連携する CI/CD パイプライン向け
• Infrastructure Terraform - ArgoCD アプリケーションで管理されるインフラストラクチャ向け

参考資料

• ArgoCD CLI ドキュメント
• ArgoCD SSO 設定
• gRPC-Web プロトコル