GeekIt

ArgoCD命令速查

登录版本、应用管理、同步回滚、仓库集群、项目权限、诊断日志与 GitOps 实践等 123 条命令

共 123 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 配置说明复制
argocd version查看客户端与服务端版本,两者偏差过大会导致 API 不兼容
argocd version --client只输出客户端版本
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml安装 ArgoCD 到 argocd 命名空间
kubectl -n argocd get pods确认 server、repo-server、application-controller 均就绪
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d获取初始管理员密码
argocd login argocd.example.com --username admin --password 密码登录 ArgoCD
argocd login argocd.example.com --username admin --password 密码 --insecure自签证书场景跳过证书校验(仅测试用)
argocd login argocd.example.com --sso通过 OIDC/SSO 方式登录
argocd account get-user-info查看当前登录账号与所属组
argocd account list列出本地账号及其启用状态
argocd context查看当前上下文(服务器与用户)
argocd logout argocd.example.com退出登录并清理本地凭据
kubectl -n argocd port-forward svc/argocd-server 8080:443本地端口转发,无 Ingress 时访问 UI 的方式
命令 / 配置说明复制
argocd app list列出全部应用及其同步与健康状态
argocd app list -o name只输出应用名,便于脚本批量处理
argocd app get my-app查看应用详情:源、目标、资源树与状态
argocd app get my-app -o jsonJSON 输出,便于自动化取值
argocd app create my-app --repo https://git.example.com/app.git --path deploy --dest-server https://kubernetes.default.svc --dest-namespace prod创建应用,指定仓库、路径与目标集群
argocd app create my-app --repo ... --path deploy --dest-server ... --dest-namespace prod --upsert存在同应用时更新而不是报错
argocd app create my-app --helm-chart nginx --revision 15.0.0 --dest-server ... --dest-namespace prod直接使用 Helm 仓库 Chart 创建应用
argocd app delete my-app删除应用(默认不删除集群内资源)
argocd app delete my-app --cascade级联删除应用创建的资源(谨慎)
argocd app resources my-app列出应用管理的全部资源
argocd app manifests my-app输出渲染后的清单,核对模板结果
argocd app history my-app查看同步历史与修订版本
argocd app actions list my-app --kind Deployment查看资源支持的操作(如重启)
argocd app logs my-app查看应用 Pod 日志
命令 / 配置说明复制
argocd app diff my-app对比 Git 期望状态与集群实际状态
argocd app diff my-app --local ./manifests用本地目录与集群对比,无需推送 Git
argocd app sync my-app触发同步,把 Git 状态应用到集群
argocd app sync my-app --dry-run只计算不执行,验证同步影响
argocd app sync my-app --prune同时删除 Git 中已移除的资源
argocd app sync my-app --force强制同步(等同于 kubectl replace,可能重建资源)
argocd app sync my-app --replace以 replace 方式应用,解决不可变字段冲突
argocd app sync my-app --resource apps:Deployment:prod:web只同步指定资源,减少影响面
argocd app sync my-app --timeout 300设置同步超时秒数
argocd app sync my-app --async异步触发,不等待结果
argocd app wait my-app --health --sync --timeout 300等待健康与同步完成,CI 中常用
argocd app rollback my-app 3回滚到指定历史版本
argocd app history my-app先查历史 ID 再回滚
argocd app terminate-op my-app终止卡住的同步操作,解决 another operation in progress
argocd app patch my-app --patch "{\"spec\": {\"source\": {\"targetRevision\": \"main\"}}}" --type merge直接修改应用定义
命令 / 配置说明复制
argocd repo add https://git.example.com/app.git --username user --password 密码添加 HTTPS 仓库并配置凭据
argocd repo add git@github.com:org/app.git --ssh-private-key-path ~/.ssh/id_rsa添加 SSH 仓库
argocd repo list查看已注册仓库与连接状态
argocd repo get https://git.example.com/app.git查看仓库详情与凭据是否生效
argocd repo rm https://git.example.com/app.git移除仓库
argocd repocreds add https://git.example.com --username user --password 密码为整个域名前缀配置凭据,避免逐个仓库添加
argocd cluster add prod-ctx把 kubeconfig 中的上下文注册为受管集群
argocd cluster list查看受管集群列表
argocd cluster get https://10.0.0.5:6443查看集群详情与版本
argocd cluster rm https://10.0.0.5:6443移除受管集群
argocd cert add-tls git.example.com --from /etc/ssl/ca.pem添加自签 CA 供仓库访问使用
argocd cluster add --in-cluster注册当前集群(同集群部署场景)
命令 / 配置说明复制
argocd proj create team-a创建项目,用于隔离团队与资源范围
argocd proj list列出全部项目
argocd proj add-source team-a https://git.example.com/team-a/*限制项目只能使用指定仓库
argocd proj add-destination team-a https://10.0.0.5:6443 prod限制项目只能部署到指定集群与命名空间
argocd proj allow-cluster-resource team-a "*" "*"允许部署集群级资源(如 CRD),默认禁止
argocd proj role create team-a dev --description "开发只读"在项目内创建角色
argocd proj role add-policy team-a dev --action get --permission allow --object "*"为角色添加权限策略
argocd account can-i sync applications team-a/app验证某账号是否有同步权限
argocd admin settings rbac can role:dev get applications离线校验 RBAC 规则效果
argocd admin settings rbac validate --policy-file policy.csv修改 policy.csv 后先校验语法
argocd account generate-token --account ci-bot为自动化账号生成长期 Token
argocd account update-password修改当前账号密码
命令 / 配置说明复制
argocd account get --account ci-bot查看指定账号信息与 Token 数量
argocd account list列出全部本地账号
argocd account delete-token --account ci-bot <token-id>吊销指定 Token
argocd admin initial-password重置管理员初始密码(需访问集群)
argocd cert list查看已配置的 TLS 证书
argocd admin export > argocd-backup.yaml导出 ArgoCD 配置(应用、项目、仓库等)
argocd admin import - < argocd-backup.yaml导入配置,迁移或恢复时使用
argocd login argocd.example.com --sso --sso-port 8085SSO 登录时指定本地回调端口
argocd account update-password --current-password 旧 --new-password 新脚本化修改密码
kubectl -n argocd get secret argocd-secret -o yaml查看服务端密钥配置(含签名与 Dex 凭据)
命令 / 配置说明复制
kubectl -n argocd logs deploy/argocd-application-controller --tail=200控制器日志,同步与状态计算问题都在这里
kubectl -n argocd logs deploy/argocd-repo-server --tail=200仓库服务日志,模板渲染与拉取失败必看
kubectl -n argocd logs deploy/argocd-server --tail=200API 与 UI 日志,登录与权限问题看这里
argocd app manifests my-app --source live查看集群中实际运行的清单
argocd app get my-app -o yaml | less查看完整状态与条件字段
argocd admin settings resource-overrides list查看健康检查与差异计算的覆盖规则
argocd admin cluster stats查看受管集群资源统计
argocd admin dashboard启动本地 Web 控制台(kubectl 直连场景)
argocd admin namespace list查看集群命名空间与资源统计
kubectl -n argocd get app -o wide直接通过 CRD 查看应用状态
kubectl -n argocd describe app my-app查看应用对象事件,定位对比失败原因
argocd admin settings validate --group apps --kind Application校验资源定义是否符合规范
命令 / 配置说明复制
kubectl get appset -A查看 ApplicationSet 资源
kubectl -n argocd describe appset my-set查看生成器状态与生成的 Application
argocd appset list通过 CLI 列出 ApplicationSet(较新版本支持)
generators: - git: { repoURL, directories: [{ path: apps/* }] }按仓库目录自动生成应用,实现 app-of-apps
kubectl -n argocd get cm argocd-notifications-cm查看通知模板与触发器配置
argocd admin notifications template notify app-sync-succeeded my-app手动触发通知模板,验证配置
argocd admin notifications trigger run on-sync-status-unknown my-app手动执行触发器,调试通知链路
同步窗口(Sync Window)配置在 Project 中,可限制发布时间命中窗口时同步会被拒绝,报 Sync Window is active
kubectl get applications -A -o wide跨命名空间查看全部应用
ApplicationSet 变更后会自动增删应用,删除前确认生成器规则误删生成器会导致批量删除应用
命令 / 配置说明复制
argocd app create ... --sync-policy automated开启自动同步,Git 变更自动下发
argocd app create ... --sync-policy automated --self-heal集群被手工改动后自动纠偏
argocd app create ... --auto-prune自动删除 Git 中已移除的资源(需谨慎)
argocd app create ... --sync-option CreateNamespace=true目标命名空间不存在时自动创建
argocd app set my-app --helm-set image.tag=v1.2.3覆盖 Helm 值,避免频繁改 values 文件
argocd app set my-app --kustomize-image nginx=nginx:1.25Kustomize 场景覆盖镜像版本
argocd app set my-app --revision release-1.0切换跟踪的分支或标签
argocd app set my-app --dest-namespace prod2修改目标命名空间(会重建资源)
app-of-apps 模式:一个根应用管理多个子应用清单适合多团队多环境的统一管理
图表与镜像版本用 Git 提交驱动,不在 UI 手工改GitOps 的核心约束,避免漂移
生产建议 selfHeal + 通知,而非全自动 auto-prune自动删除风险高,先观察一段时间
命令 / 配置说明复制
ComparisonError对比失败:多为仓库拉取失败、路径不存在或模板渲染报错,看 repo-server 日志
OutOfSync 但不会自动同步确认 syncPolicy.automated 是否开启,以及是否被同步窗口拦截
SyncFailed: one or more objects failed to apply展开资源看具体报错,常见为配额不足、校验失败或 RBAC 拒绝
repository not accessible仓库地址/凭据/证书问题:argocd repo get 看连接状态
permission deniedRBAC 或仓库凭据不足:用 argocd account can-i 验证
application is not allowed to sync to clusterProject 未允许该目标集群/命名空间,补 add-destination
another operation is in progress有未结束的同步:argocd app terminate-op 或等待完成
Health 长期 Progressing看资源事件与探针,健康检查规则可用 resource-overrides 调整
Health Degraded资源本身异常:kubectl describe 与 Pod 日志优先
Sync Window is active处于禁止发布窗口:等待窗口结束或调整 Project 配置
InvalidSpecError应用定义不合法:检查 repoURL、path、dest 字段
Invalid resource transition不可变字段变更:改用 --force/--replace 或先删除资源
context deadline exceededAPI 超时:检查 argocd-server 负载与网络,必要时分资源同步
大量资源显示 OutOfSync 但内容一致差异来自默认值或 CRD 版本,可用 ignoreDifferences 收敛

运维常用组合

发布流程argocd app diff my-app → argocd app sync my-app --dry-run → argocd app sync my-app → argocd app wait my-app --health
回滚argocd app history my-app → argocd app rollback my-app <id> → argocd app wait my-app
卡住恢复argocd app get my-app → argocd app terminate-op my-app → 重新 sync
仓库与集群接入argocd repo add ... → argocd cluster add <ctx> → argocd app create ...
权限排查argocd account can-i sync applications team-a/app → argocd admin settings rbac can role:dev sync applications
配置备份迁移argocd admin export > backup.yaml → argocd admin import - < backup.yaml

常见问题排查

1. ComparisonError

先看 argocd-repo-server 日志,多为拉取仓库失败、path 写错或 Helm/Kustomize 渲染报错

2. 不同步也不报错

检查 syncPolicy.automated 是否开启、是否被 Sync Window 拦截,以及应用是否被禁用自动同步

3. 同步卡住

用 argocd app terminate-op 结束挂起操作,再排查目标资源为何一直 Progressing

4. 权限被拒

用 argocd account can-i 与 admin settings rbac can 双重验证,再核对 Project 的 source/destination 限制

5. 差异一直存在

用 ignoreDifferences 忽略默认值字段,或改用 --replace 解决不可变字段冲突

6. 误删风险

auto-prune 与 --cascade 都会删除真实资源,生产建议先 dry-run 与 diff 再执行

共 123 条 ArgoCD 命令 · 服务端默认命名空间 argocd,示例域名请替换为实际环境

关于ArgoCD命令速查

在线 ArgoCD 命令速查手册,按安装版本与登录、应用创建与查看、同步刷新与回滚、仓库与集群管理、项目与 RBAC 权限、账号与安全、诊断与日志、ApplicationSet 与通知、GitOps 实践与发布策略、常见报错等 10 类场景整理 120+ 条常用命令,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 argocd version 与 login 与 --sso 与 --insecure 与 context 与 account get-user-info、install.yaml 安装与 initial-admin-secret 获取初始密码、app list 与 -o name、app get -o json 与 app create 的 --repo/--path/--dest-server/--dest-namespace/--upsert/--helm-chart、app delete 与 --cascade、app resources/manifests/history/logs/actions、app diff 与 --local、app sync 的 --dry-run/--prune/--force/--replace/--resource/--timeout/--async、app wait --health --sync、app rollback 与 app terminate-op 与 app patch、repo add 的 HTTPS/SSH 与 repocreds、cluster add/list/get/rm 与 cert add-tls、proj create/add-source/add-destination/allow-cluster-resource 与 proj role 与 account can-i 与 admin settings rbac validate/can、account generate-token 与 delete-token 与 admin export/import 与 initial-password、application-controller/repo-server/server 日志排查、manifests --source live 与 resource-overrides、ApplicationSet 生成器与 app-of-apps、argocd-notifications-cm 与 template notify 与 trigger run、Sync Window、syncPolicy automated 与 selfHeal 与 auto-prune 与 CreateNamespace 与 --helm-set 与 --kustomize-image 与 --revision、ComparisonError 与 OutOfSync 与 SyncFailed 与 repository not accessible 与 permission denied 与 application is not allowed 与 another operation is in progress 与 Health Degraded 与 InvalidSpecError 等报错排查。适用于 ArgoCD GitOps 部署运维、应用同步与回滚、多集群多团队权限治理、配置漂移与差异收敛、ApplicationSet 批量管理与故障定位,以及运维与 DevOps 面试复习。

核心能力

  • 涵盖 argocd version 与 login 与 --sso 与 --insecure 与 context 与 account get-user-info、install.yaml 安装与 initial-admin-secret 获取初始密码、app list 与 -o name、app get -o json 与 app create 的 --repo/--path/--dest-server/--dest-namespace/--upsert/--helm-chart、app delete 与 --cascade、app resources/manifests/history/logs/actions、app diff 与 --local、app sync 的 --dry-run/--prune/--force/--replace/--resource/--timeout/--async、app wait --health --sync、app rollback 与 app terminate-op 与 app patch、repo add 的 HTTPS/SSH 与 repocreds、cluster add/list/get/rm 与 cert add-tls、proj create/add-source/add-destination/allow-cluster-resource 与 proj role 与 account can-i 与 admin settings rbac validate/can、account generate-token 与 delete-token 与 admin export/import 与 initial-password、application-controller/repo-server/server 日志排查、manifests --source live 与 resource-overrides、ApplicationSet 生成器与 app-of-apps、argocd-notifications-cm 与 template notify 与 trigger run、Sync Window、syncPolicy automated 与 selfHeal 与 auto-prune 与 CreateNamespace 与 --helm-set 与 --kustomize-image 与 --revision、ComparisonError 与 OutOfSync 与 SyncFailed 与 repository not accessible 与 permission denied 与 application is not allowed 与 another operation is in progress 与 Health Degraded 与 InvalidSpecError 等报错排查

适用场景

适用于 ArgoCD GitOps 部署运维、应用同步与回滚、多集群多团队权限治理、配置漂移与差异收敛、ApplicationSet 批量管理与故障定位,以及运维与 DevOps 面试复习。ArgoCD命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

ArgoCD命令速查是免费的吗?需要注册或安装吗?
ArgoCD命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
ArgoCD命令速查支持哪些功能?
涵盖 argocd version 与 login 与 --sso 与 --insecure 与 context 与 account get-user-info、install.yaml 安装与 initial-admin-secret 获取初始密码、app list 与 -o name、app get -o json 与 app create 的 --repo/--path/--dest-server/--dest-namespace/--upsert/--helm-chart、app delete 与 --cascade、app resources/manifests/history/logs/actions、app diff 与 --local、app sync 的 --dry-run/--prune/--force/--replace/--resource/--timeout/--async、app wait --health --sync、app rollback 与 app terminate-op 与 app patch、repo add 的 HTTPS/SSH 与 repocreds、cluster add/list/get/rm 与 cert add-tls、proj create/add-source/add-destination/allow-cluster-resource 与 proj role 与 account can-i 与 admin settings rbac validate/can、account generate-token 与 delete-token 与 admin export/import 与 initial-password、application-controller/repo-server/server 日志排查、manifests --source live 与 resource-overrides、ApplicationSet 生成器与 app-of-apps、argocd-notifications-cm 与 template notify 与 trigger run、Sync Window、syncPolicy automated 与 selfHeal 与 auto-prune 与 CreateNamespace 与 --helm-set 与 --kustomize-image 与 --revision、ComparisonError 与 OutOfSync 与 SyncFailed 与 repository not accessible 与 permission denied 与 application is not allowed 与 another operation is in progress 与 Health Degraded 与 InvalidSpecError 等报错排查。
ArgoCD命令速查适合哪些场景使用?
适用于 ArgoCD GitOps 部署运维、应用同步与回滚、多集群多团队权限治理、配置漂移与差异收敛、ApplicationSet 批量管理与故障定位,以及运维与 DevOps 面试复习。