SuperAPI AI 工具集

gitops

通用与其它

查看项目

更新于 10-16 08:10

技能介绍

用途:用 TrueFoundry 实现 GitOps 部署,把部署配置作为 YAML 规格存入 Git 仓库,借助 CI/CD 流水线中的 tfy apply 在推送或合并时自动部署。适用于希望以 Git 为唯一事实来源、通过 PR 评审并自动发布 TrueFoundry 资源的场景。

主要能力:以 Git 保存所有 TrueFoundry 资源 YAML;通过 PR 评审变更,并在 CI 中用 tfy apply --dry-run 校验;合并到默认分支后自动执行 tfy apply 部署;Git 历史提供完整审计轨迹。仓库按资源类型分目录(clusters、gateway、integrations、teams、virtualaccounts 等),每个资源一个 YAML 文件,文件名与规格内 name 字段一致,dev/staging/prod 分目录存放。

使用方式:先确认凭据 TFY_BASE_URL 与 TFY_API_KEY 已设置,CI 环境需安装 tfy CLI 并固定版本,例如 pip install 'truefoundry==0.5.3'。校验用 tfy apply --file path/to/spec.yaml --dry-run,部署用 tfy apply --file path/to/spec.yaml。可在流水线中检测变更的 YAML 文件逐个 apply,并限制在配置目录范围内;删除文件时需在 TrueFoundry 控制台手动移除对应资源。GitHub Actions、GitLab CI、Bitbucket Pipelines 均需配置 TFY_HOST 与 TFY_API_KEY 作为仓库密钥。

适用场景:需要自动化、可审计的 TrueFoundry 部署;多环境(dev/staging/prod)配置管理;通过 PR 校验后合并自动发布。

限制:不适用于从本地代码手动部署、部署 LLM 模型、查看已部署内容、部署 Helm chart 或仅检查连接等场景,这些应使用对应的 deploy、llm-deploy、applications、helm、status 技能。部署任务应仅在受信任上下文(如默认分支合并)运行,避免在不可信 fork PR 上执行;API Key 应最小权限并定期轮换,生产 apply 建议使用受保护环境或分支,避免打印可能泄露密钥的环境变量或命令轨迹。具体 CI 工作流文件与凭据检查命令见对应参考文档,资料未提供完整内容。