Окей, Джон. Лови полный регламент релизов под вашу схему: develop → release → master(=prod), релизы в конце спринта, хотфиксы через hotfix и возврат в develop через cherry-pick. Да, это будет достаточно подробно, чтобы даже в 23:40 перед выкладкой никто не «вспоминал как мы обычно делаем». 1) Термины и роли Ветки develop — основная ветка разработки. release/* — релизная ветка конкретного спринта. master — прод (то, что задеплоено/деплоится в production). hotfix/* — ветка срочного исправления от master. Роли Release Captain (RC) — ответственный за релиз спринта. Режет release-ветку, фиксирует scope, контролирует изменения в release, координирует QA sign-off, делает merge в master и инициирует деплой. QA — тестирует релизную ветку на релизном стенде, даёт явный sign-off. Dev — чинит дефекты, готовит изменения, помогает RC. PO/PM — подтверждает состав релиза (если нужно) и приоритеты, особенно если что-то «готово, но не катим». 2) Базовые принципы (чтобы не было магии) 2.1. Что значит статус ‘Готово’ ‘Готово’ в Jira = задача реализована и принята QA (или согласованным способом приёмки) и может быть включена в релиз. Важно: ‘Готово’ не означает «уже в проде». Факт попадания в прод фиксируется релизом (см. scope). 2.2. Scope релиза обязателен У каждого релиза должен быть явный список того, что в него входит. Иначе вы не релиз делаете, а гадание на коммитах. Рекомендуемый вариант: Jira Version/Release (например, Sprint-12 Release / v1.24.0). Альтернатива: релизный тикет со списком задач и ссылками на MR. 2.3. После среза релиза — никаких «ещё одной фичи» После создания release-ветки новые фичи туда не попадают автоматически. В release попадают только: — фиксы дефектов, найденных на релизном тестировании; — осознанно добавленные изменения по решению RC (исключение, с явной фиксацией). 2.4. Тестируем то, что выкатываем QA тестирует release-ветку на release-стенде. Не develop. Не «примерно то же самое». Именно то. 3) Релиз в конце спринта: пошаговый процесс 3.1. За 1–2 дня до конца спринта: подготовка RC (или тимлид) делает быстрый pre-check: — в develop зелёные пайплайны (или хотя бы нет известных блокирующих красных); — нет критичных незакрытых «Требуются правки» по задачам, которые должны попасть в релиз; — список задач ‘Готово’ актуален (и они действительно должны идти в релиз). Если есть задачи ‘Готово’, которые не должны идти в релиз (фича-флаг, бизнес попросил придержать) — они должны быть помечены заранее: — лейбл/поле: exclude from release (или аналог), — либо перенесены в следующую Jira Version. 3.2. Срез релизной ветки (Release Cut) В конце спринта (в согласованное время) RC: — объявляет в чате: «Срез релиза в HH:MM, freeze на включение новых фич»; — создаёт ветку от develop: git checkout develop git pull git checkout -b release/YYYY-MM-DD или release/X.Y.Z Правило: точка среза фиксируется (коммит/хэш) и привязывается к релизу (в релизном тикете/версии). 3.3. Фиксация состава релиза (Release Scope) RC фиксирует scope одним способом (выберите и придерживайтесь): — Jira Version: все задачи, которые должны попасть в релиз, привязаны к версии. — Release ticket: список Jira-тикетов + ссылки на MR. Жёсткое правило: в релиз входят все задачи, которые на момент среза в статусе ‘Готово’ и не помечены exclude. 3.4. Деплой release-ветки на релизный стенд RC (или CI/CD) деплоит release/* на отдельный стенд (release/stage). Минимальные требования: — стенд соответствует прод-конфигурации настолько, насколько это реально; — версия/коммит релиза видны (тег/номер сборки), чтобы QA не тестировал «непонятно что». 3.5. Тестирование релиза (QA) QA тестирует релиз на release-стенде: — smoke; — регресс по затронутым зонам; — критичные бизнес-сценарии. Результат тестирования должен быть явным: — QA sign-off: OK (можно релизить) или — список дефектов/блокеров. 3.6. Если найдены дефекты в релизе Дальше важна дисциплина, иначе ветки разъедутся. Правильный путь фикса дефекта 1) Dev делает фикс в develop (обычный MR, ревью, пайплайн). 2) RC (или ответственный) делает cherry-pick коммита(ов) фикса в release-ветку: git checkout release/YYYY-MM-DD git cherry-pick <commit_sha> 3) Деплой обновлённой release-ветки на release-стенд. 4) QA ретестит. Исключение (нежелательно, но возможно): фикс прямо в release-ветке. Если так сделали — обязателен обратный перенос в develop (тоже cherry-pick), иначе develop и release начнут жить в разных вселенных. 3.7. Freeze релиза на время тестирования Пока QA тестирует релиз: — develop продолжает жить (люди могут коммитить), — но release-ветка меняется только контролируемо (через RC) и только по правилам выше. 3.8. Финальная выкладка: release → master (=prod) После QA sign-off RC: 1) Мержит release в master. 2) Ставит тег релиза. 3) Деплоит master в prod. Технически (примерно): git checkout master git pull git merge --no-ff release/YYYY-MM-DD git tag vX.Y.Z git push origin master --tags (конкретика зависит от вашей политики merge, но принцип один: в master попадает ровно то, что тестировали.) 3.9. После релиза RC закрывает релиз: — закрывает Jira Version/релизный тикет; — фиксирует дату, тег, ссылку на деплой/пайплайн; — если были инциденты: короткий постмортем (причина, почему не поймали, что меняем). 4) Хотфиксы (master/prod → hotfix → master/prod → cherry-pick в develop) 4.1. Когда делаем hotfix Hotfix — для прод-инцидентов/критичных багов, которые нельзя ждать до конца спринта. 4.2. Создание ветки hotfix Ветка создаётся от master (потому что master = prod): git checkout master git pull git checkout -b hotfix/INC-123-short-title 4.3. Фикс и проверка — минимальный безопасный фикс; — прогон нужных тестов/смоука; — по возможности быстрый QA на доступном стенде (идеально — отдельный hotfix-стенд; если нет — на release/stage по договорённости). 4.4. Выкладка хотфикса 1) Мерж hotfix в master. 2) Тег хотфикса. 3) Деплой master в prod. 4.5. Возврат хотфикса в develop через cherry-pick (ваше правило) Это обязательный шаг, иначе следующий релиз может «перезатереть» хотфикс. Процесс: 1) Находим коммит(ы), которые реально исправляют проблему (желательно один/несколько чистых коммитов). 2) Cherry-pick в develop: git checkout develop git pull git cherry-pick <hotfix_commit_sha> 3) Если есть конфликты — решаем, прогоняем тесты. 4) (Рекомендуется) MR в develop, чтобы это прошло ревью и осталось в истории нормально. 5) Правила качества и «предохранители» 5.1. Definition of Done для попадания в релиз Чтобы задача считалась ‘Готово’ и реально могла войти в релиз: — код в develop; — ревью пройдено; — пайплайн зелёный; — QA принял на нужном окружении (или согласованная альтернатива); — в Jira есть «как проверить» и критерии приёмки. 5.2. Никаких «Готово», если не тестировалось Иначе вы сами себе рисуете красивую статистику, а потом страдаете на релизе. 5.3. Изменения в release-ветке только через RC Да, это «бутылочное горлышко». И да, это специально. Релиз — не демократия. 5.4. Обязательная трассируемость Для каждого релиза должно быть понятно: — какой тег/коммит в проде; — какие Jira-тикеты вошли; — где результаты тестирования/подтверждение QA. 6) Мини-шаблоны (чтобы копипастить, а не сочинять) 6.1. Сообщение RC о срезе Релиз: срез в HH:MM. После среза новые фичи в релиз не добавляем. В релиз идут все ‘Готово’ (без exclude). Release ветка: release/YYYY-MM-DD. Тестирование на release-стенде. 6.2. QA sign-off QA sign-off по release/YYYY-MM-DD: OK. Smoke + регресс по зонам X/Y пройдены. Блокеров нет. 6.3. Если дефект найден В релизе найден дефект: [ссылка на баг]. Фикс делаем в develop → cherry-pick в release → ретест. 7) Открытые параметры (скажи — и я подгоню текст под вас идеально) 1) Как вы версионируете релизы: дата (YYYY-MM-DD) или semver (vX.Y.Z)? 2) Где фиксируется QA sign-off: комментарий в релизном тикете, отдельная страница, или прямо в Jira Version? 3) У вас один общий release-стенд или несколько (например, stage/preprod)? Скажешь эти три вещи — и я «дополирую» документ под ваш реальный быт, без теории и без лишних ритуалов.