diff options
Diffstat (limited to 'landau-linux/maintenance.md')
| -rw-r--r-- | landau-linux/maintenance.md | 54 |
1 files changed, 27 insertions, 27 deletions
diff --git a/landau-linux/maintenance.md b/landau-linux/maintenance.md index 906c625..6fd9d83 100644 --- a/landau-linux/maintenance.md +++ b/landau-linux/maintenance.md @@ -1,11 +1,11 @@ -title: "📋 Манифест сопровождения LANDAU" -description: "Официальный процесс maintenance LANDAU Linux — версионирование, ветки, релизы и LTS" +title: "📋 Манифест сопровождения ядра LANDAU-Linux" +description: "Официальный процесс maintenance ядра LANDAU-Linux — версионирование, ветки, релизы и LTS" published: true --- -# 📋 Манифест процесса сопровождения LANDAU +# 📋 Манифест процесса сопровождения ядра LANDAU-Linux -> **LANDAU** — форк ядра Linux с собственной схемой версионирования и предсказуемым циклом релизов. +> **LANDAU-Linux** — форк <u>ядра Linux</u> с собственной схемой версионирования и предсказуемым циклом релизов. > Этот документ описывает формальный процесс сопровождения (maintenance) проекта. --- @@ -14,22 +14,22 @@ published: true ### 🎯 Цель -Обеспечить стабильный, предсказуемый и документированный процесс выпуска LANDAU-релизов с отслеживанием апстрим-ядра Linux. +Обеспечить стабильный, предсказуемый и документированный процесс выпуска LANDAU-Linux-релизов с отслеживанием апстрим-ядра Linux. ### Глоссарий V - VERSION - major версия ядра Linux P - PATCHLEVEL - middle версия ядра Linux S - SUBLEVEL - minor версия ядра Linux -E - EXTRAVERSION - поле в версии ядра Linux, в которое мы встраиваем версию LANDAU (ядром Linux обычно используется для -rc релизов (testing фазы)) +E - EXTRAVERSION - поле в версии ядра Linux, в которое встраивается версия ядра LANDAU-Linux (ядром Linux обычно используется для -rc релизов (testing фазы)) RMW - Rebase & Merge Window - временной отрезок, в рамках которого мейнтейнеры LANDAU ребейзят свой changelog на новую базовую версию ядра. -Bundle - в общем случае это changelog LANDAU Linux, который отличается от upstream (группа патч серий). Есть общий LANDAU Bundle, а есть Bundle-ы мейнтейнеров в их форках. +Bundle - в общем случае это changelog LANDAU-Linux, который отличается от upstream (группа патч серий). Есть общий LANDAU-Linux Bundle, а есть Bundle-ы мейнтейнеров в их форках. ### 📁 Структура репозитория | Сущность | Назначение | |----------|-------------| -| `landau-next` | Ветка для следующего релиза LANDAU, куда мейтейнеры отсылают свои MR | -| `landau-V.P.y` | Текущая ветка для релиза LANDAU на базе ядра с версией V.P | +| `landau-next` | Ветка для следующего релиза LANDAU-Linux, куда мейтейнеры отсылают свои MR | +| `landau-V.P.y` | Текущая ветка для релиза LANDAU-Linux на базе ядра Linux с версией V.P | `landau-next` - это ветка для работы всех мейтейнеров вместе. В ней разрешаются конфликты и собираются все MR вместе для создания ветки `landau-V.P.y`. `landau-next` - это force-push ветка, которая меняется при каждом старте нового RMW @@ -38,15 +38,15 @@ Bundle - в общем случае это changelog LANDAU Linux, которы На сервере `https://git.rulkc.org` поддерживаются постоянно обновляемые зеркала: -- 🔷 `torvalds/linux` — основная ветка ядра -- 🔷 `stable/linux` — стабильные релизы +- 🔷 `torvalds/linux` — основная ветка ядра Linux +- 🔷 `stable/linux` — стабильные релизы ядра Linux - 🔷 `linux-next` — интеграционное дерево linux-next --- ## 🏷️ 2. Схема версионирования -### 📐 Формат версии LANDAU +### 📐 Формат версии LANDAU-Linux ``` VERSION.PATCHLEVEL.SUBLEVEL.lXYZ @@ -57,7 +57,7 @@ VERSION.PATCHLEVEL.SUBLEVEL.lXYZ | `VERSION` | `7` | Мажорная версия ядра | | `PATCHLEVEL` | `0` | Минорная версия | | `SUBLEVEL` | `12` | Номер стабильного обновления апстрима | -| `lXYZ` | `l0`, `l1` | Сборочный номер LANDAU | +| `lXYZ` | `l0`, `l1` | Сборочный номер LANDAU-Linux | ### 🏷️ Git-теги @@ -78,8 +78,8 @@ v7.0.lXYZ | Ветка | Назначение | |-------|-------------| -| `landau-next` | Ветка для следующего релиза LANDAU, куда мейтейнеры отсылают свои MR | -| `landau-V.P.y` | Текущая ветка для релиза LANDAU на базе ядра с версией V.P | +| `landau-next` | Ветка для следующего релиза LANDAU-Linux, куда мейтейнеры отсылают свои MR | +| `landau-V.P.y` | Текущая ветка для релиза LANDAU-Linux на базе <u>стабильного</u> ядра Linux с версией V.P | ### ⏳ Жизненный цикл ветки @@ -111,17 +111,17 @@ graph LR | RC-тестирование | 7-8 недель | Тестирование кандидатов на релиз | | Финальный релиз | — | Публикация стабильного ядра | -> ℹ️ **Важно**: Релизы LANDAU отстают от апстрима на **1 patchlevel (SUBLEVEL)**. +> ℹ️ **Важно**: Релизы LANDAU-Linux отстают от апстрима на **1 patchlevel (SUBLEVEL)**. --- -## 🔄 5. Процесс выпуска LANDAU +## 🔄 5. Процесс выпуска LANDAU-Linux ### 📊 Полный цикл релиза ```mermaid flowchart TD - A[📦 Выход нового апстрим-релиза mainline] --> B[🔓 Открытие RMW LANDAU<br>2 недели] + A[📦 Выход нового апстрим-релиза mainline] --> B[🔓 Открытие RMW LANDAU-Linux<br>2 недели] B --> C[🏷️ Создание тега v7.0.l-rc1] C --> D[🧪 Фаза RC-тестирования<br>1 неделя на RC] D --> E{Все тесты пройдены?} @@ -171,7 +171,7 @@ flowchart TD ## 🐢 6. Политика в отношении LTS -Мейнтейнеры LANDAU приняли решение **нативно поддерживать LTS-версии** апстрим-ядра. +Мейнтейнеры LANDAU-Linux приняли решение **нативно поддерживать LTS-версии** апстрим-ядра. ### ⚠️ Ограничения LTS-поддержки @@ -191,7 +191,7 @@ flowchart TD | Обычное | Апстрим достигает EOL | | LTS | Поддержка продолжается до EOL апстрима (без добавления новых фич) | -Гарантировано LANDAU Owners поддерживают одно последнее LTS ядро. Про остальные LTS ядра думаем при наличии ресурсов. +Гарантировано LANDAU-Linux Owners поддерживают одно последнее LTS ядро. Про остальные LTS ядра думаем при наличии ресурсов. --- @@ -200,7 +200,7 @@ flowchart TD | Область | Ответственность | |---------|------------------| | 👁️ Мониторинг апстрима | Отслеживание новых релизов и RC-циклов | -| 📦 Применение патчей | Интеграция LANDAU-специфичных изменений | +| 📦 Применение патчей | Интеграция LANDAU-специфичных изменений ядра | | 🏷️ Управление тегами | Создание аннотированных тегов в формате `vX.Y.lZ` | | 🧪 Координация RC | Организация тестирования кандидатов на релиз | | 🔒 Безопасность | Мониторинг и применение апстрим-исправлений безопасности | @@ -233,7 +233,7 @@ flowchart TD #### 🔄 Детальное описание процесса 1. **Выход нового стабильного релиза upstream kernel** (например, `v7.0` по результатам 7 недель стабилизации) -2. **Открытие RMW LANDAU** — берём 2 недели на свой релиз LANDAU: +2. **Открытие RMW LANDAU-Linux** — берём 2 недели на свой релиз LANDAU-Linux: - Затаскиваем патч-серии (MR) в ветку `landau-next`, на основе `v7.0` - Там же происходит решение всех конфликтов - Формируются первые общие сборки ядра @@ -250,16 +250,16 @@ flowchart TD 7. **Интеграция SUBLEVEL из upstream**: - Если в upstream меняется SUBLEVEL (например, `7.0.1`), мы интегрируем данный релиз в **`landau-7.0.y`** - Повышаем свою версию: `v7.0.1.l1` - - То есть повышается версия LANDAU, а SUBLEVEL становится равным upstream SUBLEVEL + - То есть повышается версия LANDAU-Linux, а SUBLEVEL становится равным upstream SUBLEVEL 8. **Развитие стабильной версии**: - - Стабильная версия LANDAU `v7.0` ведётся в ветке `landau-7.0.y` + - Стабильная версия LANDAU-Linux `v7.0` ведётся в ветке `landau-7.0.y` 9. **Окончание поддержки релиза**: - - Поддержка релиза LANDAU-ветки заканчивается, когда версия основного ядра больше не тегируется как stable на kernel.org (например, `7.0` достигла EOL) + - Поддержка релиза ветки LANDAU-Linux заканчивается, когда версия основного ядра больше не тегируется как stable на kernel.org (например, `7.0` достигла EOL) 10. **LTS-поддержка**: - Если основное ядро уходит в LTS, LANDAU поддерживает LTS до конца - - Приносятся только фиксы LANDAU (без новых фич) и новые SUBLEVEL + - Приносятся только фиксы LANDAU-Linux (без новых фич) и новые SUBLEVEL 11. **Гарантии поддержки**: - - LANDAU Owners гарантированно поддерживают **одно последнее LTS ядро** + - LANDAU-Linux Owners гарантированно поддерживают **одно последнее LTS ядро** - Про поддержку более старых LTS ядер думаем при наличии ресурсов #### 📊 Визуализация цикла |