用途:把 TrueFoundry 的部署配置以 YAML 规格存放在 Git 仓库,实现 GitOps 式自动化部署——在推送或合并时由 CI/CD 调用 tfy apply 完成部署。
主要能力:以 Git 为部署配置的唯一来源;通过 PR 审核变更,并在 CI 中用 tfy apply --dry-run 校验规格;合并到默认分支后自动部署;Git 历史提供完整审计记录。规格涵盖 service、job、model 等资源类型,并按集群与工作区(dev/staging/prod)分目录组织,通常一个资源一个 YAML 文件,文件名与规格内 name 字段保持一致。
使用方式:先确认凭据 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 逐个执行 tfy apply,通常需把范围限制在配置目录内。各 CI 平台的完整工作流见对应参考文件;所有平台都需要配置仓库密钥 TFY_HOST 与 TFY_API_KEY。
适用场景:需要基于 Git 自动部署、变更需经 PR 审核、并要求部署可追溯的团队。
限制与注意:仅用于 GitOps 自动化部署,手动本地部署、LLM 模型部署、Helm chart 部署、查看已部署应用、仅检查连接等需求应使用其他技能。CI 安全上应仅在受信任环境执行部署任务,密钥最小授权并定期轮换,生产部署使用受保护分支或环境。YAML 文件被删除时需在 TrueFoundry 面板手动移除对应资源,流水线本身只提示警告。常见错误包括规格校验失败、401 认证错误、workspace_fqn 不存在与流水线未触发,需检查 YAML 语法、必填字段与仓库密钥配置等。当前资料未提供具体价格及平台支持细节。