部署容器服务

本页讲解创建并部署容器服务。关于概念概览见 容器服务。 侧边栏必须出现 容器 入口 —— 如果没有，说明 此部署未启用容器服务 —— 请联系你的团队管理员。

​

开始之前

• 一个代理可访问的 OCI/Docker 镜像。公共镜像仓库 可用；私有镜像仓库需在代理上配置凭证。
• 你的服务在容器内监听的端口。
• 一个你所属的团队，并具备管理服务的管理员权限。

​

创建服务

1. 打开侧边栏中的 容器。
2. 点击 创建服务。
3. 填写表单：

   字段	说明
   Slug	小写、3–100 个字符、字母/数字/连字符。会用于 API 路径。不可修改。
   显示名	人类可读的标签。
   描述	给团队成员看的可选说明。
   Docker 镜像	repo/image:tag 或 image@sha256:...。
   暴露端口	容器监听的端口（1–65535）。默认为 8080。
   健康路径	Cloud 探测健康状态时使用的 HTTP 路径。默认为 /health。
   环境变量	传入容器的键/值对。
   卷	宿主路径 → 容器路径的挂载（用于共享模型、持久化状态）。
   必需标签	承载此服务所需的代理标签。
   GPU 数量	0（无，默认）、正整数表示具体数量，或 -1 表示”宿主机上的全部 GPU”。
   副本数	要保持运行的实例数（1–10）。

4. 点击 创建。服务会以 created 状态出现在列表中 （定义已保存，但尚未调度任何副本）。

​

部署

在服务详情页点击 部署。状态会通过 deploying → running 推进，代理拉取镜像并且健康探测开始通过。 如果没有副本变得健康，服务会进入 failed。 副本会分布在符合条件的代理上。如果你请求的副本数多于 符合条件的代理数，多出来的会保持 pending，直到更多带有匹配标签的 代理上线。

​

更新

• 编辑 —— 修改定义字段。镜像、暴露端口和卷的更改通常需要 重新部署才能在运行中的副本生效。
• 取消部署 —— 停止副本。定义会保留；你可以稍后重新部署， 无需重新输入。
• 删除 —— 移除定义。先停止副本。

​

可观测性

详情页显示：

• 每个实例的状态以及健康探测结果。
• 运行中副本的日志。

​

故障排查

卡在 deploying —— 代理在拉取镜像，或健康探测失败。 检查代理的日志；常见原因是代理上缺少私有镜像仓库的 凭证，或健康路径返回了非 2xx。 Crash-loop —— 容器的主进程在退出。 从详情页查看该副本的日志。 未被领走 —— 服务的必需标签没有匹配任何代理。 在服务表单和 代理 页面上比较标签。

​

相关

• 容器服务 —— 概念。
• 代理 —— 谁来承载容器， 以及标签如何工作。