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 json | JSON 输出,便于自动化取值 | |
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 8085 | SSO 登录时指定本地回调端口 | |
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=200 | API 与 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.25 | Kustomize 场景覆盖镜像版本 | |
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 denied | RBAC 或仓库凭据不足:用 argocd account can-i 验证 | |
application is not allowed to sync to cluster | Project 未允许该目标集群/命名空间,补 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 exceeded | API 超时:检查 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 --healthargocd app history my-app → argocd app rollback my-app <id> → argocd app wait my-appargocd app get my-app → argocd app terminate-op my-app → 重新 syncargocd 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 applicationsargocd 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 再执行
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 面试复习。