第3章 GitOps argocd CLI リファレンス
Red Hat OpenShift GitOps argocd CLI ツールはテクノロジープレビュー機能のみです。テクノロジープレビュー機能は、Red Hat 製品サポートのサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではない場合があります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
このセクションでは、基本的な GitOps argocd CLI コマンドをリストします。
3.1. 基本的な構文
GitOps argocd CLI は、コマンドラインから Red Hat OpenShift GitOps と Argo CD リソースを設定および管理するためのツールです。
3.1.1. デフォルトモード
デフォルトモードでは、argocd CLI クライアントは API 要求を通じて Argo CD サーバーコンポーネントと通信します。コマンドを実行するには、Argo CD の認証情報を使用して Argo CD サーバーにログインし、セッション中はログインしたままにする必要があります。ログインセッションがタイムアウトした場合は、relogin コマンドを使用して再度ログインできます。argocd コマンドの使用が完了したら、logout コマンドを使用してログアウトできます。
コマンド構文
argocd [command or options] [arguments…]
3.1.2. コアモード
このモードでは、CLI は kubeconfig ファイルに設定された認証情報を通じて Kubernetes API サーバーと直接通信します。デフォルトの kubeconfig ファイルは、$HOME/.kube/config にあります。KUBECONFIG 環境変数を使用してこのファイルをカスタマイズできます。core モードでコマンドを実行するには、--core 引数を使用でき、ユーザー認証のために Argo CD サーバーにログインする必要はありません。
<argocd-instance-name>-repo-server 形式で Repo サーバーコンポーネント名を指定するには、--repo-server-name コマンドラインオプションを使用するか、ARGOCD_REPO_SERVER_NAME 環境変数を設定します。
コマンド構文
KUBECONFIG=~/.kube/config argocd --core [command or options] [arguments…]
core モードで argocd コマンドを実行するには、次のいずれかのオプションを選択できます。
複数の Argo CD インスタンスが使用されている場合は、現在のコンテキストのデフォルトの namespace を、対話する ArgoCD インスタンスの namespace に設定します。
デフォルトのコンテキストを持つデフォルトの
kubeconfigファイル:argocd --core [command or options] [arguments…]例 1: アプリケーションのリストを表示する
$ argocd --core app list --repo-server-name openshift-gitops-repo-server
例 2: アプリケーションのリストを表示する
$ ARGOCD_REPO_SERVER_NAME=openshift-gitops-repo-server argocd --core app list
カスタムコンテキストを持つデフォルトの
kubeconfigファイル:argocd --core --kube-context [context] [command or options] [arguments…]例 1: アプリケーションのリストを表示する
$ argocd --core --kube-context kubeadmin-local app list --repo-server-name openshift-gitops-repo-server
例 2: アプリケーションのリストを表示する
$ ARGOCD_REPO_SERVER_NAME=openshift-gitops-repo-server argocd --core --kube-context kubeadmin-local app list
デフォルトのコンテキストを持つカスタム
kubeconfigファイル:KUBECONFIG=~/.kube/custom_config argocd --core [command or options] [arguments…]例: アプリケーションのリストを表示する
$ KUBECONFIG=~/.kube/custom_config argocd --core app list --repo-server-name openshift-gitops-repo-server
カスタムコンテキストを持つカスタム
kubeconfigファイル:KUBECONFIG=~/.kube/custom_config argocd --core --kube-context [context] [command or options] [arguments…]例: アプリケーションのリストを表示する
$ KUBECONFIG=~/.kube/custom_config argocd --kube-context kubeadmin-local --core app list --repo-server-name openshift-gitops-repo-server
