使用ArgoCD部署Kubernetes清单遇阻，求相关文档指引

一、ArgoCD部署纯K8s清单的核心逻辑 #

ArgoCD完全支持直接部署Git仓库里的纯YAML/JSON清单，不需要依赖Helm Chart。核心是把你的清单文件放到Git仓库的指定目录，然后在创建Application时指向这个路径即可。

二、Web UI中清单目录不显示的原因及解决 #

你看不到清单目录是正常默认行为——ArgoCD的Web UI下拉菜单只会自动扫描并显示Helm Chart的索引项，纯清单目录不会被自动收录，不存在所谓的“隐藏文档”。解决方式很直接：

• 创建Application时，不要选择Helm类型，切换为Directory类型
• 手动输入清单所在的Git仓库路径（比如./k8s/prod），不需要依赖下拉菜单的选项
• 确认Git仓库已经正确添加到ArgoCD的仓库列表（你能看到Helm仓库，说明仓库连接是正常的）

三、Web UI具体操作步骤 #

1. 打开ArgoCD Web UI，点击右上角的+ New Application
2. 填写Application名称、所属项目、目标集群和命名空间
3. 在Source区域：
   • 选择你已添加的目标Git仓库
   • 将Source Type切换为Directory
   • 在Path输入框手动填写清单所在的目录路径（比如/deploy/manifests）
   • 按需指定分支、Tag或Commit ID（默认使用仓库主分支）
4. 点击Create，ArgoCD会自动同步该目录下的所有Kubernetes清单到目标集群

四、CLI方式快速部署（可选） #

如果更习惯用命令行，执行以下命令即可：

argocd app create my-k8s-app \
  --repo git@your-repo-url.git \
  --path ./path-to-manifests \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace your-target-namespace

这里的--path参数直接指定清单目录，完全避开Web UI的下拉菜单限制。

内容的提问来源于stack exchange，提问作者S1c0r4x