Каналы релизов
Сервер Tuist и сервер кэша Kura поставляются через три канала образов GHCR с разными гарантиями стабильности. Рекомендуемая установка — stable, обновления выходят раз в неделю: версия не меняется при каждом слиянии новой возможности в main, поэтому обновление больше не означает получение пакета несвязанных изменений. Ранние пользователи по-прежнему могут запускать сборки для каждого коммита на канале canary, а канал release candidate позволяет протестировать будущую ветку до её перехода в стабильную.
И сервер, и Kura следуют одному еженедельному графику и выпускаются синхронно с графиком релизов CLI Tuist.
Текущие релизы#
Ниже показаны текущие релизы каждого компонента. См. календарь релизов для информации о предстоящих окнах и недавних выпусках, включая патчи и бэкпорты.
Опубликованные версии берутся из GitHub. Время отображается в UTC.
Каналы#
| Канал | Формат версии | Частота | Обновляет :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 — правильный канал для staging-окружения, которое зеркально отражает production и даёт самый ранний сигнал о регрессиях, или для проверки того, что исправление, которое вы сообщили, работает как ожидается, прежде чем оно попадёт в 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. Ветка заморожена по функциональности; в неё cherry-pick’аются только критические исправления и исправления регрессий, и каждое принятое исправление увеличивает номер 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 — рекомендуемый канал, на который ссылается вся документация. Стабильная минорная версия (X.Y.0) публикуется только после успешного тестирования release candidate и не обновляется при слиянии новых возможностей в main. Патчи (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
Понедельничный поезд#
Каждый понедельник в 06:00 UTC релизные поезда трёх компонентов запускаются синхронно:
- 06:00 UTC — выполняются задачи повышения. Каждая повышает новейшую ветку release candidate, которая ещё не стала stable (обычно это ветка, отсечённая в предыдущий понедельник), и ничего не делает, если таких нет.
- После завершения каждого повышения — задача release candidate отсекает следующую ветку от
main, поэтому свежеотсечённая ветка никогда не повышается в том же запуске.
Неудачное повышение блокирует отсечение: выбирается только самая высокая ветка release candidate выше последней stable, поэтому отсечение следующей ветки поверх неудачи оставило бы непоставленную ветку без продвижения. В следующий понедельник заблокированная ветка автоматически повторяется.
Закрепление канала#
Закрепите нужный тег в манифесте развёртывания, значениях Helm или файле Docker Compose. Пример с использованием чарта Helm:
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 даёт еженедельный стабильный ритм без необходимости обновлять тег; закрепление конкретной версии даёт полный контроль над моментом обновления.
Рекомендуемая стратегия#
Каналы существуют, чтобы разделить «получение новейших исправлений» и «получение новейших возможностей». Безопасный вариант с минимальными усилиями:
- Закрепите production на стабильной минорной ветке, например
ghcr.io/tuist/tuist:1.351. Эта ветка получает только бэкпортированные исправления, никогда — новые возможности, поэтому ежедневные обновления остаются низко рискованными. Обновляйте закрепление, когда будете готовы перейти на следующую минорную версию. - Запустите staging-окружение на canary или на конкретном теге release candidate. Staging ловит регрессии, которые иначе дошли бы до ваших пользователей, и чем ближе staging отслеживает
main, тем раньше вы их находите. Staging-окружение на текущей ветке release candidate — хороший компромисс: оно проверяет именно те байты, которые станут stable в следующий понедельник. - Следите за журналом изменений сервера, чтобы знать, что действительно выпущено. Каждое повышение stable анонсируется там со списком pull request’ов, которые вошли в релиз.
Если вы предпочитаете, чтобы новые возможности автоматически попадали в production по мере стабилизации, оставьте production на :latest. Просто учтите, что тег обновляется еженедельно утром в понедельник, поэтому планируйте окно развёртывания соответствующим образом.
Бэкпорты#
В любой момент активно поддерживаются две стабильные ветки сервера (и Kura): текущая ветка получает регрессии и исправления безопасности через бэкпорт-пулреквесты, а предыдущая — только критические исправления и исправления безопасности. Более старые ветки не получают бэкпортов; обновитесь до поддерживаемой ветки, чтобы получать исправления. Когда новая ветка повышается до stable, текущая становится «предыдущей», а «предыдущая» перестаёт получать бэкпорты.
Бэкпорты выпускаются по запросу как патч-релизы X.Y.(Z+1). Они никогда не двигают :latest.