📋 Манифест процесса сопровождения ядра LANDAU Linux

LANDAU Linux — форк ядра Linux с собственной схемой версионирования и предсказуемым циклом релизов. Этот документ описывает формальный процесс сопровождения (maintenance) проекта.

🧭 1. Обзор

🎯 Цель

Обеспечить стабильный, предсказуемый и документированный процесс выпуска релизов LANDAU Linux с отслеживанием оригинального репозитория ядра Linux.

📖 Глоссарий

🪞 Зеркала оригинальных репозиториев Linux

На сервере git.rulkc.org поддерживаются постоянно обновляемые зеркала:

• 🔷 torvalds/linux — основная ветка ядра Linux
• 🔷 stable/linux — стабильные релизы ядра Linux
• 🔷 linux-next — интеграционное дерево linux-next

🏷️ 2. Схема версионирования

📐 Формат версии LANDAU Linux

VERSION.PATCHLEVEL.SUBLEVEL.lXYZ

🏷️ Git-теги

Используются аннотированные теги в формате:

v7.0.l-rcX
v7.0.lXYZ

Пример: v7.0.l-rc1, v7.0.l, v7.0.l5

🌿 3. Cтратегия организации GIT-веток

📌 Основные GIT-ветки

landau-next - GIT-ветка для работы всех мейтейнеров вместе. В ней разрешаются конфликты и собираются все MR вместе для создания ветки landau-V.P.y. При старте нового RMW её HEAD насильно переносится (force-push) на новый релиз ядра Linux.

⏳ Жизненный цикл GIT-веток

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'background': '#002b36',
    'primaryColor': '#073642',
    'primaryTextColor': '#839496',
    'primaryBorderColor': '#586e75',
    'lineColor': '#b58900',
    'secondaryColor': '#002b36',
    'tertiaryColor': '#073642',
    'edgeLabelBackground': '#002b36',
    'nodeBorder': '#586e75',
    'nodeTextColor': '#93a1a1',
    'clusterBkg': '#002b36',
    'clusterBorder': '#586e75',
    'fontSize': '20px',
    'fontFamily': 'monospace'
  },
  'flowchart': {
    'nodeSpacing': 80,
    'rankSpacing': 30,
    'curve': 'basis',
    'padding': 10
  }
}}%%
flowchart TB
    subgraph Block1["Подготовка релиза (этап RC)"]
        direction LR
        A["<b>landau-next</b> → <b>linux-V.P.y</b>"]
        B["Стабилизация <b>landau-next</b>"]
        C{"Код<br><b>landau-next</b> стабилен?"}
        D(("•••"))
        E["P = P + 1"]

        A --> B
        B --> C
        C -->|Нет| B
        C -->|Да| D
        C -->|Да| E
        E -.->|Ожидание релиза P| A
    end

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'background': '#002b36',
    'primaryColor': '#073642',
    'primaryTextColor': '#839496',
    'primaryBorderColor': '#586e75',
    'lineColor': '#b58900',
    'secondaryColor': '#002b36',
    'tertiaryColor': '#073642',
    'edgeLabelBackground': '#002b36',
    'nodeBorder': '#586e75',
    'nodeTextColor': '#93a1a1',
    'clusterBkg': '#002b36',
    'clusterBorder': '#586e75',
    'fontSize': '20px',
    'fontFamily': 'monospace'
  },
  'flowchart': {
    'nodeSpacing': 80,
    'rankSpacing': 30,
    'curve': 'basis',
    'padding': 10
  }
}}%%
flowchart TB
    subgraph Block2["Релиз LANDAU Linux"]
        direction LR
        A(("•••"))
        B["<b>landau-V.P.y</b> → <b>landau-next</b>"]
        C["Поддержка <b>landau-V.P.y</b>"]
        D{"Статус<br><b>linux-V.P.y</b> <b>EOL</b>?"}
        E["Архивация <b>landau-V.P.y</b>"]

        A --> B
        B --> C
        C --> D
        D -->|Нет| C
        D -->|Да| E
    end

В базовом представлении поддержка подразумевает периодическую синхронизацию landau-V.P.y с исходной GIT-веткой linux-V.P.y.

📅 4. График релизов

⏱️ Цикл релизов ядра Linux

В оригинальном репозитории ядра Linux поддерживается следующий цикл разработки:

ℹ️ Важно: Поскольку релизы LANDAU Linux базируются на стабильных релизах ядра Linux, то текущий цикл разработки всегда отстаёт от последней версии ядра Linux на 1 PATCHLEVEL.

🔄 5. Процесс выпуска LANDAU Linux

