Pomôžte vyvíjať KDE Linux

Tím KDE Linux vždy ocení pomoc pri vývoji KDE Linux na operačný systém budúcnosti!

• Pre komunikáciu s vývojármi KDE Linux použite Matrix.
• Pre navrhnutie zmien odošlite Merge Request v jednom z relevantných git úložísk.
• Pre nahlásenie problémov v samotnom operačnom systéme KDE Linux (t.j. dizajn OS, integrácia, systémové služby atď.) použite invent.kde.org a ignorujte strašidelný červený banner v hornej časti stránky.
• Pre nahlásenie problémov v KDE Plasma alebo akýchkoľvek aplikáciách KDE použite bugs.kde.org.
• Pre získanie pomoci s niečím súvisiacim s KDE Linux použite discuss.kde.org a označte svoj príspevok značkou "kde-linux".

CI obrazy

Skontrolujte zostavovací protokol pre váš pipeline. Mal by uvádzať, kde boli obrazy publikované.

Obrazy si môžete prezrieť aj odtiaľto.

Zlepšenie rýchlosti lokálnej zostavy

Pre zrýchlenie lokálnych zostáv vytvorte súbor mkosi.local.conf v koreňovom adresári úložiska s nasledujúcim obsahom:

[Content]
Environment=LOCALE_GEN="en_US.UTF-8 UTF-8" # nahraďte svojím locale`
Environment=MIRRORS_COUNTRY=us # nahraďte svojím kódom krajiny`
Environment=PARALLEL_DOWNLOADS=50 # ak je vaše internetové pripojenie rýchle

Musíte používať úložný ovládač Btrfs pre docker, inak to nebude poriadne fungovať.

Ak váš hostiteľský súborový systém používa Btrfs (ako KDE Linux), pridajte do /etc/docker/daemon.json nasledovné

{
  "storage-driver": "btrfs"
}

Oficiálnu dokumentáciu docker, ktorá to vysvetľuje, nájdete tu.

Ak nepoužívate Btrfs pre váš hostiteľský počítač, môžete stále vytvoriť Btrfs zväzok podporovaný súborom takto:

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

Potom spustite:

./build_docker.sh --incremental

Zostavenie vlastných systémových obrazov

Môžete generovať vlastné obrazy KDE Linuxu na lokálne testovanie integrácie balíkov alebo systémových úprav. Proces zostavenia používa mkosi zabalený v Docker kontajneri.

Ak chcete zahrnúť vlastné balíky, pridajte požadované názvy balíkov do príslušných konfiguračných súborov (napríklad sekcie [Packages] v súbore mkosi.conf alebo konkrétnych súborov .packages) pred spustením zostavovacieho skriptu.

Spustite zostavenie pomocou:

./build_docker.sh

Po úspešnom dokončení zostavenia bude výstupom súbor obrazu .iso umiestnený v mkosi.output/.

Rýchle testovanie pomocou Virt-Manager

Najrýchlejší spôsob, ako otestovať vaše zmeny, je zaviesť obraz .iso priamo ako existujúci disk vo virtuálnom stroji, čím sa obíde celý inštalačný proces.

1. Otvorte Virtual Machine Manager a spustite sprievodcu Nový virtuálny stroj.
2. Vyberte Local Install Media a zvoľte vygenerovaný súbor .iso.
3. Prideľte aspoň 4 GB RAM a 2 jadrá CPU.
4. Dôležité: V konfigurácii VM sa uistite, že Firmware je nastavený na UEFI a Secure Boot je vypnutý.

Pre trvalejšie nastavenie alebo pokyny na použitie iných virtualizačných nástrojov ako VirtualBox alebo UTM si pozrite príručku Inštalácia vo virtuálnom stroji.

Testovanie zmien pomocou openQA

KDE Linux používa na testovanie systémových obrazov pred ich zverejnením automatizovanú testovaciu sadu openQA. Sada zavádza obrazy vo virtuálnych strojoch a prechádza základné postupy vrátane inštalácie nového systému, aktualizácie existujúceho a overenia funkčnosti nainštalovaného systému. Pomáha to zachytiť regresie, ktoré pri ručnom testovaní lokálneho zostavenia nemusia byť zjavné.

Ak sa vaša zmena týka zostavovania obrazu, inštalácie, aktualizácií, systémových služieb alebo pracovného prostredia, zvážte, či ju majú pokrývať automatizované testy. Ako pre ňu napísať testy, sa dozviete v openQA pre vývojárov.

Článok napísal Harald Sitter, a Nate Graham pod licenciou CC-BY-4.0.