Как версионировать библиотеку шаблонов GitLab CI, чтобы у команд ничего не ломалось при обновлениях?

Для версионирования библиотеки шаблонов GitLab CI рекомендуется использовать теги и семантическое версионирование (SemVer).

1. В репозитории с шаблонами создавайте релизы с тегами, например, v1.0.0, v1.1.0.
2. В файлах .gitlab-ci.yml команд указывайте конкретную версию шаблона при импорте:

include:
  - project: 'group/project-templates'
    ref: 'v1.0.0'
    file: '/templates/.gitlab-ci-template.yml'

3. Это гарантирует, что при обновлении шаблонов команды не получат неожиданных изменений, пока не обновят версию явно.

4. Для плавного перехода можно выпускать патчи и минорные версии, а команды постепенно обновлять ссылки на новые версии.