📊 Полный цикл релиза

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'background': '#002b36',
    'primaryColor': '#073642',
    'primaryTextColor': '#839496',
    'primaryBorderColor': '#586e75',
    'lineColor': '#b58900',
    'secondaryColor': '#002b36',
    'tertiaryColor': '#073642',
    'edgeLabelBackground': '#002b36',
    'nodeBorder': '#586e75',
    'nodeTextColor': '#93a1a1',
    'fontSize': '20px',
    'fontFamily': 'monospace'
  },
  'flowchart': {
    'nodeSpacing': 80,
    'rankSpacing': 30,
    'curve': 'basis',
    'padding': 10
  }
}}%%
flowchart TB
    subgraph Block1["Подготовка релиза (этап RC)"]
        direction LR
        A["📦 Новый релиз ядра Linux"] --> B
        B(["🔓 1. RMW LANDAU Linux<br>(~2 нед.)"]) --> C
        C["🔧 Перенос и слияние Bundle-ов"] --> D
        D(["🔓 2. RC LANDAU Linux<br>(~1 нед. на RCx)"]) --> E
        E["🔧 Исправление ошибок<br>(выпуск RC)"] --> F
        F(("•••"))
    end

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'background': '#002b36',
    'primaryColor': '#073642',
    'primaryTextColor': '#839496',
    'primaryBorderColor': '#586e75',
    'lineColor': '#b58900',
    'secondaryColor': '#002b36',
    'tertiaryColor': '#073642',
    'edgeLabelBackground': '#002b36',
    'nodeBorder': '#586e75',
    'nodeTextColor': '#93a1a1',
    'fontSize': '20px',
    'fontFamily': 'monospace'
  },
  'flowchart': {
    'nodeSpacing': 80,
    'rankSpacing': 30,
    'curve': 'basis',
    'padding': 10
  }
}}%%
flowchart TB
    subgraph Block2["Релиз LANDAU Linux"]
        direction LR
        A(("•••")) --> B
        B(["✅ 3. Релиз LANDAU Linux"]) --> C
        C["🔧 Публикация изменений<br>LANDAU Linux"] --> D
        D(["🔓 4. Поддержка LANDAU Linux"]) --> E
        E["🔧 Исправление ошибок и<br>синхронизация SUBLEVEL"] --> F
        F(["🐢 5. EOL LANDAU Linux"])
    end

5.1 🆕 Этап RMW LANDAU Linux

ℹ️ Переменная EXTRAVERSION в стабильных релизах ядра Linux остаётся пустым, потому может быть использована для сохранения версий LANDAU Linux. При этом оригинальные значения VERSION, PATCHLEVEL, SUBLEVEL в дальнейшем сохраняются для индикации версии исходного ядра Linux.

5.2 🧪 Этап RC LANDAU Linux

ℹ️ Стабилизация GIT-ветки landau-next (отсуствие выявленных ошибок в очреденом RC-цикле) символизирует окончание этапа RC и выход на релиз.

5.3 ✅ Релиз LANDAU Linux

5.4 🔄 Поддержка стабильной и LTS-версий LANDAU Linux

Мейнтейнеры LANDAU Linux приняли решение нативно поддерживать стабильные и LTS-версии ядра Linux до получения статуса EOL. Однако гарантировано корректирующие изменения LANDAU Linux портируются в LANDAU Linux на основе последней LTS-версии ядра Linux. Портирование изменений в более ранние версии возможно при наличии ресурсов.

⚠️ Особенности интеграции изменений в стабильную и LTS версии LANDAU Linux:

📌 Принцип: Поддерживается тот Changelog, который был на момент отвода LTS основного ядра.

5.5 🔄 Завершение поддержки релиза LANDAU Linux (EOL)

Поддержка стабильной и LTS версий LANDAU Linux завершается либо вместе с получением статуса EOL исходной версии ядра Linux, либо после выпуска релиза LANDAU Linux, основанного на последней LTS-версии ядра Linux.

👤 6. Обязанности мейнтейнера

🏗️ Личные репозитории ментейнеров

В личных репозиториях мейнтейнеры хранят и развивают собственные форки ядра Linux с подведомственным им набором изменений.

В целом, способ организации персональных репозиториев мейнтейнеры могут выбирать самостоятельно. Например, можно разделить независимые изменения на GIT-ветки по подсистемам и отправлять MR с каждым из них, либо предварительно объединить их в единую GIT-ветку и отправить один целостный MR. При этом необходимо придерживаться правила преемственности предыдущих изменений и минимизации merge-конфликтов. То есть GIT-ветка, отправляемая в MR главному мейнтейнеру, должна сохранять историю предыдущих изменений LANDAU Linux и их исправлений, а также содержать последнюю версию оригинальной версии ядра Linux, для которого готовится релиз LANDAU Linux.

