發布管道
Tuist Server 與 Kura 快取伺服器透過三個 GHCR 映像檔管道發布,各自提供不同的穩定性保證。建議安裝 stable 頻道,每週更新一次:它不會在每次功能合併至 main 時就推進,因此升級不再意味著要吸收一批不相干的變更。早期採用者仍可在 canary 上執行每次提交的建置,而 release candidate 頻道則讓你在版本穩定前先試用即將發布的版本線。
Server 與 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 適合用於模擬生產環境的暫存環境,讓你盡早收到回歸問題的訊號,或在修復進入 stable 之前驗證你回報的修正是否符合預期。
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 的形式發布。該版本線會凍結新功能;只會將關鍵修復與回歸問題挑揀合併進去,且每個接受的修復都會迭代 release candidate 版本(-rc.2、-rc.3,依此類推)。在順利完成試用期後,該版本線會在隔週一推進為 stable。
ghcr.io/tuist/tuist:1.351.0-rc.1
ghcr.io/tuist/kura:0.55.0-rc.1
Stable#
Stable 是建議使用的頻道,也是所有文件指向的頻道。只有在 release candidate 順利試用後,才會發布 stable 次要版本(X.Y.0),而且當新功能合併至 main 時,它 不會 推進。stable 版本線上的修補程式(X.Y.1、X.Y.2 等)只包含回溯移植的修復,絕不包含新功能。:latest 只會在 stable 推進時移動。
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 — 執行推進作業。每個作業會推進尚未成為 stable 的最新 release-candidate 版本線(通常是上週一切出的版本線),若沒有則不執行任何動作。
- 每次推進完成後 — release-candidate 作業會從
main切出下一個版本線,因此剛切出的版本線不會在同一輪執行中被推進。
推進失敗會暫緩切出版本線:系統只會挑選高於最新 stable 的最高 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 上都會追蹤最新的 stable 版本,僅在週一推進時移動。鎖定 :latest 可讓你享有每週 stable 的發布節奏,無需更新標籤;鎖定特定版本則可讓你完全掌控升級時機。
建議策略#
這些頻道的存在,是為了讓你將「取得最新修復」與「取得最新功能」解耦。安全且低維護成本的預設做法如下:
- 將生產環境鎖定在 stable 次要版本線,例如
ghcr.io/tuist/tuist:1.351。該版本線只接收回溯移植的修復,絕不包含新功能,因此日常升級風險較低。當你準備採用下一個次要版本時,再更新鎖定的版本。 - 在 canary 或特定的 release-candidate 標籤上執行預備環境。 預備環境能攔截原本會影響使用者的回歸問題,而且追蹤
main越接近,就能越早發現這些問題。在目前 release-candidate 版本線上執行預備環境是個良好的折衷方案:它會試用下週一將成為 stable 的完全相同內容。 - 查看伺服器變更記錄以了解實際發布的內容。 每次 stable 推進都會在此公告,並附上已合併的拉取請求清單。
如果你希望新功能在成為 stable 後自動部署至生產環境,請讓生產環境保持在 :latest。請注意,該標籤會在每週一早上推進,因此請據此安排你的部署時段。
回溯移植#
任何時候都有兩個 stable 伺服器(及 Kura)版本線處於積極維護狀態:目前版本線會透過回溯移植拉取請求接收回歸修復與安全性修復,而上一個版本線僅接收關鍵與安全性修復。較舊的版本線不會進行回溯移植;請升級至受維護的版本線以取得修復。當新版本線被推進為 stable 時,原本的「目前」版本線會變為「上一個」,而原本的「上一個」版本線則停止接收回溯移植。
回溯移植會按需切出為 X.Y.(Z+1) 修補程式版本。它們絕不會移動 :latest。