用途:在 TrueFoundry 上启动 Jupyter Notebook 开发环境,适合数据探索、ML 原型开发,以及需要 GPU 的场景。不适用于部署生产服务、部署模型或搭建 SSH 服务器,这些应改用对应技能。
主要能力:支持 CPU 与 GPU 笔记本(如 nvidia_gpu T4)、持久化 home 目录、按空闲时间自动关停(cull_timeout,默认 30 分钟,设为 0 关闭)、自定义镜像与构建脚本、云存储访问、Git 集成、Conda 环境管理。
使用方式:先确认 TFY_BASE_URL、TFY_API_KEY 与 TFY_WORKSPACE_FQN(不可自动选择,缺失需询问用户),检查 tfy --version,缺失时安装 pip install 'truefoundry==0.5.0' && tfy login --host "$TFY_BASE_URL"。编写 YAML 清单(含 name、type: notebook、image、home_directory_size、cull_timeout、resources、workspace_fqn),先预览 tfy apply -f tfy-manifest.yaml --dry-run --show-diff,再执行 tfy apply -f tfy-manifest.yaml。也可通过仪表盘 Deployments → New Deployment → Jupyter Notebook 启动。CLI 不可用时用 scripts/tfy-api.sh 调用 PUT /api/svc/v1/apps。
限制与注意:默认镜像为 public.ecr.aws/truefoundrycloud/jupyter:0.4.5-py3.12.12-sudo,应使用固定版本,勿动态拉取外部标签;自定义镜像不得修改 ENTRYPOINT 或 CMD;apt 安装的包不持久,需用构建脚本;GPU 需使用 CUDA 镜像并确认集群有对应 GPU 类型。具体价格、配额与更多平台细节暂未提供。