第 3 章 GitOps argocd CLI 参考
Red Hat OpenShift GitOps argocd
CLI 工具只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。
有关红帽技术预览功能支持范围的更多信息,请参阅技术预览功能支持范围。
本节列出了基本的 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 实例,请将当前上下文的默认命名空间设置为您要与之交互的 ArgoCD 实例的命名空间。
默认
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