Политики вендоринга

Документ представляет рекомендованные политики вендоринга для репозиториев Docker. (Пример: libnetwork является репозиторием Docker, а logrus — нет.)

Вендоринг с использованием меток

Вендоринг на основе идентификатора коммита предоставляет мало/никакой информации о внесённых изменениях. Для исправления этой ситуации теперь требуется, чтобы репозитории использовали аннотированные метки вместе с идентификаторами коммитов для создания моментальных снимков. Аннотированные метки сами по себе недостаточны, поскольку ту же метку можно принудительно обновить, чтобы она ссылалась на различные коммиты.

Каждая метка должна:

• Подчиняться правилам семантического версионирования (см. раздел "Семантическое версионирование").
• Иметь соответствующую запись в документе отслеживания изменений.

Каждый репозиторий должен:

• Обладать документом отслеживания изменений между метками/выпусками. Например: CHANGELOG.md, файл выпусков GitHub.

Цель здесь состоит в том, чтобы использующие репозитории могли использовать версию метки и обновления журнала изменений для определения того, вызовут ли эти изменения какие-либо разрывы или обратно-несовместимые изменения. Это также означает, что репозитории могут указывать наличие зависимости от пакета конкретной версии или более новой до следующего основного выпуска, без встречи разрывов.## Семантическое версионирование Аннотированные версионные метки должны подчиняться политикам семантического версионирования:

"При номере версии MAJOR.MINOR.PATCH следует увеличивать:

1. MAJOR версию при внесении неприспособленных изменений в API,
2. MINOR версию при добавлении функциональности способом совместимым назад,
3. PATCH версию при внесении исправлений ошибок способом совместимым назад.

Дополнительные метки для предварительных выпусков и метаданных сборки доступны как расширение к формату MAJOR.MINOR.PATCH."

Частота вендоринга

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

Промежуточные тесты вендоринга перед слиянием

Все связанные репозитории будут вендорированы в docker/docker. CI в docker/docker должна выявлять любые разрывные изменения, затрагивающие несколько репозиториев.