跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt

Use this file to discover all available pages before exploring further.

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

开始之前

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

创建服务

  1. 打开侧边栏中的 容器
  2. 点击 创建服务
  3. 填写表单:
    字段说明
    Slug小写、3–100 个字符、字母/数字/连字符。会用于 API 路径。不可修改。
    显示名人类可读的标签。
    描述给团队成员看的可选说明。
    Docker 镜像repo/image:tagimage@sha256:...
    暴露端口容器监听的端口(1–65535)。默认为 8080
    健康路径Cloud 探测健康状态时使用的 HTTP 路径。默认为 /health
    环境变量传入容器的键/值对。
    宿主路径 → 容器路径的挂载(用于共享模型、持久化状态)。
    必需标签承载此服务所需的代理标签。
    GPU 数量0(无,默认)、正整数表示具体数量,或 -1 表示”宿主机上的全部 GPU”。
    副本数要保持运行的实例数(1–10)。
  4. 点击 创建。服务会以 created 状态出现在列表中 (定义已保存,但尚未调度任何副本)。

部署

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

更新

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

可观测性

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

故障排查

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

相关

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