跳转到主要内容

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.

Cyberun 在三条独立通道上发布。运维方通过拉取新产物、替换正在运行的二进制或容器镜像并重启来应用升级。跨通道兼容性由大版本号管控。

​
发布通道

通道标签模式发布内容
CloudvX.Y.Z云侧二进制:API 服务器、代理网关、许可证服务。
Agentagent/vX.Y.Z无头代理二进制。通过公开的安装脚本分发。
CLIcli/vX.Y.Zcyberun 命令行客户端,从 releases.cyberun.cloud/cli/install.sh 安装。见 Cloud → CLI。
这些通道按自己的节奏发布 —— Cyberun 可以推送代理的修复而无需强制控制面升级,反之亦然。大版本号(开头的 vN)是兼容性边界。

​
版本策略

  • 补丁(v1.2.3 → v1.2.4):仅修复缺陷。直接替换。无许可证变更,无架构迁移。
  • 次版本(v1.2.x → v1.3.0):增量功能、新的可选能力、自动处理的架构新增。直接替换。
  • 大版本(v1.x.x → v2.0.0):任何破坏既有契约或要求重新颁发许可证的变化。始终附带说明迁移步骤与架构变更姿态的发布说明。
运维方应让三条通道的大版本号保持一致(云侧 vN.*、代理 vN.*、CLI vN.*),以使许可证通道保持连贯。不支持大版本号混搭的部署。

​
云侧升级

对于容器部署 —— 推荐形态 —— 升级走标准的”拉取、部署、观察”流程:
  1. 阅读发布说明。大版本会显式标注迁移与许可证续订触发点。
  2. 拉取三个组件(API 服务器、网关、许可证服务)各自的新镜像标签。
  3. 滚动部署(按你的编排器约定进行滚动重启)。云侧进程在进程级别无状态 —— 滚动期间运行多个副本是安全的。
  4. 验证:许可证服务仍校验该部署;API 服务器的运行版本与你拉取的相符。
零停机控制面升级流程,包括副本间的架构迁移协调,正在作为公开部署指南的一部分编写中。在它发布之前,推荐模式是”短暂计划维护窗口、完整滚动重启、随后验证”。

​
代理升级

每台代理主机可通过重新运行安装脚本独立升级: 
# Linux / macOS — rootless re-run; no sudo, comfyui is the default tool
curl -sL https://releases.cyberun.cloud/agent/install.sh | bash -s -- \
    --api-key ak-…
安装器换上新的二进制并重新应用服务定义;ComfyUI 与模型缓存被保留。macOS 上 launchd 代理会立即重新加载;Linux 上需重启服务(systemctl --user restart cyberun-agent-<tool>)以加载新二进制。整队升级工具正在编写中;在此之前,把代理当作”牲畜”处理,通过配置管理工具(Ansible、Salt、Chef 等)重新运行安装器。

​
架构迁移

云侧二进制在启动时自动处理增量架构变化。破坏性或回填密集的变化通过显式的迁移钩子运行,这类钩子由大版本边界门控 —— 从不出现在补丁或次版本中。 正式的架构迁移运行手册(零停机模式、在线回填、回滚)正在编写中。在它发布之前,计划进行大版本升级的合作伙伴部署会从 Cyberun 收到针对其部署的运行手册。

​
跨大版本的许可证交互

许可证内嵌一个大版本边界。v1.x 许可证在每个 v1.y.z 发布上都继续生效 —— 补丁与次版本升级不触发续订。跨越大版本(v1 → v2)会刻意轮换平台的指纹盐与内嵌的大版本号;既有许可证在新大版本上校验失败,并会为 v2 颁发一份新的许可证。 这是有意为之:大版本发布是商业接缝点,新的授权、新的配额或新的兼容性承诺都在此处生效。把许可证刷新与升级窗口协同 —— 在打大版本升级窗口标签前,请联系我们。

​
备份与 DR

备份叙事(需要捕获哪些状态、恢复流程、多区域复制、RTO/RPO 目标)正在作为独立页面编写中。今天合作伙伴会收到针对其部署的备份运行手册,涵盖:关系型数据库快照、对象存储复制策略、许可证密钥托管。

​
另见

  • 架构 —— 每个组件升级会影响什么。
  • 要求 —— 外部依赖,它们的升级节奏需要你与之协同。
  • 许可证管理 —— 完整许可证生命周期。
  • 代理 —— 安装 / 重新安装脚本参考。