Участие в разработке KDE Linux

Команда KDE Linux всегда рада помощи в превращении KDE Linux в операционную систему будущего!

Чтобы пообщаться с разработчиками KDE Linux, напишите в Matrix.
Чтобы предложить изменения, создайте запрос на слияние в одном из соответствующих репозиториев git.
Чтобы сообщить о неполадках в самой операционной системе KDE Linux (устройство ОС, интеграция, системные службы и тому подобное), создайте заявку на invent.kde.org и не обращайте внимания на пугающий красный баннер вверху страницы.
О проблемах в KDE Plasma и приложениях KDE сообщайте на bugs.kde.org.
Чтобы получить помощь по вопросам, связанным с KDE Linux, напишите на discuss.kde.org и пометьте сообщение меткой «kde-linux».

Образы CI

Загляните в журнал сборки своего конвейера: в нём указано, где опубликованы образы.

Просмотреть образы можно и здесь.

Ускорение локальной сборки

Чтобы ускорить локальные сборки, создайте в корне репозитория файл mkosi.local.conf с таким содержимым:

[Content]
Environment=LOCALE_GEN="en_US.UTF-8 UTF-8" # замените на свою локаль`
Environment=MIRRORS_COUNTRY=us # замените на код своей страны`
Environment=PARALLEL_DOWNLOADS=50 # если у вас быстрое подключение к интернету

Docker при этом должен использовать драйвер хранилища Btrfs, иначе толку не будет.

Если файловая система основной системы — Btrfs (как в KDE Linux), добавьте в /etc/docker/daemon.json следующее

{
  "storage-driver": "btrfs"
}

Это описано в официальной документации Docker.

Если основная система работает не на Btrfs, том Btrfs можно создать поверх файла:

systemctl stop docker.socket docker.service || true
fallocate -l 64G /store/docker.btrfs
mkfs.btrfs /store/docker.btrfs
[ -d /var/lib/docker ] || mkdir /var/lib/docker
mount /store/docker.btrfs /var/lib/docker
systemctl restart docker.socket docker.service

Затем выполните:

./build_docker.sh --incremental

Сборка собственных образов системы

Собственные образы KDE Linux можно собирать, чтобы локально проверять интеграцию пакетов или изменения в системе. При сборке используется mkosi, запущенный в контейнере Docker.

Чтобы добавить в образ свои пакеты, впишите их имена в нужные файлы конфигурации (например, в раздел [Packages] файла mkosi.conf или в отдельные файлы .packages) до запуска сценария сборки.

Запустите сборку командой:

./build_docker.sh

После успешной сборки в каталоге mkosi.output/ появится файл образа .iso.

Быстрая проверка в Virt-Manager

Быстрее всего проверить изменения, загрузив образ .iso в виртуальной машине сразу как готовый диск, без полной установки.

Откройте Virtual Machine Manager и запустите мастер New Virtual Machine.
Выберите Local Install Media и укажите собранный файл .iso.
Выделите не менее 4 ГБ оперативной памяти и 2 ядра процессора.
Важно: в параметрах виртуальной машины проверьте, что для Firmware выбрано UEFI, а Secure Boot отключён.

О более постоянной установке и о работе с другими средствами виртуализации — VirtualBox, UTM — рассказано в руководстве Установка в виртуальной машине.

Проверка изменений с помощью openQA

KDE Linux проверяет образы системы перед публикацией автоматическим набором тестов openQA. Набор загружает образы в виртуальных машинах и прогоняет основные сценарии: установку новой системы, обновление уже установленной и проверку её работы. Так выявляются ухудшения, которые при ручной проверке локальной сборки можно и не заметить.

Если изменение затрагивает сборку образов, установку, обновления, системные службы или рабочую среду, подумайте, нужно ли покрыть его автоматическими тестами. О том, как их писать, рассказано в статье openQA для разработчиков.

Статья предоставлена Harald Sitterи Nate Graham и распространяется под лицензией CC-BY-4.0.