diff options
Diffstat (limited to 'landau-linux/maintenance.md')
| -rw-r--r-- | landau-linux/maintenance.md | 325 |
1 files changed, 325 insertions, 0 deletions
diff --git a/landau-linux/maintenance.md b/landau-linux/maintenance.md new file mode 100644 index 0000000..906c625 --- /dev/null +++ b/landau-linux/maintenance.md @@ -0,0 +1,325 @@ +title: "📋 Манифест сопровождения LANDAU" +description: "Официальный процесс maintenance LANDAU Linux — версионирование, ветки, релизы и LTS" +published: true +--- + +# 📋 Манифест процесса сопровождения LANDAU + +> **LANDAU** — форк ядра Linux с собственной схемой версионирования и предсказуемым циклом релизов. +> Этот документ описывает формальный процесс сопровождения (maintenance) проекта. + +--- + +## 🧭 1. Обзор + +### 🎯 Цель + +Обеспечить стабильный, предсказуемый и документированный процесс выпуска LANDAU-релизов с отслеживанием апстрим-ядра Linux. + +### Глоссарий +V - VERSION - major версия ядра Linux +P - PATCHLEVEL - middle версия ядра Linux +S - SUBLEVEL - minor версия ядра Linux +E - EXTRAVERSION - поле в версии ядра Linux, в которое мы встраиваем версию LANDAU (ядром Linux обычно используется для -rc релизов (testing фазы)) +RMW - Rebase & Merge Window - временной отрезок, в рамках которого мейнтейнеры LANDAU ребейзят свой changelog на новую базовую версию ядра. +Bundle - в общем случае это changelog LANDAU Linux, который отличается от upstream (группа патч серий). Есть общий LANDAU Bundle, а есть Bundle-ы мейнтейнеров в их форках. + +### 📁 Структура репозитория + +| Сущность | Назначение | +|----------|-------------| +| `landau-next` | Ветка для следующего релиза LANDAU, куда мейтейнеры отсылают свои MR | +| `landau-V.P.y` | Текущая ветка для релиза LANDAU на базе ядра с версией V.P | + +`landau-next` - это ветка для работы всех мейтейнеров вместе. В ней разрешаются конфликты и собираются все MR вместе для создания ветки `landau-V.P.y`. +`landau-next` - это force-push ветка, которая меняется при каждом старте нового RMW + +### 🪞 Апстрим-зеркала + +На сервере `https://git.rulkc.org` поддерживаются постоянно обновляемые зеркала: + +- 🔷 `torvalds/linux` — основная ветка ядра +- 🔷 `stable/linux` — стабильные релизы +- 🔷 `linux-next` — интеграционное дерево linux-next + +--- + +## 🏷️ 2. Схема версионирования + +### 📐 Формат версии LANDAU + +``` +VERSION.PATCHLEVEL.SUBLEVEL.lXYZ +``` + +| Компонент | Пример | Описание | +|-----------|--------|----------| +| `VERSION` | `7` | Мажорная версия ядра | +| `PATCHLEVEL` | `0` | Минорная версия | +| `SUBLEVEL` | `12` | Номер стабильного обновления апстрима | +| `lXYZ` | `l0`, `l1` | Сборочный номер LANDAU | + + +### 🏷️ Git-теги + +Используются **аннотированные теги** в формате: + +``` +v7.0.lXYZ +``` + +Пример: `v7.0.l0`, `v7.0.l5` + +--- + +## 🌿 3. Веточная стратегия + +### 📌 Основные ветки + +| Ветка | Назначение | +|-------|-------------| +| `landau-next` | Ветка для следующего релиза LANDAU, куда мейтейнеры отсылают свои MR | +| `landau-V.P.y` | Текущая ветка для релиза LANDAU на базе ядра с версией V.P | + +### ⏳ Жизненный цикл ветки + +```mermaid +graph LR + A[Создание ветки<br>landau-7.0.y] --> B[Активная разработка<br>и выпуск релизов] + B --> C{Тип поддержки?} + C -->|Обычное ядро| D[EOL апстрима →<br>ветка архивируется] + C -->|LTS ядро| E[Поддержка до EOL апстрима<br>только исправления] +``` + +| Стадия | Действие | +|--------|----------| +| 🆕 Создание | От тега апстрим-релиза | +| 🔧 Разработка | Ветка `landau-7.0.y` | +| 🛑 Окончание поддержки | Апстрим достигает EOL | +| 🐢 LTS | Только исправления (без новых фич) | + +--- + +## 📅 4. График релизов + +### ⏱️ Апстрим-график + +| Фаза | ⏰ Длительность | 📝 Описание | +|------|----------------|-------------| +| Разработка | 9-10 недель | Подготовка к новому релизу | +| Rebase & Merge Window | 2 недели | Приём новых Merge Requests от мейнтейнеров | +| RC-тестирование | 7-8 недель | Тестирование кандидатов на релиз | +| Финальный релиз | — | Публикация стабильного ядра | + +> ℹ️ **Важно**: Релизы LANDAU отстают от апстрима на **1 patchlevel (SUBLEVEL)**. + +--- + +## 🔄 5. Процесс выпуска LANDAU + +### 📊 Полный цикл релиза + +```mermaid +flowchart TD + A[📦 Выход нового апстрим-релиза mainline] --> B[🔓 Открытие RMW LANDAU<br>2 недели] + B --> C[🏷️ Создание тега v7.0.l-rc1] + C --> D[🧪 Фаза RC-тестирования<br>1 неделя на RC] + D --> E{Все тесты пройдены?} + E -->|Нет| F[🔧 Исправление ошибок] + F --> D + E -->|Да| G[✅ Релиз v7.0.l] + G --> H[🔄 Интеграция SUBLEVEL<br>апстрима] + H --> I[📈 Повышение версии<br>v7.0.1.l1] +``` + +### 5.1 🆕 Новый релиз mainline + +| Шаг | Действие | +|-----|----------| +| 1 | Создать ветку `landau-7.0.y` от тега апстрим-релиза | +| 2 | Применить LANDAU-специфичные патчи | +| 3 | Установить `VERSION`, `PATCHLEVEL`, `SUBLEVEL` по апстриму | +| 4 | Оставить `EXTRAVERSION` пустым (используется `.lX` формат) | +| 5 | Создать тег `v7.0.l-rc1` | + +### 5.2 🧪 RC-тестирование + +| Параметр | Значение | +|----------|----------| +| ⏱️ Длительность | **1 неделя** на каждый RC | +| 🏷️ Кандидаты | `rc1`, `rc2`, `rc3` ... | +| 🎯 Фокус | Регрессионное тестирование, стабильность, валидация фич | +| 🔧 Исправления | Применяются непосредственно в ветку релиза | + +### 5.3 ✅ Финальный релиз + +1. Убедиться, что все критические проблемы решены +2. Создать финальный аннотированный тег `v7.0.l` +3. Опубликовать релиз + +### 5.4 🔄 Интеграция апстрим-обновлений SUBLEVEL + +| Шаг | Действие | Пример | +|-----|----------|--------| +| 1 | Определить новый `SUBLEVEL` из апстрим-тега | `v7.0.1` | +| 2 | Смержить апстрим-изменения | `git merge v7.0.1` | +| 3 | Повысить LANDAU-версию | `l` → `l1` | +| 4 | Обновить версию | `v7.0.1.l1` | +| 5 | Выпустить релиз | Публикация тега | + +--- + +## 🐢 6. Политика в отношении LTS + +Мейнтейнеры LANDAU приняли решение **нативно поддерживать LTS-версии** апстрим-ядра. + +### ⚠️ Ограничения LTS-поддержки + +| ✅ Разрешено | ❌ Запрещено | +|--------------|--------------| +| Исправления безопасности | Бэкпорт новых фич | +| Критические багфиксы | Новые драйверы | +| Стабилизирующие патчи | Изменения подсистем | +| Документация | Любые не-багфиксы | + +> 📌 **Принцип**: Поддерживается тот Changelog, который был на момент отвода LTS основного ядра. + +### 🛑 Окончание поддержки + +| Тип ядра | Условие окончания поддержки | +|----------|------------------------------| +| Обычное | Апстрим достигает EOL | +| LTS | Поддержка продолжается до EOL апстрима (без добавления новых фич) | + +Гарантировано LANDAU Owners поддерживают одно последнее LTS ядро. Про остальные LTS ядра думаем при наличии ресурсов. + +--- + +## 👤 7. Обязанности мейнтейнера + +| Область | Ответственность | +|---------|------------------| +| 👁️ Мониторинг апстрима | Отслеживание новых релизов и RC-циклов | +| 📦 Применение патчей | Интеграция LANDAU-специфичных изменений | +| 🏷️ Управление тегами | Создание аннотированных тегов в формате `vX.Y.lZ` | +| 🧪 Координация RC | Организация тестирования кандидатов на релиз | +| 🔒 Безопасность | Мониторинг и применение апстрим-исправлений безопасности | +| 📝 Документирование | Ведение changelog для каждого LANDAU-релиза | + +--- + +## 📖 8. Пример полного цикла релиза + +### Исходные данные + +Апстрим выпускает ядро **`6.12.0`** + +### 📍 Пошаговый пример + +#### 👁️ Схема + +| Этап | Действие | Результат | Версия сборки | +|------|----------|-----------|---------------| +| 1 | Force push ветки `landau-next` на `v7.0` | `landau-next` | — | +| 2 | Старт RMW | `landau-next` | `N/A` | +| 3 | Создание RC1 | `v7.0.l-rc1` | `7.0.l-rc1` | +| 4 | Создание RC2 | `v7.0.l-rc2` | `7.0.l-rc2` | +| 5 | Создание RC3 | `v7.0.l-rc3` | `7.0.l-rc3` | +| 6 | **Финальный релиз** и **отвод ветки** | `v7.0.l`<br>`landau-7.0.y` | `7.0.l` | +| 7 | Апстрим выпускает `7.0.1` | Слияние изменений в `landau-7.0.y` | — | +| 8 | Обновление версии | `v7.0.1.l1` | `7.0.1.l1` | +| 9 | Апстрим объявляет EOL для `7.0` | Ветка `landau-7.0.y` архивируется | — | + +#### 🔄 Детальное описание процесса + +1. **Выход нового стабильного релиза upstream kernel** (например, `v7.0` по результатам 7 недель стабилизации) +2. **Открытие RMW LANDAU** — берём 2 недели на свой релиз LANDAU: + - Затаскиваем патч-серии (MR) в ветку `landau-next`, на основе `v7.0` + - Там же происходит решение всех конфликтов + - Формируются первые общие сборки ядра +3. **Выпуск RC-версий** (например, `v7.0.l-rc1`) — RC-релизы делаются в ветке `landau-next` +4. **Тестирование** — длится до 7 недель (может быть меньше): + - Выпускаются RC-версии: `rc1`, `rc2`, `rc3` и т.д. +5. **Финальный релиз и отвод стабильной ветки**: + - Выпускаем релиз `v7.0.l` + - Отводим стабильную ветку **`landau-7.0.y`** от финального релиза + - Вся дальнейшая поддержка этой версии ведётся в `landau-7.0.y` +6. **Завершение цикла `landau-next`**: + - Ветка `landau-next` останавливает свой рост на первом релизе `v7.0.l` + - Переключается на шаг 1, когда в upstream выходит новый стабильный релиз (например, `v7.1`) +7. **Интеграция SUBLEVEL из upstream**: + - Если в upstream меняется SUBLEVEL (например, `7.0.1`), мы интегрируем данный релиз в **`landau-7.0.y`** + - Повышаем свою версию: `v7.0.1.l1` + - То есть повышается версия LANDAU, а SUBLEVEL становится равным upstream SUBLEVEL +8. **Развитие стабильной версии**: + - Стабильная версия LANDAU `v7.0` ведётся в ветке `landau-7.0.y` +9. **Окончание поддержки релиза**: + - Поддержка релиза LANDAU-ветки заканчивается, когда версия основного ядра больше не тегируется как stable на kernel.org (например, `7.0` достигла EOL) +10. **LTS-поддержка**: + - Если основное ядро уходит в LTS, LANDAU поддерживает LTS до конца + - Приносятся только фиксы LANDAU (без новых фич) и новые SUBLEVEL +11. **Гарантии поддержки**: + - LANDAU Owners гарантированно поддерживают **одно последнее LTS ядро** + - Про поддержку более старых LTS ядер думаем при наличии ресурсов + +#### 📊 Визуализация цикла + +```mermaid +flowchart TD + A[Выход нового<br>stable релиза upstream<br>например, v7.0] --> B[Открытие RMW LANDAU<br>2 недели] + B --> C[Приём MR в landau-next<br>на основе v7.0] + C --> D[Выпуск RC1, RC2, RC3...<br>до 7 недель] + D --> E{Тестирование пройдено?} + E -->|Нет| D + E -->|Да| F[Релиз v7.0.l<br><br>⚡ Отвод ветки<br><b>landau-7.0.y</b>] + F --> G[Ожидание нового<br>stable upstream] + G --> H[Апстрим выпускает<br>новый SUBLEVEL,<br>например, 7.0.1] + H --> I[Интеграция в landau-7.0.y:<br>v7.0.1.l1] + I --> J{Апстрим EOL?} + J -->|Нет| H + J -->|Да| K[Архивация ветки<br>landau-7.0.y] +``` + +#### 🏷️ Пример полной цепочки тегов + +Для ядра `7.0.x` в LANDAU: + +``` +v7.0.l-rc1 → v7.0.l-rc2 → v7.0.l-rc3 → v7.0.l + ↓ + отвод landau-7.0.y + ↓ + v7.0.1.l1 → v7.0.2.l2 → ... +``` + +--- + +### Требования к патчам + +TODO + +### Pull requests + +TODO + +### Maintainers B4 usage + +TODO + +--- + +## 📚 9. Ссылки и ресурсы + +| Ресурс | URL | +|--------|-----| +| 📦 Репозиторий LANDAU | `https://git.rulkc.org/pub/scm/landau` | +| 🪞 Зеркала апстрима | `https://git.rulkc.org` | +| 🔗 Апстрим-ядро | `https://kernel.org` | + +--- + +> 📌 **Актуальная версия документа**: 1.0 +> ✍️ **Поддерживается**: LANDAU Maintainers +> 📅 **Последнее обновление**: 2026 + +[⬅️ Вернуться на страницу LANDAU Linux](./index.md) |