Процессы

В этом документе описываются процессы и процедуры для некоторых общих задач в репозитории диаграмм.

Объявление диаграммы устаревшей

Когда диаграмма больше не поддерживается, её можно объявить устаревшей. Как только диаграмма объявлена устаревшей, ожидается, что она больше не будет развиваться. Диаграмма и её версии всё ещё будут доступны, хотя такие инструменты, как monocular и Kubeapps Hub, больше не будут отображать эту диаграмму.

Чтобы объявить диаграмму устаревшей, выполните следующие действия:

1. Увеличьте номер версии диаграммы в файле Chart.yaml. Это необходимо, поскольку все диаграммы неизменяемы.
2. Добавьте свойство deprecated: true в файл Chart.yaml на верхнем уровне структуры YAML.
3. Над свойством deprecated добавьте комментарий, указывающий, что диаграмма устарела, и ссылку на политику устаревания.
4. Удалите всех сопровождающих из диаграммы, так как она больше не поддерживается.
5. Префикс описания с «УСТАРЕЛО».
6. Обновите файлы READMEs и NOTES.txt, чтобы отметить, что диаграмма устарела.

Например, файл Chart.yaml может начинаться следующим образом:

name: foo
# Диаграмма foo устарела и больше не поддерживается. Подробные сведения об устаревании,
# включая то, как отменить устаревание диаграммы, см. в файле PROCESSES.md.
deprecated: true
description: УСТАРЕЛО foo bar baz qux...

Отмена устаревания диаграммы

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

1. Обновите сопровождающих диаграммы, если таковые указаны. Предыдущие сопровождающие не должны поддерживать диаграмму, если они явно не решат это сделать.
2. Если в диаграмме есть файл OWNERS, его следует обновить с указанием новых рецензентов и утверждающих.
3. Свойство deprecated из файла Chart.yaml должно быть удалено вместе со связанным комментарием.
4. Номер версии диаграммы должен быть соответственно увеличен. Если сохраняется та же функциональность, версия может быть увеличена на уровень патча. В противном случае необходимо увеличить младшую или основную версию. Более подробную информацию об изменении номера версии см. в спецификации semver.

Продвижение диаграммы из инкубатора в стабильную

При продвижении диаграммы из инкубатора в стабильное состояние необходимо выполнить несколько шагов.

1. Перед продвижением диаграммы убедитесь, что она не зависит от других диаграмм инкубатора. Стабильные диаграммы не могут зависеть от диаграмм инкубатора.
2. Диаграмму следует скопировать, а не переместить, из каталога инкубатора в каталог стабильных.
3. Диаграмма в каталоге инкубатора должна быть объявлена устаревшей в соответствии с описанным выше процессом устаревания с комментарием, указывающим, что диаграмма была продвинута в стабильное состояние.
4. Версия диаграммы в стабильном каталоге должна быть обновлена, чтобы любая документация или другие детали указывали на стабильное, а не на инкубаторное состояние. Также необходимо увеличить номер версии диаграммы.

Проверка запроса на вытягивание

Проверка запроса на вытягивание состоит из двух частей: процесса и руководящих принципов. Оба эти аспекта описаны в Руководящих принципах проверки.