SuperAPI AI 工具集

argocdappinstall

部署与运维

查看项目

更新于 10-16 09:13

技能介绍

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 的正确性。

限制 资料未提供该技能的收费、价格、平台支持范围、性能效果等具体信息。使用前需确认相关路径与模板文件存在,且用户自定义目录为可选。