Перейти к содержимому

Каналы релизов

Сервер Tuist и сервер кэша Kura поставляются через три канала образов GHCR с разными гарантиями стабильности. Рекомендуемая установка — stable, обновления выходят раз в неделю: версия не меняется при каждом слиянии новой возможности в main, поэтому обновление больше не означает получение пакета несвязанных изменений. Ранние пользователи по-прежнему могут запускать сборки для каждого коммита на канале canary, а канал release candidate позволяет протестировать будущую ветку до её перехода в стабильную.

И сервер, и Kura следуют одному еженедельному графику и выпускаются синхронно с графиком релизов CLI Tuist.

Текущие релизы#

Ниже показаны текущие релизы каждого компонента. См. календарь релизов для информации о предстоящих окнах и недавних выпусках, включая патчи и бэкпорты.

Опубликованные версии берутся из GitHub. Время отображается в UTC.

Загрузка статуса релиза…
Посмотреть выпуски на GitHub Посмотреть календарь релизов

Каналы#

Канал Формат версии Частота Обновляет :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.

plaintext
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 в следующий понедельник.

plaintext
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.

plaintext
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 релизные поезда трёх компонентов запускаются синхронно:

  1. 06:00 UTC — выполняются задачи повышения. Каждая повышает новейшую ветку release candidate, которая ещё не стала stable (обычно это ветка, отсечённая в предыдущий понедельник), и ничего не делает, если таких нет.
  2. После завершения каждого повышения — задача release candidate отсекает следующую ветку от main, поэтому свежеотсечённая ветка никогда не повышается в том же запуске.

Неудачное повышение блокирует отсечение: выбирается только самая высокая ветка release candidate выше последней stable, поэтому отсечение следующей ветки поверх неудачи оставило бы непоставленную ветку без продвижения. В следующий понедельник заблокированная ветка автоматически повторяется.

Закрепление канала#

Закрепите нужный тег в манифесте развёртывания, значениях Helm или файле Docker Compose. Пример с использованием чарта Helm:

yaml
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 даёт еженедельный стабильный ритм без необходимости обновлять тег; закрепление конкретной версии даёт полный контроль над моментом обновления.

Рекомендуемая стратегия#

Каналы существуют, чтобы разделить «получение новейших исправлений» и «получение новейших возможностей». Безопасный вариант с минимальными усилиями:

  1. Закрепите production на стабильной минорной ветке, например ghcr.io/tuist/tuist:1.351. Эта ветка получает только бэкпортированные исправления, никогда — новые возможности, поэтому ежедневные обновления остаются низко рискованными. Обновляйте закрепление, когда будете готовы перейти на следующую минорную версию.
  2. Запустите staging-окружение на canary или на конкретном теге release candidate. Staging ловит регрессии, которые иначе дошли бы до ваших пользователей, и чем ближе staging отслеживает main, тем раньше вы их находите. Staging-окружение на текущей ветке release candidate — хороший компромисс: оно проверяет именно те байты, которые станут stable в следующий понедельник.
  3. Следите за журналом изменений сервера, чтобы знать, что действительно выпущено. Каждое повышение stable анонсируется там со списком pull request’ов, которые вошли в релиз.

Если вы предпочитаете, чтобы новые возможности автоматически попадали в production по мере стабилизации, оставьте production на :latest. Просто учтите, что тег обновляется еженедельно утром в понедельник, поэтому планируйте окно развёртывания соответствующим образом.

Бэкпорты#

В любой момент активно поддерживаются две стабильные ветки сервера (и Kura): текущая ветка получает регрессии и исправления безопасности через бэкпорт-пулреквесты, а предыдущая — только критические исправления и исправления безопасности. Более старые ветки не получают бэкпортов; обновитесь до поддерживаемой ветки, чтобы получать исправления. Когда новая ветка повышается до stable, текущая становится «предыдущей», а «предыдущая» перестаёт получать бэкпорты.

Бэкпорты выпускаются по запросу как патч-релизы X.Y.(Z+1). Они никогда не двигают :latest.