发布渠道
Tuist 服务器和 Kura 缓存服务器通过三个具有不同稳定性保证的 GHCR 镜像渠道发布。推荐安装 stable,每周更新一次:它不会在每次功能合并到 main 时都推进,因此升级不再意味着吸收一批不相关的更改。早期采用者仍可以在 canary 上运行每次提交的构建,而 release candidate 渠道允许你在即将发布的版本变为稳定版之前对其进行充分测试。
服务器和 Kura 遵循相同的每周发布节奏,并与 Tuist CLI 的发布计划 保持同步。
当前发布版本#
下方显示了每个组件的当前发布版本。请参阅 发布日历 以了解即将到来的发布窗口和最近的发布,包括补丁和回溯移植。
渠道#
| 渠道 | 版本格式 | 频率 | 更新 :latest? |
|---|---|---|---|
| Canary | X.Y.0-canary.N(例如 1.351.0-canary.5) |
每次提交到 main |
否,需显式选择 |
| Release candidate | X.Y.0-rc.N(例如 1.351.0-rc.1) |
每周一从 main 切出,测试约 1 周 |
否,需显式选择 |
| Stable | X.Y.Z(例如 1.350.2、1.351.0) |
经过干净测试后,每周一提升 | 是 |
Canary 和 release-candidate 构建作为 GitHub 预发布版本发布。任何在解析 :latest 时排除预发布版本的工具都会跳过它们,因此只有在你显式请求时才会使用它们。
Canary#
每次提交到 main 都会发布一个 canary 镜像。Canary 始终代表 下一个未发布的小版本:一旦为发布切出一个分支,main 就会推进到下一个小版本(例如,从 1.350.0-canary.42 到 1.351.0-canary.1)。Canary 是适合暂存环境的渠道,该环境镜像生产环境,能让你最早收到回归问题的信号,或者在你报告的修复进入稳定版之前验证其行为是否符合预期。
ghcr.io/tuist/tuist:1.351.0-canary.5
ghcr.io/tuist/kura:0.55.0-canary.5
Release candidate#
当一个小版本准备好发布时,其分支会被冻结到一个受保护的 releases/server-<major>.<minor>.x(或 releases/kura-<major>.<minor>.x)分支上,并发布为 X.Y.0-rc.1。该分支功能冻结;只有关键修复和回归问题会被 cherry-pick 到该分支上,每个接受的修复都会迭代 release candidate(-rc.2、-rc.3 等)。在测试期顺利结束后,该分支将在下周一提升为稳定版。
ghcr.io/tuist/tuist:1.351.0-rc.1
ghcr.io/tuist/kura:0.55.0-rc.1
Stable#
Stable 是推荐渠道,也是所有文档指向的渠道。稳定小版本(X.Y.0)仅在 release candidate 经过干净测试后发布,并且在新功能合并到 main 时 不会 推进。稳定分支上的补丁(X.Y.1、X.Y.2 等)仅包含回溯移植的修复,从不包含新功能。:latest 仅在稳定版提升时移动。
ghcr.io/tuist/tuist:1.351.0
ghcr.io/tuist/kura:0.55.0
ghcr.io/tuist/tuist:latest
ghcr.io/tuist/kura:latest
周一发布列车#
每周一 UTC 06:00,三个组件的发布列车同步触发:
- UTC 06:00 — 执行提升作业。每个作业都会提升最新的尚未稳定的 release-candidate 分支(通常是上周一切出的分支),如果没有则不执行任何操作。
- 每次提升完成后 — release-candidate 作业从
main切出下一个分支,因此新切出的分支永远不会在同一轮运行中被提升。
失败的提升会推迟切出:只会选择高于最新稳定版的最高 release-candidate 分支,因此在失败之上切出下一个分支会导致未发布的分支被孤立。下周一会自动重试被推迟的分支。
固定渠道#
在你的部署清单、Helm 值或 Docker Compose 文件中固定你想要的特定标签。例如,使用 Helm chart:
server:
image:
repository: ghcr.io/tuist/tuist
tag: "1.350.2" # Pinned to a stable patch
# tag: "1.351.0-rc.1" # Or opt into a release candidate to soak it
# tag: "1.351.0-canary.5" # Or opt into a specific canary build
kuraRuntime:
image:
repository: ghcr.io/tuist/kura
tag: "0.54.0" # Same three channels apply to Kura
:latest 在 ghcr.io/tuist/tuist 和 ghcr.io/tuist/kura 上都跟踪最新的稳定版,仅在周一提升时移动。固定 :latest 让你无需更新标签即可获得每周稳定版的节奏;固定特定版本让你完全控制升级时间。
推荐策略#
这些渠道的存在是为了让你能够将“获取最新修复”与“获取最新功能”解耦。一个安全且低努力的默认策略是:
- 将生产环境固定到一个稳定的小版本分支,例如
ghcr.io/tuist/tuist:1.351。该分支仅接收回溯移植的修复,从不接收新功能,因此日常升级保持低风险。当你准备采用下一个小版本时,再更新固定版本。 - 在 canary 或特定的 release-candidate 标签上运行预发布环境。 预发布环境可以捕获原本会流向用户的回归问题,而预发布环境越接近
main,就能越早发现这些问题。在当前 release-candidate 分支上运行预发布环境是一个不错的折中方案:它会充分测试将在下周一成为稳定版的完全相同的代码。 - 查看服务器变更日志以了解实际发布的内容。 每次稳定版提升都会在此公布,并附带入选的拉取请求列表。
如果你希望新功能在变为稳定版后自动部署到生产环境,请将生产环境保持在 :latest。请注意,该标签会在每周一上午推进,因此请相应安排你的部署窗口。
回溯移植#
任何时候都有两个稳定的服务器(和 Kura)分支处于积极维护状态:当前分支通过回溯移植拉取请求接收回归修复和安全修复,而前一个分支仅接收关键修复和安全修复。更旧的分支不会进行回溯移植;请升级到受维护的分支以获取修复。当新分支被提升为稳定版时,原来的“当前”分支变为“前一个”,而原来的“前一个”分支将停止接收回溯移植。
回溯移植会按需切出为 X.Y.(Z+1) 补丁版本。它们永远不会移动 :latest。