Для реализации такого требования удобно использовать подход двойного слияния, суть которого в том, чтобы сначала мейнтейнеры своих репозиториев LANDAU Linux (sub-LANDAU Linux) выполнили слияние своих GIT-веток с landau-next, разрешили все конфликты и лишь потом отправляли MR в рамках этапа RMW.

---
config:
    gitGraph:
        parallelCommits: false
        mainBranchName: 'linux-V.P.y'
---
gitGraph
    branch baikal-next order: 2
    branch amlogic-next order: 3
    commit
    commit
    checkout baikal-next
    commit
    commit
    checkout linux-V.P.y
    commit
    commit
    commit id: "Linux V.P" tag: "vV.P"
    branch landau-next order: 1
    commit id: " " type: HIGHLIGHT
    checkout amlogic-next
    merge landau-next
    checkout baikal-next
    merge landau-next
    checkout landau-next
    merge amlogic-next
    merge baikal-next
    commit id: "LANDAU Linux V.P.l-rc1" tag: "vV.P.l-rc1"

Таким образом, основная нагрузка по исправлению конфликтов ложится на нижестоящих ментейнеров. Главному ментейнеру остаётся лишь собрать все MR в linux-next. Если и в этом случае возникают сложные конфликты, то главный ментейнер вправе попросить выполнить повторный цикл двойного слияния, чтобы кросс sub-LANDAU Linux конфликты были разешены на стороне нижестоящих ментейнеров.

Опционально ментейнеры могут выполнять поддержку GIT-веток с патч-сетами для последующей отправки изменений в оригинальный репозиторий ядра Linux. До момента интеграции патч-сеты могут “поглощать” исправления и стилистические изменения в процессе перебазирования на новую версию ядра Linux. Это упрощает сопровождение таких GIT-веток, минимизируя лог изменений, который к тому же является лишним при интеграции в ядро Linux.

📖 7. Пример полного цикла релиза

Исходные данные

Выпущено ядро Linux версии 7.0. Это означает, что в оригинальном репозитории ядра Linux изменения, добавленные в период окна слияния, достаточно стабилизировались, этап RC завершён, EXTRAVERSION принимает пустое значение, последний коммит символизирует релиз ядра Linux 7.0, а в GIT-репозитории стабильных и LTS веток появляется новая ветка linux-7.0.y.

📍 Пошаговый пример

👁️ Схема

🔄 Детальное описание процесса

1. Выход нового стабильного релиза ядра Linux (например, v7.0 по результатам 7 недель стабилизации)
2. Открытие RMW LANDAU Linux — берём 2 недели на свой релиз LANDAU Linux:
   • Затаскиваем патч-серии (MR) в ветку landau-next, на основе v7.0
   • Там же происходит решение всех конфликтов
   • Формируются первые общие сборки ядра
3. Выпуск RC-версий (например, v7.0.l-rc1) — RC-релизы делаются в GIT-ветке landau-next
4. Тестирование — длится до 7 недель (может быть меньше):
   • Выпускаются RC-версии: l-rc1, l-rc2, l-rc3 и т.д.
5. Финальный релиз и отвод стабильной ветки:
   • Выпускаем релиз v7.0.l
   • Создаём стабильную GIT-ветку landau-7.0.y на базе последнего релиза
   • Вся дальнейшая поддержка этой версии ведётся в landau-7.0.y
6. Завершение цикла landau-next:
   • Ветка landau-next останавливает свой рост на первом релизе v7.0.l
   • Переключается на шаг 1, когда в исходном репозитории Linux выходит новый стабильный релиз (например, v7.1)
7. Интеграция новых изменений SUBLEVEL из исходной стабильной версии ядра Linux:
   • Если в исходном репозитории меняется SUBLEVEL (например, 7.0.1), мы интегрируем данный релиз в landau-7.0.y
   • Повышаем свою версию: v7.0.1.l1
   • То есть повышается версия LANDAU Linux, а SUBLEVEL получает новое значение согласно интегрированным изменениям
8. Развитие стабильной версии:
   • Стабильная версия LANDAU Linux v7.0 ведётся в ветке landau-7.0.y
9. Окончание поддержки релиза:
   • Поддержка релиза ветки LANDAU Linux заканчивается, когда версия основного ядра больше не имеет статус стабильной на kernel.org (например, 7.0 достигла статуса EOL)
10. LTS-поддержка:
    • Если основное ядро уходит в LTS, LANDAU поддерживает LTS до конца
    • Приносятся только фиксы LANDAU Linux (без новых фич) и новые SUBLEVEL
11. Гарантии поддержки:
    • LANDAU Linux Owners гарантированно поддерживают одно последнее LTS ядро
    • Про поддержку более старых LTS ядер думаем при наличии ресурсов

🏷️ Пример полной цепочки тегов

Для ядра 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

📚 8. Ссылки и ресурсы

⬅️ Вернуться на страницу LANDAU Linux