ArgoCD App Install 是一个面向 ArgoCD 的技能,用于为新工作负载创建和管理 ApplicationSet,遵循 Cafehyna 多仓库 GitOps 模式。它基于标准化的 TEMPLATE.yaml,使用 list generator、多源 Helm 配置以及 Kustomize 注册。
用途 该技能用于将新服务接入 ArgoCD,或按集群范围部署工作负载。它通过模板化的方式生成 ApplicationSet,并完成 values 文件创建与 Kustomize 注册,从而减少手工配置。
主要能力
- 使用 TEMPLATE.yaml 作为基础模板创建 ApplicationSet。
- 支持 list generator 与多源 Helm 配置。
- 支持按集群生成 values 文件,并注册到 kustomization.yaml。
- 提供 ValidateApplicationSet 工作流,用于校验 YAML 语法、集群 URL、values 文件是否存在以及 kustomization.yaml 注册情况。
- 支持在创建前加载用户自定义配置:若存在 ~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/ArgocdAppInstall/ 目录,则加载并应用其中的 PREFERENCES.md、配置或资源,覆盖默认行为;若目录不存在,则使用技能默认值。
- 执行工作流时同时发送语音通知与文本通知。语音通知通过 curl 向 http://localhost:8888/notify 发送 JSON 消息;文本通知输出形如“Running the WorkflowName workflow in the ArgocdAppInstall skill to ACTION...”。
使用方式 工作流路由:
- CreateApplicationSet:触发词包括 "add service"、"new applicationset"、"deploy workload"、"create appset",对应文件 Workflows/CreateApplicationSet.md。
- ValidateApplicationSet:触发词包括 "validate appset"、"check applicationset"、"verify deployment",对应文件 Workflows/ValidateApplicationSet.md。
示例流程(添加新监控服务):用户提出“Add grafana-oncall to the ArgoCD platform”,技能调用 CreateApplicationSet 工作流,将 TEMPLATE.yaml 复制为 grafana-oncall.yaml,替换占位符(chart、repo、namespace、component),在 argo-cd-helm-values/ 下按集群创建 values 文件,注册到 kustomization.yaml,并运行 pre-commit 校验。
示例流程(校验已有 ApplicationSet):用户提出“Validate the robusta applicationset is correct”,技能调用 ValidateApplicationSet 工作流,检查 YAML 语法、集群 URL、values 文件是否存在,验证 kustomization.yaml 注册,并报告发现的问题。
示例流程(仅部署到特定集群):用户提出“Deploy phpmyadmin only to dev clusters”,技能调用 CreateApplicationSet 工作流,从 generator 列表中移除 production/hub 集群,仅保留 cafehyna-dev、loyalty-dev 条目,并确保 dev values 中包含 spot tolerations。
关键路径
- 模板:infra-team/applicationset/TEMPLATE.yaml
- ApplicationSets:infra-team/applicationset/
- Values:argo-cd-helm-values/kube-addons/<service>/<cluster>/values.yaml
- Kustomization:infra-team/applicationset/kustomization.yaml
- 同步波次顺序:-10 核心基础设施,-5 安全,0 默认,5 应用,10 监控
- 集群详情:通过 SkillSearch('argocdappinstall cluster') 加载 ClusterInventory.md
适用场景
- 向 ArgoCD 平台添加新服务。
- 创建新的 ApplicationSet 并部署工作负载。
- 按集群范围(如仅 dev 集群)部署服务。
- 校验已有 ApplicationSet 的正确性。
限制 资料未提供该技能的收费、价格、平台支持范围、性能效果等具体信息。使用前需确认相关路径与模板文件存在,且用户自定义目录为可选。