用途:部署、调度和监控 TrueFoundry 作业运行,覆盖批处理任务、一次性任务与 Cron 定时作业。当用户提出部署作业、创建作业、运行批处理任务、调度或运行 cron 作业、查看作业运行列表、查询作业状态或调试失败运行等需求时使用;若只是想列出作业类应用,则应改用 applications 技能并指定 application_type: "job"。
主要能力:支持三种镜像来源——预构建镜像、Git 仓库加 Dockerfile、Git 仓库加 tfy-python-buildpack(无需 Dockerfile);可配置 CPU/内存/临时存储、GPU 设备(如 nvidia_gpu A10_24GB)、环境变量、卷挂载(mounts 与 volume_fqn);支持 cron 定时触发、manual 手动触发与重试(num_retries);定时作业可设置并发策略 Forbid(默认)、Allow、Replace;支持通过 argparse 实现的参数化作业命令。
使用方式:先校验前置条件——设置 TFY_BASE_URL 与 TFY_API_KEY,明确 TFY_WORKSPACE_FQN(不自动选择,缺失须询问用户),用 tfy --version 检查 CLI,缺失时安装固定版本 pip install 'truefoundry==0.5.0'。随后编写 tfy-manifest.yaml,先预览 tfy apply -f tfy-manifest.yaml --dry-run --show-diff,确认后再执行 tfy apply -f tfy-manifest.yaml。CLI 不可用时可将 YAML 转为 JSON 走 REST API:PUT /api/svc/v1/apps 携带 manifest 与 workspaceId;手动触发为 POST /api/svc/v1/jobs/JOB_ID/runs。部署后自动上报作业名称、工作空间、状态与触发方式,并说明如何触发与监控。查看运行可使用 tfy_jobs_list_runs(job_id="job-id") 或 GET /api/svc/v1/jobs/JOB_ID/runs,支持 searchPrefix、sortBy、triggeredBy 等过滤参数。可用 .tfyignore(.gitignore 语法)排除构建文件。
限制与安全:不要在对话中请求或输出明文密钥,敏感环境变量需使用 tfy-secret:// 引用;部署前须与用户确认镜像来源与 Git 仓库地址,Git 优先使用不可变的提交 SHA 或固定标签,生产环境避免 :latest。Cron 格式为 分 时 日 月 周。若 CLI 报 command not found 需按上述固定版本安装;apply 校验失败需检查 YAML 语法及 name、type、image、resources、workspace_fqn 等必填字段。具体收费与价格信息暂未提供。