Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT →
Ceci est une ancienne révision du document !
Live-build est un programme qui permet de créer un Live à partir d'un système développé en chroot (le système dans le système chroot= change root).
Un Live installable est un système embarqué utilisable sur CDROM/DVD/USB et installable sur tout support de stockage (clé USB, carte SD, disque dur interne). Il se compose d'un squashfs (une grosse archive) qui contient l'intégralité du système, un bootloader (GRUB) pour pouvoir démarrer et accessoirement un installeur (ce sera la cas dans notre exemple).
Le bootloader démarre et lance la décompression du squashfs afin de le rendre utilisable. Dès lors, le Live inséré se comporte comme un système d'exploitation classique.
Dans ce wiki, nous présenterons les options de base ainsi qu'un exemple complet de construction d'un live.
apt update && apt install live-build
Le programme live-build se compose de 3 commandes principales à lancer depuis le répertoire de construction du Live :
lb config
: configurer les options de votre système live.lb build
: fabriquer votre système live à l'aide des dossiers et fichiers construits avec lb config
.lb clean
: nettoyer les dossiers et les fichiers créés avec lb build
pour pouvoir repartir à neuf et construire un nouveau système live à partir de zéro.
Pour construire un Live, placez-vous dans votre répertoire de travail ($HOME/ma_debian_perso par exemple). Vous pouvez alors lancez les commandes lb config
les unes après les autres afin de configurer le Live ou utiliser un script de configuration (à créer dans $HOME/ma_debian_perso/auto/config) qui rassemble toutes les options. Un exemple complet de script est fournit plus bas.
Une fois votre Live configuré, lancez la commande lb build
en root. Cette commande va générer un fichier ISO ou IMG transférable sur CD/DVD/USB pour une utilisation en Live.
La commande lb config
permet de configurer les options principales du Live, l'architecture, les paquets intégrés, la destination du Live (DVD, USB) etc. Pour une liste exhaustive des options disponibles, n'hésitez pas à consulter le man man lb config
.
Voici quelques options à utiliser :
lb config --architecture amd64
lb config --distribution "bullseye"
lb config --archive-areas "main contrib non-free"
man lb config
) :lb config --binary-images "iso-hybrid"
lb config --apt-recommends "true"
live
installera la distribution perso configurée présente sur le Live, none
supprimera la possibilité d'installer le système, netinst
ajoutera l'installeur par le réseau classique :lb config --debian-installer "live"
Plus d'options et d'explications dans l'exemple à suivre…
Pour illustrer ce wiki, nous allons construire un live Debian personnalisé utilisant XFCE comme environnement, accompagné d'une série d'applications choisies pour une utilisation basique. Cet exemple se base sur la construction de Dfiso dont les sources sont disponibles sur GIT.
Pour commencer, nous allons mettre en place un répertoire de travail et y placer les dossiers et fichiers nécessaires à la construction d'un Live. Les commandes qui suivent sont à adapter à votre système et aux souhaits pour votre future distribution personnelle : pensez à vérifier les commandes avant de les exécuter.
Création du répertoire de travail et mise en place des principaux dossiers :
mkdir -p $HOME/ma_debian_perso/auto $HOME/ma_debian_perso/config cd $HOME/ma_debian_perso/auto cp /usr/share/doc/live-build/examples/auto/* ./
Deux dossiers principaux sont créés dans votre répertoire de travail :
La configuration du Live se situe dans le script $HOME/ma_debian_perso/auto/config. Pour l'exemple, voici un script dérivé de celui utilisé pour construire DFiso, la Debian préconfigurée par Debian-Facile :
#!/bin/sh set -e lb config noauto \ --mode "debian" \ --system "live" \ --distribution "bullseye" \ --architecture "amd64" \ --archive-areas "main contrib non-free" \ --security "true" \ --updates "true" \ --backports "false" \ --binary-images "iso-hybrid" \ --bootloaders "syslinux grub-efi" \ --apt-indices "true" \ --apt-recommends "true" \ --apt-secure "true" \ --apt-source-archives "false" \ --linux-package "linux-image linux-headers" \ --debian-installer "live" \ --debian-installer-distribution "bullseye" \ --debian-installer-gui "true" \ --firmware-binary "true" \ --firmware-chroot "true" \ --iso-publisher "Projet DFiso; https://debian-facile.org/dflinux; contact@debian-facile.org" \ --memtest "none" \ --win32-loader "false" \ --clean \ --debug \ --verbose \ --source "false" \ "${@}"
Ce script rassemble les options pour lb config
, il sera appelé lors du lancement de la commande lb build
.
Explications des options présentées :
--system “live”
: pour indiquer que le système généré sera utilisable en session “live”--distribution “bullseye”
: pour indiquer la distribution sur laquelle se base le Live--architecture “amd64”
: pour indiquer l'architecture du futur Live--archive-areas “main contrib non-free”
: pour indiquer les dépôts actifs lors de la construction--security “true”
: pour indiquer l'utilisation des dépôts “security”--updates “true”
: pour intégrer les dépôts “updates” dans les sources du live--backports “false”
: pour ne pas utiliser les dépôts “backports”--binary-images “iso-hybrid”
: pour générer une ISO polyvalente utilisable sur CD/DVD/USB--bootloaders “syslinux grub-efi”
: pour indiquer les 2 bootloaders en cas d'utilisation sur un système BIOS (syslinux) ou UEFI (grub-efi)--apt-indices “true”
: pour activer les informations apt--apt-recommends “true”
: pour utiliser les paquets recommandés par apt--apt-secure “true”
: pour vérifier les signatures des paquets utilisés--apt-source-archives “false”
: pour ne pas intégrer les “deb-src” dans les dépôts du système--linux-package “linux-image linux-headers”
: pour identifier le noyau utilisé et si les “headers” du noyau doivent être intégrés--debian-installer “live”
: pour installer le système préconfiguré lors de l'installation--debian-installer-distribution “bullseye”
: pour indiquer la distribution de l'installeur--debian-installer-gui “true”
: pour indiquer l'utilisation d'un installeur graphique--firmware-binary “true”
: pour ajouter les micrologiciels dans le Live--firmware-chroot “true”
: pour ajouter les micrologiciels dans le système installé--iso-publisher “Projet DFiso; https://debian-facile.org/dflinux; contact@debian-facile.org”
: pour identifier le constructeur de l'ISO--memtest “none”
: pour ne pas intégrer “memtest”--win32-loader “false”
: pour ne pas intégrer le lanceur microsoft--clean
: pour nettoyer les dossiers vides lors de la construction--debug
: pour générer les plus d'infos possible pour les 'log'--verbose
: pour augmenter les retours sur le 'log'--source “false”
: pour ne pas générer les sources complètes du build (avec les sources de tous les paquets utilisés)
Les deux autres scripts présents dans auto/
, “build” et “clean” sont courts et basiques :
Le script de build indique le nom du fichier de 'log' à consulter après construction :
#!/bin/sh set -e lb build noauto "${@}" 2>&1 | tee build.log
Le script de nettoyage indique les dossiers et fichiers à supprimer lors de la commande lb clean
(à lancer en root) :
#!/bin/sh set -e lb clean noauto "${@}" rm -f config/binary config/bootstrap config/chroot config/common config/source rm -f build.log
Comme vous pouvez le constater, le script principal du build auto/build
ne mentionne aucun paquet hormis le noyau “linux-image” et les “linux-headers”. Les paquets sont installés directement depuis une liste, depuis un dossier dédié ou depuis un script additionnel placé dans les “hooks”. Nous allons détailler chaque méthode.
C'est la méthode par défaut. Il suffit de placer une liste de paquets dans le fichier config/packages-lists/maliste.chroot
(“maliste” ou ce que vous voulez tant que vous placez “.chroot” en extension) pour qu'elle soit automatiquement prise en compte par live-build. Cette liste est lue par apt
: vous n'avez pas à vous soucier des dépendances, elles seront automatiquement ajoutées. Les paquets doivent être séparés par un espace, les commentaires (#) sont autorisés.
Voici la liste des paquets pour DFiso :
## dfiso packages ## #base task-french-desktop task-french lsb-release acpi accountsservice user-setup bash bash-completion command-not-found #login lightdm lightdm-gtk-greeter lightdm-gtk-greeter-settings mugshot #desktop & xfce4-apps xfce4 xfce4-terminal xfce4-notifyd xfce4-settings xfce4-taskmanager xarchiver xfburn xfce4-goodies xfce4-power-manager tlp #filer xtra thunar-archive-plugin tumbler-plugins-extra #network hexchat firefox-esr firefox-esr-l10n-fr webext-https-everywhere webext-ublock-origin-firefox thunderbird thunderbird-l10n-fr transmission-gtk network-manager-gnome curl wpasupplicant #office libreoffice libreoffice-gtk3 gnote gnome-calculator mousepad atril hplip-gui fbreader cups-pdf system-config-printer simple-scan xournal pdfarranger #media vlc asunder lame alsa-utils alsa-tools rhythmbox gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly pavucontrol sox mpg123 vorbis-tools flac wavpack #graphics ristretto shotwell gimp cheese #games aisleriot crack-attack four-in-a-row gnome-2048 gnome-chess gnome-mines gnome-nibbles gnome-sudoku quadrapassel gnome-mahjongg #system vrms synaptic gdebi gnome-system-tools dkms gnome-disk-utility gdisk dosfstools ntfs-3g mtools e2fsprogs gnome-software #flatpak flatpak gnome-software-plugin-flatpak #tools catfish zenity zip p7zip-full most baobab dvd+rw-tools xdotool eject deja-dup blueman hardinfo #misc gvfs gvfs-fuse gvfs-backends x11-utils x11-apps numlockx ntp #theme gnome-brave-icon-theme arc-theme numix-gtk-theme numix-icon-theme numix-icon-theme-circle #qt qt5-style-plugins #nonfree alsa-firmware-loaders amd64-microcode atmel-firmware bluez-firmware dahdi-firmware-nonfree firmware-linux firmware-linux-nonfree firmware-misc-nonfree firmware-amd-graphics firmware-atheros firmware-ath9k-htc firmware-b43-installer firmware-b43legacy-installer firmware-bnx2 firmware-bnx2x firmware-brcm80211 firmware-cavium firmware-ipw2x00 firmware-iwlwifi firmware-intel-sound firmware-intelwimax firmware-ivtv firmware-libertas firmware-myricom firmware-netronome firmware-netxen firmware-qlogic firmware-realtek firmware-samsung firmware-siano firmware-ti-connectivity firmware-zd1211 hdmi2usb-fx2-firmware intel-microcode iucode-tool ttf-mscorefonts-installer ttf-xfree86-nonfree unrar
Pour éviter les doublons, vous pouvez vérifier la liste des dépendances de vos paquets depuis le gestionnaire de paquets Synaptic en graphique ou depuis un terminal avec apt-rdepends:
apt update && apt install apt-rdepends
apt-rdepends mon_paquet
Un autre moyen d'ajouter des paquets à votre liveCD est de littéralement les “coller” dedans. En effet, tous les paquets de type debian (.deb) placés dans le dossier config/packages/
seront installés dans le Live.
Attention : cette procédure n'est pas effectuée par apt
mais par dpkg
. Il n'y a donc pas de prise en charge des dépendances : prenez soin de les ajouter dans le même dossier, ou de les ajouter dans la liste des paquets à installer (voir section précédente sur les package-lists).
Les scripts du type “monscript.chroot” placés dans le dossier config/hooks/normal/
seront exécutés dans le chroot avant la compression en squashfs. Vous pouvez donc faire quasiment ce que vous voulez via ces scripts, dont l'ajout de paquet. Un exemple avec l'installation et la configuration de libdvd-pkg qui permettra la lecture des DVD commerciaux sur votre futur système :
#!/bin/sh set -e # installation de libdvd-pkg apt install libdvd-pkg # compilation de libdvdcss2 à partir des sources debian export DEBIAN_FRONTEND=noninteractive dpkg-reconfigure libdvd-pkg
Nous avons vu que la construction d'un Live s'effectuait dans un chroot, un sous-système dans votre système. Nous avons vu que vous pouviez agir sur ce chroot grâce aux options du live-build, mais également depuis les scripts hooks qui modifient le chroot de l'intérieur avant sa compression dans le squashfs.
Nous allons voir comment remplacer ou ajouter des fichiers dans le chroot avant même le processus de construction.
La modification directe du système se fait via le dossier config/includes.chroot
. Tout ce qui sera dans ce dossier se retrouvera dans le chroot, donc dans le squashfs, donc dans le Live. L'arborescence et les droits des ajouts seront conservés lors de la construction.
Vous voulez votre theme_perso disponible dans le Live ? Il suffit de créer un dossier config/includes.chroot/usr/share/themes/
et d'y coller votre dossier theme_perso.
Vous voulez vos fonds d'écran favoris dans le Live ? Il suffit de créer un dossier config/includes.chroot/usr/share/backgrounds/
et d'y coller vos images.
etc.
La modification de la configuration de l'utilisateur se fait via le dossier config/includes.chroot/etc/skel/
aka “skeleton” : tout ce que vous collez dans ce dossier se retrouvera dans le $HOME/user/
de votre Live et dans le $HOME/mon_login/
de votre système installé. Très pratique pour ajouter votre ~/.bashrc
préparés aux petits oignons : collez-le dans config/includes.chroot/etc/skel/.bashrc
.
De la même façon, vous pouvez ajouter de la documentation pour le futur utilisateur dans config/includes.chroot/etc/skel/Documents/ma_doc.pdf
Si vous ajoutez dans le dossier config/includes.chroot/
, un élément qui appartient déjà à un paquet, il sera écrasé par le paquet original lors du build. Par exemple, si vous voulez coller votre version de “ffmpeg” dans config/includes.chroot/usr/bin/ffmpeg
, il sera écrasé par le vrai “ffmpeg” lors de la prochaine mise à jour. Vous pouvez coller le vôtre dans config/includes.chroot/usr/local/bin/ffmpeg
: il ne sera pas écrasé et vous pourrez vous en servir sans soucis depuis un alias approprié,
Vous avez désormais un dossier de build prêt à l'emploi pour construire une Debian personnalisée.
Une fois vos fichiers configurés et vos dossiers complétés, vous pouvez lancer la construction de votre Live depuis le répertoire de travail :
cd $HOME/ma_debian_perso
lb build
Vous pouvez aller boire un thé ou retaper votre chaise de jardin… la construction d'un Live dépend de votre système et des paquets à installer et peut prendre entre 20 minutes et 2 heures…
Au final, un fichier $HOME/ma_debian_perso/live-image-amd64.hybrid.iso
sera généré : Félicitations, c'est votre Live ! Il ne reste plus qu'à le renommer et à la transférer sur un DVD ou une clé USB.
Pour la phase de test, je vous conseille d'installer votre distro sur une machine virtuelle afin de pouvoir noter vos dernières commandes qui seront à répercuter dans le dossier de build.
Conseils pour un bon debug :
Modification du build > build > tests > répercussion des modifications > nettoyage > build … ce processus devra être répété pour parvenir à la distro de vos rêves.
— je reviens de suite … wip
Vous venez de construire une dérivée Debian. Ce n'est pas n'importe quoi, vous utilisez le travail de toute une communauté, alors une petite ligne sérieuse :
Debian est une distribution GNU/Linux, mais pas que… Debian, c'est aussi une ligne de conduite, une charte, et certaines recommandations quant à la distribution de dérivée. Cette ligne de conduite est précisée dans les Debian Derivatives Guidelines (https://wiki.debian.org/Derivatives/Guidelines). je vous conseille vivement de consulter ce document afin de respecter un maximum la distribution grâce à laquelle vous avez pu construire la votre. Merci beaucoup.
Si vous voulez diffuser votre live, ce que vous y ajoutez est de votre responsabilité, donc respectez les licences, créditez les auteurs, placez des liens dans un README… bref soyez responsables de ce que vous diffusez : les débutants ou les curieux de Debian méritent de recevoir un truc propre ;)
— je reviens de suite … wip