用途:在 TrueFoundry 上以 Helm Chart 方式部署基础设施组件,而非应用代码。支持任意可从镜像仓库拉取的公有或私有 OCI Helm Chart,例如数据库(PostgreSQL、MySQL、MongoDB)、缓存(Redis、Memcached)、消息队列(RabbitMQ、Kafka、NATS)、向量数据库(Qdrant、Milvus、Weaviate、Chroma)以及监控工具(Prometheus、Grafana)。
主要能力:提供两条部署路径——CLI(tfy apply)编写 YAML 清单并应用,适用于所有环境;CLI 不可用时回退到 REST API(tfy-api.sh)。支持 oci-repo(推荐)、helm-repo、git-helm-repo 三种来源类型。部署后 TrueFoundry 将其视为 addon,可查询详情、升级版本、列出可用组件。
使用方式:部署前需确认 TFY_BASE_URL、TFY_API_KEY 已设置,TFY_WORKSPACE_FQN 必填且不可自动选择;检查 tfy CLI 是否可用(tfy --version),否则执行 pip install 'truefoundry==0.5.0'。部署前必须与用户确认 Chart 来源、仓库、版本、发布名、工作空间、环境、密码、存储大小、资源、副本数、网络暴露与自动关机等配置。生成清单后先预览:tfy apply -f tfy-manifest.yaml --dry-run --show-diff,确认后再执行 tfy apply -f tfy-manifest.yaml。REST API 回退时需先由 FQN 获取内部 workspaceId,再调用 PUT /api/svc/v1/apps。部署后自动校验状态,并返回连接信息。
适用场景:需要以 Helm Chart 部署数据库、缓存、消息队列、向量数据库、监控工具或自定义私有 Chart 时。
限制:不用于部署应用代码(应使用 deploy 技能);用户明确要求 Docker/容器镜像方式部署数据库时不适用;查看已部署内容或日志应分别使用 applications、logs 技能。不要使用 Bitnami Chart,应使用项目官方维护者或发布者自己的 OCI 仓库。公共仓库 Chart 属第三方代码,须仅用可信来源并固定版本,禁止使用 latest 或浮动标签,部署前审查 values。生产数据库需正确配置容量、凭据与持久化,不可用最小默认值直接部署。工具调用方式需人工审批(HITL)。