diff options
| author | Serge Semin <fancer.lancer@gmail.com> | 2026-07-06 11:43:27 +0300 |
|---|---|---|
| committer | Dmitry Rokosov <rockosov@rulkc.org> | 2026-07-29 16:20:43 +0300 |
| commit | 4f3b0cc07d5a9ca216b84875c278cd263f0b1afe (patch) | |
| tree | ac6c4b9e2ad6a297e093fc2e3328608ab31df6dd | |
| parent | 1f0f96e5bcf77c800eea0939abaf9446ab540dba (diff) | |
| download | landau.one-4f3b0cc07d5a9ca216b84875c278cd263f0b1afe.tar.gz landau.one-4f3b0cc07d5a9ca216b84875c278cd263f0b1afe.zip | |
landau-linux: maintenance: Drop 'upstream/mainline' English-ism from text
It's just "original repo", "source repo", "origin", etc. Use these more
correct alternatives instead or just drop if it's appropriate.
Signed-off-by: Serge Semin <svsemin@unistemlab.com>
| -rw-r--r-- | landau-linux/maintenance.md | 80 |
1 files changed, 41 insertions, 39 deletions
diff --git a/landau-linux/maintenance.md b/landau-linux/maintenance.md index beefcac..d407793 100644 --- a/landau-linux/maintenance.md +++ b/landau-linux/maintenance.md @@ -14,7 +14,7 @@ published: true ### 🎯 Цель -Обеспечить стабильный, предсказуемый и документированный процесс выпуска релизов LANDAU Linux с отслеживанием апстрим-ядра Linux. +Обеспечить стабильный, предсказуемый и документированный процесс выпуска релизов LANDAU Linux с отслеживанием оригинального репозитория ядра Linux. ### Глоссарий V - VERSION - major версия ядра Linux @@ -34,7 +34,7 @@ Bundle - в общем случае это полный набор измене `landau-next` - это ветка для работы всех мейтейнеров вместе. В ней разрешаются конфликты и собираются все MR вместе для создания ветки `landau-V.P.y`. `landau-next` - это force-push ветка, которая меняется при каждом старте нового RMW -### 🪞 Апстрим-зеркала +### 🪞 Зеркала оригинальных репозиториев Linux На сервере `https://git.rulkc.org` поддерживаются постоянно обновляемые зеркала: @@ -55,8 +55,8 @@ VERSION.PATCHLEVEL.SUBLEVEL.lXYZ | Компонент | Пример | Описание | |-----------|--------|----------| | `VERSION` | `7` | Мажорная версия ядра | -| `PATCHLEVEL` | `0` | Минорная версия | -| `SUBLEVEL` | `12` | Номер стабильного обновления апстрима | +| `PATCHLEVEL` | `0` | Минорная версия ядра | +| `SUBLEVEL` | `12` | Номер стабильного обновления ядра | | `lXYZ` | `l0`, `l1` | Сборочный номер LANDAU Linux | @@ -87,22 +87,24 @@ v7.0.lXYZ graph LR A[Создание ветки<br>landau-7.0.y] --> B[Активная разработка<br>и выпуск релизов] B --> C{Тип поддержки?} - C -->|Обычное ядро| D[EOL апстрима →<br>ветка архивируется] - C -->|LTS ядро| E[Поддержка до EOL апстрима<br>только исправления] + C -->|Обычное ядро| D[EOL исходной версии →<br>ветка архивируется] + C -->|LTS ядро| E[Поддержка до EOL исходной версии<br>только исправления] ``` | Стадия | Действие | |--------|----------| -| 🆕 Создание | От тега апстрим-релиза | +| 🆕 Создание | В момент релиза базовой версии ядра Linux | | 🔧 Разработка | Ветка `landau-7.0.y` | -| 🛑 Окончание поддержки | Апстрим достигает EOL | +| 🛑 Окончание поддержки | Исходная версия достигает EOL | | 🐢 LTS | Только исправления (без новых фич) | --- ## 📅 4. График релизов -### ⏱️ Апстрим-график +### ⏱️ Цикл релизов ядра Linux + +В оригинальном репозитории ядра Linux поддерживается следующий цикл разработки: | Фаза | ⏰ Длительность | 📝 Описание | |------|----------------|-------------| @@ -111,7 +113,7 @@ graph LR | RC-тестирование | 7-8 недель | Тестирование кандидатов на релиз | | Финальный релиз | — | Публикация стабильного ядра | -> ℹ️ **Важно**: Релизы LANDAU Linux отстают от апстрима на **1 patchlevel (SUBLEVEL)**. +> ℹ️ **Важно**: Релизы LANDAU Linux отстают от последней версии ядра Linux на **1 patchlevel (SUBLEVEL)**. --- @@ -121,24 +123,24 @@ graph LR ```mermaid flowchart TD - A[📦 Выход нового апстрим-релиза mainline] --> B[🔓 Открытие RMW LANDAU Linux<br>2 недели] + A[📦 Выход нового релиза ядра Linux] --> B[🔓 Открытие RMW LANDAU Linux<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>апстрима] + G --> H[🔄 Интеграция SUBLEVEL<br>стабильной версии ядра Linux] H --> I[📈 Повышение версии<br>v7.0.1.l1] ``` -### 5.1 🆕 Новый релиз mainline +### 5.1 🆕 Новый релиз стабильного ядра Linux | Шаг | Действие | |-----|----------| -| 1 | Создать ветку `landau-7.0.y` от тега апстрим-релиза | +| 1 | Создать ветку `landau-7.0.y` от первого релиза стабильного ядра Linux | | 2 | Применить LANDAU-специфичные патчи | -| 3 | Установить `VERSION`, `PATCHLEVEL`, `SUBLEVEL` по апстриму | +| 3 | Оставить оригинальные значения `VERSION`, `PATCHLEVEL`, `SUBLEVEL` | | 4 | Оставить `EXTRAVERSION` пустым (используется `.lX` формат) | | 5 | Создать тег `v7.0.l-rc1` | @@ -157,12 +159,12 @@ flowchart TD 2. Создать финальный аннотированный тег `v7.0.l` 3. Опубликовать релиз -### 5.4 🔄 Интеграция апстрим-обновлений SUBLEVEL +### 5.4 🔄 Интеграция обновлений SUBLEVEL | Шаг | Действие | Пример | |-----|----------|--------| -| 1 | Определить новый `SUBLEVEL` из апстрим-тега | `v7.0.1` | -| 2 | Смержить апстрим-изменения | `git merge v7.0.1` | +| 1 | Определить новый `SUBLEVEL` из тега в оригинальном репозитории | `v7.0.1` | +| 2 | Забрать изменения из GIT-ветки репозитория LTS | `git merge v7.0.1` | | 3 | Повысить LANDAU-версию | `l` → `l1` | | 4 | Обновить версию | `v7.0.1.l1` | | 5 | Выпустить релиз | Публикация тега | @@ -171,7 +173,7 @@ flowchart TD ## 🐢 6. Политика в отношении LTS -Мейнтейнеры LANDAU Linux приняли решение **нативно поддерживать LTS-версии** апстрим-ядра. +Мейнтейнеры LANDAU Linux приняли решение **нативно поддерживать LTS-версии** ядра Linux. ### ⚠️ Ограничения LTS-поддержки @@ -188,8 +190,8 @@ flowchart TD | Тип ядра | Условие окончания поддержки | |----------|------------------------------| -| Обычное | Апстрим достигает EOL | -| LTS | Поддержка продолжается до EOL апстрима (без добавления новых фич) | +| Обычное | Исходный релиз достигает EOL | +| LTS | Поддержка продолжается до EOL базовой версии (без добавления новых фич) | Гарантировано LANDAU Linux Owners поддерживают одно последнее LTS ядро. Про остальные LTS ядра думаем при наличии ресурсов. @@ -199,11 +201,11 @@ flowchart TD | Область | Ответственность | |---------|------------------| -| 👁️ Мониторинг апстрима | Отслеживание новых релизов и RC-циклов | +| 👁️ Мониторинг исходного репозитория | Отслеживание новых релизов и RC-циклов | | 📦 Применение патчей | Интеграция LANDAU-специфичных изменений ядра | | 🏷️ Управление тегами | Создание аннотированных тегов в формате `vX.Y.lZ` | | 🧪 Координация RC | Организация тестирования кандидатов на релиз | -| 🔒 Безопасность | Мониторинг и применение апстрим-исправлений безопасности | +| 🔒 Безопасность | Мониторинг и применение исправлений безопасности | | 📝 Документирование | Ведение changelog для каждого LANDAU-релиза | --- @@ -212,7 +214,7 @@ flowchart TD ### Исходные данные -Апстрим выпускает ядро **`6.12.0`** +Выпущено ядро Linux версии **`6.12.0`** ### 📍 Пошаговый пример @@ -226,13 +228,13 @@ flowchart TD | 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` | — | +| 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` архивируется | — | +| 9 | Исходная версия `7.0.x` получает статус EOL | Ветка `landau-7.0.y` архивируется | — | #### 🔄 Детальное описание процесса -1. **Выход нового стабильного релиза upstream kernel** (например, `v7.0` по результатам 7 недель стабилизации) +1. **Выход нового стабильного релиза ядра Linux** (например, `v7.0` по результатам 7 недель стабилизации) 2. **Открытие RMW LANDAU Linux** — берём 2 недели на свой релиз LANDAU Linux: - Затаскиваем патч-серии (MR) в ветку `landau-next`, на основе `v7.0` - Там же происходит решение всех конфликтов @@ -246,15 +248,15 @@ flowchart TD - Вся дальнейшая поддержка этой версии ведётся в `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`** + - Переключается на шаг 1, когда в исходном репозитории Linux выходит новый стабильный релиз (например, `v7.1`) +7. **Интеграция новых изменений SUBLEVEL из исходной стабильной версии ядра Linux**: + - Если в исходном репозитории меняется SUBLEVEL (например, `7.0.1`), мы интегрируем данный релиз в **`landau-7.0.y`** - Повышаем свою версию: `v7.0.1.l1` - - То есть повышается версия LANDAU Linux, а SUBLEVEL становится равным upstream SUBLEVEL + - То есть повышается версия LANDAU Linux, а SUBLEVEL получает новое значение согласно интегрированным изменениям 8. **Развитие стабильной версии**: - Стабильная версия LANDAU Linux `v7.0` ведётся в ветке `landau-7.0.y` 9. **Окончание поддержки релиза**: - - Поддержка релиза ветки LANDAU Linux заканчивается, когда версия основного ядра больше не тегируется как stable на kernel.org (например, `7.0` достигла EOL) + - Поддержка релиза ветки LANDAU Linux заканчивается, когда версия основного ядра больше не имеет статус стабильной на kernel.org (например, `7.0` достигла статуса EOL) 10. **LTS-поддержка**: - Если основное ядро уходит в LTS, LANDAU поддерживает LTS до конца - Приносятся только фиксы LANDAU Linux (без новых фич) и новые SUBLEVEL @@ -266,16 +268,16 @@ flowchart TD ```mermaid flowchart TD - A[Выход нового<br>stable релиза upstream<br>например, v7.0] --> B[Открытие RMW LANDAU<br>2 недели] + A[Выход нового<br>стабильного релиза ядра Linux<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] + F --> G[Ожидание нового<br>стабильного релиза ядра Linux] + G --> H[Выходит стабильный релиз<br>с новым SUBLEVEL,<br>например, 7.0.1] H --> I[Интеграция в landau-7.0.y:<br>v7.0.1.l1] - I --> J{Апстрим EOL?} + I --> J{Исходная версия EOL?} J -->|Нет| H J -->|Да| K[Архивация ветки<br>landau-7.0.y] ``` @@ -312,9 +314,9 @@ TODO | Ресурс | URL | |--------|-----| -| 📦 Репозиторий LANDAU | `https://git.rulkc.org/pub/scm/landau` | -| 🪞 Зеркала апстрима | `https://git.rulkc.org` | -| 🔗 Апстрим-ядро | `https://kernel.org` | +| 📦 Репозитории LANDAU | `https://git.rulkc.org/pub/scm/landau` | +| 🪞 Зеркала репозиториев Linux| `https://git.rulkc.org` | +| 🔗 Оригинальные репозитории Linux | `https://kernel.org` | --- |
