diff --git a/docs/live-build/config.md b/docs/live-build/config.md index 421a62e..af0524d 100644 --- a/docs/live-build/config.md +++ b/docs/live-build/config.md @@ -4,7 +4,7 @@ ## config/binary binary stage -``` +```ini # $LB_BINARY_FILESYSTEM: set image filesystem # (Default: fat32) LB_BINARY_FILESYSTEM="fat32" @@ -167,7 +167,7 @@ LB_SWAP_FILE_SIZE="512" ## config/bootstrap bootstrap stage -``` +```ini # $LB_DISTRIBUTION: select distribution to use # (Default: stretch) LB_DISTRIBUTION="stretch" @@ -245,7 +245,7 @@ LB_BOOTSTRAP_QEMU_STATIC="" ## config/chroot chroot stage -``` +```ini # $LB_CHROOT_FILESYSTEM: set chroot filesystem # (Default: squashfs) LB_CHROOT_FILESYSTEM="squashfs" @@ -286,7 +286,7 @@ LB_BACKPORTS="false" ## config/common -``` +```ini # $LB_APT: set package manager # (Default: apt) LB_APT="apt" @@ -409,7 +409,7 @@ ISOHYBRID_OPTIONS="" ## config/source source stage -``` +```ini # $LB_SOURCE: set source option # (Default: false) LB_SOURCE="false" diff --git a/docs/live-build/live-build-apprentissage.md b/docs/live-build/live-build-apprentissage.md index 06c739b..e2607a4 100644 --- a/docs/live-build/live-build-apprentissage.md +++ b/docs/live-build/live-build-apprentissage.md @@ -2,7 +2,7 @@ * 19/05/2017 -``` +```text attention au flood :P [---------------------- Bienvenue @tou-te-s sur ce chan pour la première session de formation empirique live-build Debian :) @@ -26,7 +26,7 @@ en prie, c'est le but, soyez pas timide :) ``` ## principe live-build -``` +```text l'installeur étant buggé pour l'instant le processus par défaut initialisé par le udeb live-build et le processus en ligne appelé sont en conflit. en fait, l'installation fait @@ -48,7 +48,7 @@ donc ça confirme que la différence vient du traitement efi ``` ## conseil -``` +```text le principe de synchronisation des configuration : un dossier de build contenant les sources + un dossier en ligne sur cloud ou serveur + le /home @@ -77,7 +77,7 @@ ils seront potentiellement en conflit dans le futur build si vous ne lez retirez ``` ## live-wrapper -``` +```text alors pour rassurer, effectivement, ce sera le nouvel outil pour faire des live debian mais live-build est maintenu et fabrique des live similaires @@ -156,7 +156,7 @@ ils seront potentiellement en conflit dans le futur build si vous ne lez retirez ce sont des humains :) ``` ## synchronisation -``` +``` text comment tu fais pour exporter tes modif sur git pour avoir tes sources à jours en temps réel ? git push ? ^^ depuis le dossier de build ou l'env de test ? @@ -197,7 +197,7 @@ ils seront potentiellement en conflit dans le futur build si vous ne lez retirez mais c'est le principe ``` ## aparté -``` +```text alors pour le skel je comprends. Mais /usr/share il n'est pas modifié par les paquets lui ? si on peut mais sans ajouter de programmes qui seront appelés plus tard @@ -227,7 +227,7 @@ ils seront potentiellement en conflit dans le futur build si vous ne lez retirez oui ``` ## séparation binary/chroot -``` +```text et donc un autre aspect pratique que je souhaitais souligner à propos de live-build,c'est la séparation binary/chroot visible dans plusieurs dossiers/fichiers. live-build permet de séparer les applications installées dans le live de celles effectivement intégrées dans la distribution finale binary c'est pour le live et chroot pour l'installation ? @@ -268,7 +268,7 @@ ils seront potentiellement en conflit dans le futur build si vous ne lez retirez multi-possibilités ce live-build :) ``` ### installer depuis live -``` +```text Tu n'as toujours pas trouvé pour appeler les preseed depuis le live ? Pour ne pas retourner sur syslinux pour installer le système pour installer sans retourner sur syslinus, il y a le lanceur d'installation de bureau @@ -309,7 +309,7 @@ ils seront potentiellement en conflit dans le futur build si vous ne lez retirez c'est une possibilité ``` ## les hooks -``` +```text donc les hooks sont des scripts qui s'exécutent dans le chroot juste avant de le quitter et de le compresser en squashfs même moment que interractive mais en automatique @@ -363,10 +363,10 @@ ils seront potentiellement en conflit dans le futur build si vous ne lez retirez * avec suivi git * irc 20/05/2017 -``` +```text [20:04:44] attention au flood .... ``` -``` +```text [----------------------------------------------------------------------- Bonsoir et bienvenue dans la session de simulation de construction d'une ISO personnalisée Debian :D - but de la session de travail : décomposer la personnalisation et suivre les modifications apportées @@ -389,11 +389,11 @@ le contenu de cette session sera ensuite disponible sous forme de wiki+archives notez que le processus simulé ce soir n'est pas fixé et que ce n'est qu'un exemple ... vous êtes libre ! :D -----------------------------------------------------------------------] ``` -``` +```shell git clone https://arpinux@framagit.org/arpinux/dfl-apprentissage.git ``` -``` +```text donc cd ./dfl-apprentissage puis git pull quand j'ai fait les modifs :) @@ -418,7 +418,7 @@ git clone https://arpinux@framagit.org/arpinux/dfl-apprentissage.git script qui va définir les arguments lancés à lb build donc les options de ce script que vous pouvez parcourir ``` -``` +```text pour la liste complète des options acceptés, un man lb config renseignera mais le but de ce soir est vraiment d'en faire le minimum pour un résultat optimal donc dans les options indiquées dans auto/config, on remarque la ligne "architecture" qui permet de construire un live avec une arch différente de celle du système hôte @@ -434,7 +434,7 @@ git clone https://arpinux@framagit.org/arpinux/dfl-apprentissage.git pour se faire Son ISO :) ``` -``` +```text donc la suite de la personnalisation réside dans les applications à installer ce soir, on va faire simple, on va coller les mêmes apps dans le live et dans le système final mais il est possible de séparer les paquets pour avoir des applications en plus/moins dans le live et le système installé, on y reviendra au final @@ -446,7 +446,7 @@ git clone https://arpinux@framagit.org/arpinux/dfl-apprentissage.git vous pouvez pull depuis les sources ou visitez les commits https://git.framasoft.org/arpinux/dfl-apprentissage/commits/master ``` -``` +```shell git pull ``` ``` @@ -468,7 +468,7 @@ git pull mais si vous avez les sources devant les yeux, vous avez capté le truc :) bref ``` -``` +```text l'autre liste, la *.chroot, est destinée aux paquets installés dans le live + dans le système installé donc la seconde liste avec les applications elle est détaillée car je n'ai pas mis de gros méta-paquets @@ -485,7 +485,7 @@ git pull vous pouvez yu aller, ça ne gênera pas la suite des ajouts ,quoique vous modifiez :) voilà, j'espère que vous avez eu le temps de modifier votre liste, vous pourrez y revenir tout à l'heure :) ``` -``` +```text passons à une truc débile et rigolo la bannière de l'installeur graphique :) et donc, avant de taper dans les trucs longs et embêtant @@ -503,7 +503,7 @@ git pull mais ça rassure aussi l'utilisateur de savoir que le builder s'est un peu fait chier à personnaliser son truc et n'a pas juste balancé 2 walls et 3 applis :) c'est pas anodin :) ``` -``` +```text passons à plus sérieux le menu de boot du live il est contrôlé par syslinux @@ -538,7 +538,7 @@ git pull donc faites simple, ce sera mieux :) et puis, ce n'est pas non plus l plus important, le tout étant d'avoir la bonne langue au démarrage :) ``` -``` +```text on va attaquer maintenant le plus cool la custo directe du système et du user ça se passe dans /config/includes.chroot/ @@ -603,7 +603,7 @@ git pull avec les mêmes extensions *.binary pour le live et *.chroot pour le système installé donc c'est fini pour la custo de base ... ``` -``` +```text pour un premier build fonctionnel , pas de custo du user en phase 1 pourquoi car il faut d'abord choper les valeurs par défaut avant de les modifier @@ -633,7 +633,7 @@ git pull et c'est aussi pour ça que pour ce soir, je ne vous conseille pas de custo le user autant vous concentrer sur les applications à installer ``` -``` +```text donc si vous êtes partant, on peut lb build :D depuis les sources, vous pouvez envoyer la commande sudo lb build @@ -643,7 +643,7 @@ git pull et que vous avez vu le processus en global :) ``` -``` +```text pour ajouter des dépôts debian supplémentaires, comme les dépôts externes, tu places un fichier avec l'adresse dans /config/archives tu n'as pas besoin de coller la clé :) pour les préférences apt/pinning @@ -651,14 +651,12 @@ git pull et voilà :) la ligne "experimentale" sera prise en compte lors du build et à l'installation et sera ajouté à /etc/apt/sources.list.d/experimental.list ``` -``` +```text donc si je je veux mettre un .mozilla c'est dans config/includes.chroot/etc/skel/.mozilla et il vient de ton système ? ok, j'ai compris ça. de la clé live que j'ai testé tout à l'heure... :) -``` -``` donc quand tu veux ajouter une config dans le skeleton, tu recréer l’arborescence des fichiers si je comprends bien... oui, comme si includes.chroot/ était la racine du système sauf pour /home qui reste vide @@ -677,7 +675,7 @@ git pull ``` ## un essai de bidouille live sid -``` +```shell #!/bin/sh set -e lb config noauto \ @@ -707,7 +705,7 @@ lb config noauto \ --win32-loader "false" \ "${@}" ``` -``` +```text le live fonctionne l'install aussi :D erreur au chargement des noyaux diff --git a/docs/live-build/man-fr.md b/docs/live-build/man-fr.md index ad9d65e..da527a1 100644 --- a/docs/live-build/man-fr.md +++ b/docs/live-build/man-fr.md @@ -2,7 +2,6 @@ * date du doc: 2016-07-04 23:09:28 +0000, à jour au 1/06/2017 * version: instable -* mise en forme: à terminer * relecture: à faire ## 1. à propos de ce manuel @@ -140,12 +139,12 @@ Afin d'apporter des modifications au manuel anglais, vous devez modifier les fichiers adéquats dans `manual/en/` mais avant de soumettre votre contribution, veuillez prévisualiser votre travail. Afin de prévisualiser _live-manual_, assurez-vous que les paquets nécessaires sont installés en exécutant: -``` +```shell # apt-get install make po4a ruby ruby-nokogiri sisu-complete ``` Vous pouvez compiler _live-manual_ dans le répertoire de niveau supérieur de votre Git checkout en exécutant: -``` +```shell $ make build ``` Comme il faut un certain temps pour construire le manual dans toutes les @@ -156,21 +155,21 @@ format html, mais sans les fichiers html segmentés, et `PROOF=2` construit _live-manual_ au format pdf, mais seulement les portraits A4 et US. C'est pourquoi l'utilisation de l'une ou l'autre des possibilités peut sauver une quantité considérable de temps, par exemple: -``` +```shell $ make build PROOF=1 ``` Lors de la révision d'une des traductions, il est possible de construire une seule langue en exécutant, par exemple: -``` +```shell $ make build LANGUAGES=de ``` Il est également possible de construire par type de document, par exemple, -``` +```shell $ make build FORMATS=pdf ``` Ou combiner les deux, par exemple: -``` +```shell $ make build LANGUAGES=de FORMATS=html ``` Après avoir relu votre travail et vous être assuré que tout va bien, n'utilisez @@ -369,26 +368,26 @@ Il suffit d'installer _live-build_ comme n'importe quel autre paquet: _live-build_ est développé en utilisant le système de contrôle de version Git. Dans les systèmes basés sur Debian, il est fourni par le paquet _git_. Pour examiner le dernier code, exécutez: -``` +```shell $ git clone git://http://anonscm.debian.org/git/debian-live/live-build.git ``` Vous pouvez compiler et installer votre propre paquet Debian en exécutant: -``` +```shell $ cd live-build $ dpkg-buildpackage -b -uc -us $ cd .. ``` Maintenant, installez les fichiers récemment construits qui vous intéressent, par exemple -``` +```shell # dpkg -i live-build_4.0-1_all.deb ``` Vous pouvez également installer _live-build_ directement sur votre système en exécutant: -``` +```shell # make install ``` et le désinstaller avec: -``` +```shell # make uninstall ``` @@ -422,7 +421,7 @@ ci-dessous. Veuillez vous assurer que vous êtes familiarisé avec les termes mentionnés dans Termes. * Examiner les sources de _live-boot_ et _live-config_ -``` +```shell $ git clone git://http://anonscm.debian.org/git/debian-live/live-boot.git $ git clone git://http://anonscm.debian.org/git/debian-live/live-config.git ``` @@ -442,7 +441,7 @@ de **buster**, créez _live-boot_ dans un chroot **buster**. Si votre distributi cible correspond à votre distribution vous pouvez créer directement sur le système de construction en utilisant `dpkg-buildpackage` (fourni par le paquet _dpkg-dev_) : -``` +```shell $ cd live-boot $ dpkg-buildpackage -b -uc -us $ cd ../live-config @@ -464,7 +463,7 @@ supposant que vous construisiez une image live dans le répertoire courant et ayez généré tous les fichiers .deb pour une version unique des deux paquets dans le répertoire ci-dessus, ces commandes bash copieraient tous les paquets appropriés, y compris les back-ends par défaut : -``` +```shell $ cp ../live-boot{_,-initramfs-tools,-doc}*.deb config/packages.chroot/ $ cp ../live-config{_,-sysvinit,-doc}*.deb config/packages.chroot/ ``` @@ -613,12 +612,12 @@ d'utiliser un nom qui vous aide à identifier l'image avec laquelle vous travaillez dans chaque répertoire, surtout si vous travaillez ou expérimentez avec différents types d'images. Dans ce cas, vous allez construire un système par défaut, nous allons donc l'appeler, par exemple, live-default. -``` +```shell $ mkdir live-default && cd live-default ``` Ensuite, exécutez la commande `lb config`. Cela va créer une hiérarchie "config/" dans le répertoire courant pour être utilisée par d'autres commandes: -``` +```shell $ lb config ``` Aucun paramètre n'est passé à ces commandes, donc les défauts seront utilisés @@ -626,7 +625,7 @@ pour l'ensemble de ses diverses options. Consultez La commande lb config pour plus de détails. Maintenant que la hiérarchie "config/" existe, créez l'image avec la commande `lb build` : -``` +```shell # lb build ``` Ce processus peut prendre un certain temps, en fonction de la vitesse de votre @@ -651,7 +650,7 @@ DVD-R(W), des supports optiques ou une clé USB. Graver une image ISO est facile. Il suffit d'installer /{xorriso} et de l'utiliser à partir de la ligne de commande pour graver l'image. Par exemple: -``` +```shell # apt-get install xorriso $ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed live-image-i386.hybrid.iso ``` @@ -669,7 +668,7 @@ la sortie de `dmesg` après avoir branché le périphérique, ou mieux encore, ` Une fois que vous êtes sûr d'avoir le nom correct de l'appareil, utilisez la commande `cp` pour copier l'image sur la clé. *Ceci écrasera tout fichier déjà existant sur votre clé!* -``` +```shell $ cp live-image-i386.hybrid.iso ${USBSTICK} $ sync ``` @@ -685,12 +684,12 @@ Après avoir copié `live-image-i386.hybrid.iso` sur une clé USB, la première partition sera utilisée par le système live. Pour utiliser l'espace libre restant, utilisez un outil de partitionnement tel que _gparted_ ou _parted_ afin de créer une nouvelle partition sur la clé. -``` +```shell # gparted ${USBSTICK} ``` Quand la partition est créée, vous devez y créer un système de fichiers où `${PARTITION}` est le nom de la partition, comme `/dev/sdb2`. Un choix possible serait ext4. -``` +```shell # mkfs.ext4 ${PARTITION} ``` *Remarque:* Si vous voulez utiliser l'espace supplémentaire avec Windows, ce @@ -764,11 +763,11 @@ Tout d'abord, installez _qemu-kvm_ si votre processeur le gère. Sinon, installez _qemu_. Dans ce cas, le nom du programme est `qemu` au lieu de `kvm` dans les exemples suivants. Le paquet _qemu-utils_ est également valable pour créer des images de disques virtuels avec `qemu-img`. -``` +```shell # apt-get install qemu-kvm qemu-utils ``` Démarrer une image ISO est simple: -``` +```shell $ kvm -cdrom live-image-i386.hybrid.iso ``` Voir les pages de manuel pour plus de détails. @@ -776,7 +775,7 @@ Voir les pages de manuel pour plus de détails. #### 4.6.2 test d'une image iso avec virtualbox Afin de tester l'ISO avec _virtualbox_: -``` +```shell # apt-get install virtualbox virtualbox-qt virtualbox-dkms $ virtualbox ``` @@ -788,7 +787,7 @@ la machine. _virtualbox_, vous pouvez inclure le paquet des pilotes VirtualBox X.org, _virtualbox-guest-dkms_ et _virtualbox-guest-x11_, dans votre configuration de _live-build_. Sinon, la résolution est limitée à 800x600. -``` +```shell $ echo "virtualbox-guest-dkms virtualbox-guest-x11" >> config/package-lists/my.list.chroot ``` @@ -796,7 +795,7 @@ Pour faire fonctionner le paquet dmks, il faut également installer le paquet linux-headers pour le noyau utilisé dans l'image. Au lieu de lister manuellement le paquet _linux-headers_ correct dans la liste de paquets crée ci-dessus, _live-build_ peut faire cela automatiquement. -``` +```shell $ lb config --linux-packages "linux-image linux-headers" ``` @@ -814,17 +813,17 @@ correctement les images hybrides, vous devez utiliser une image HDD. *Remarque:* si vous avez créé une image ISO hybride avec l'exemple précédent, vous devrez nettoyer votre répertoire de travail avec la commande `lb clean` (voir La commande lb clean): -``` +```shell # lb clean --binary ``` Exécutez la commande `lb config` comme avant, sauf que cette fois en spécifiant le type d'image HDD: -``` +```shell $ lb config -b hdd ``` Construisez maintenant l'image avec la commande `lb build` -``` +```shell # lb build ``` Quand la création de l'image est finie, un fichier `live-image-i386.img` doit @@ -841,7 +840,7 @@ De même, pour tester une image HDD avec Qemu, installez _qemu_ comme décrit ci-dessus dans Test d'une image ISO avec QEMU. Ensuite, exécutez `kvm` ou `qemu`, selon la version dont votre système hôte a besoin en précisant `live-image-i386.img` comme le premier disque dur. -``` +```shell $ kvm -hda live-image-i386.img ``` @@ -854,7 +853,7 @@ le système Debian par défaut sans X.org. Elle peut être démarrée sur le ré *Remarque:* Si vous avez réalisé quelques-uns des exemples précédents, vous aurez besoin de nettoyer votre répertoire de travail avec la commande #lb clean#: -``` +```shell # lb clean ``` @@ -869,7 +868,7 @@ chroot, aussi). Exécutez la commande suivante pour configurer votre image pour démarrer sur le réseau: -``` +```shell $ lb config -b netboot --net-root-path "/srv/debian-live" --net-root-server "192.168.0.2" ``` @@ -883,7 +882,7 @@ démarrage. Assurez-vous que ceux-ci sont fixées à des valeurs appropriées po votre réseau et serveur. Construisez maintenant l'image avec la commande `lb build` -``` +```shell # lb build ``` @@ -912,7 +911,7 @@ annoncer l'emplacement du chargeur d'amorçage PXE. Voici un exemple source d'inspiration, écrit pour le serveur ISC DHCP `isc-dhcp-server` dans le fichier de configuration `/etc/dhcp/dhcpd.conf`: -``` +```shell # /etc/dhcp/dhcpd.conf - configuration file for isc-dhcp-server ddns-update-style none; @@ -944,7 +943,7 @@ Vous devriez installer le paquet /tftpd-hpa/. Il peut servir tous les fichiers contenus dans un répertoire racine, d'habitude `/srv/tftp`. Pour le laisser servir des fichiers dans `/srv/debian-live/tftpboot`, exécutez comme utilisateur root la commande suivante: -``` +```shell # dpkg-reconfigure -plow tftpd-hpa ``` et remplissez le nouveau répertoire du serveur tftp @@ -960,11 +959,11 @@ Vous devez installer le paquet _nfs-kernel-server_. Ensuite, rendez l'image du système de fichiers disponible via NFS en ajoutant une ligne comme la suivante `/etc/exports`: -``` +```shell /srv/debian-live *(ro,async,no_root_squash,no_subtree_check) ``` et indiquez cette exportation au serveur NFS avec la commande suivante: -``` +```shell # exportfs -rv ``` @@ -990,7 +989,7 @@ Afin de rendre notre vie plus facile, nous pouvons utiliser la virtualisation. * Installer _qemu_, _bridge-utils_, _sudo_. Éditer `/etc/qemu-ifup`: -``` +```shell #!/bin/sh sudo -p "Password for $0:" /sbin/ifconfig $1 172.20.0.1 echo "Executing /etc/qemu-ifup" @@ -1028,7 +1027,7 @@ sous `binary/live/`. Les fichiers sont appelés `vmlinuz`, `initrd.img` et Il est également possible d'extraire les fichiers d'une image iso déjà existant. Pour ce faire, on doit monter l'image comme suit: -``` +```shell # mount -o loop image.iso /mnt ``` Les fichiers se trouvent sous le répertoire `live/`. Dans ce cas précis, il @@ -1058,7 +1057,7 @@ Ensuite, démarrer à partir de la clé usb et taper `fetch=URL/CHEMIN/DU/FICHIE aux options de démarrage. _live-boot_ va télécharger le fichier squashfs et le stocker dans la ram. De cette façon, il est possible d'utiliser le système de fichiers compressé téléchargé comme un système live normal. Par exemple: -``` +```shell append boot=live components fetch=http://192.168.2.50/images/webboot/filesystem.squashfs ``` @@ -1126,7 +1125,7 @@ Exécuter la commande `lb config` sans aucun argument crée le sous-répertoire `config/` qui est peuplée avec certains paramètres dans fichiers de configuration, et deux sous-répertoires `auto/` et `local/` avec une arborescence de fichiers. -``` +```shell $ lb config [2015-01-06 19:25:58] lb config P: Creating config tree for a debian/stretch/i386 system @@ -1140,11 +1139,11 @@ Gestion d'une configuration pour plus de détails). Normalement, vous voulez indiquer certaines options. Par exemple, pour spécifier le gestionnaire de paquets à utiliser lors de la construction de l'image: -``` +```shell $ lb config --apt aptitude ``` Il est possible d'indiquer plusieurs options, telles que: -``` +```shell $ lb config --binary-images netboot --bootappend-live "boot=live components hostname=live-host username=live-user" ... ``` @@ -1251,7 +1250,7 @@ niveau _live-build_ après avoir lu la documentation mise à jour. Pour votre commodité, _live-build_ est fourni avec des scripts shell d'exemple, pour les copier et les modifier. Lancez une nouvelle configuration par défaut, puis copiez les exemples: -``` +```shell $ mkdir mylive && cd mylive && lb config $ mkdir auto $ cp /usr/share/doc/live-build/examples/auto/* auto/ @@ -1259,7 +1258,7 @@ $ cp /usr/share/doc/live-build/examples/auto/* auto/ Modifiez `auto/config` en ajoutant des options comme bon vous semble. Par exemple: -``` +```shell #!/bin/sh lb config noauto \ --architectures i386 \ @@ -1297,7 +1296,7 @@ pour les images précompilées Par exemple, pour construire une image standard, utilisez le dépôt `live-images` comme suit: -``` +```shell $ mkdir live-images && cd live-images $ lb config --config git://http://anonscm.debian.org/git/debian-live/live-images.git $ cd images/standard @@ -1309,7 +1308,7 @@ en ajoutant simplement `--archive-areas "main contrib non-free"`. Vous pouvez éventuellement définir un raccourci dans votre configuration Git en ajoutant la ligne suivante à votre `${HOME}/.gitconfig`: -``` +```shell [url "git://http://anonscm.debian.org/git/debian-live/"] insteadOf = lso: ``` @@ -1318,7 +1317,7 @@ Cela vous permet d'utiliser `lso:` quand vous voulez indiquer l'adresse d'un dépôt `debian-live.alioth.debian.org`. Si vous supprimez le suffixe optionnel `.git`, commencer une nouvelle image en utilisant cette configuration est aussi simple que: -``` +```shell $ lb config --config lso:live-images ``` Le clonage de la totalité du dépôt `live-images` copie les configurations @@ -1443,7 +1442,7 @@ nom de code ici. (Voir Termes pour plus de détails.) L'option `--distribution` influence non seulement la source des paquets dans l'archive, mais indique également à _live-build_ comment construire chaque distribution prise en charge. Par exemple, pour construire sur **unstable**, **sid**, précisez: -``` +```shell $ lb config --distribution sid ``` @@ -1452,7 +1451,7 @@ principales divisions de l'archive. Dans Debian, ce sont `main`, `contrib` et `non-free`. Seule `main` contient des logiciels qui font partie de la distribution Debian, c'est donc la valeur par défaut. Une ou plusieurs valeurs peuvent être indiquées, par exemple: -``` +```shell $ lb config --archive-areas "main contrib non-free" ``` @@ -1493,7 +1492,7 @@ une étape antérieure. Pour définir les miroirs de distribution utilisés pendant la construction pour pointer vers un miroir local, il suffit de paramétrer `--mirror-bootstrap` et `--mirror-chroot-security` comme suit. -``` +```shell $ lb config --mirror-bootstrap http://localhost/debian/ \ --mirror-chroot-security http://localhost/debian-security/ ``` @@ -1515,7 +1514,7 @@ utilisateurs. Autrement, vous pouvez indiquer vos propres valeurs, comme indiqué dans l'exemple ci-dessous. Une image construite avec cette configuration ne serait appropriée que pour les utilisateurs sur un réseau où le "`mirror`" est accessible. -``` +```shell $ lb config --mirror-binary http://mirror/debian/ \ --mirror-binary-security http://mirror/debian-security/ \ --mirror-binary-backports http://mirror/debian-backports/ @@ -1536,7 +1535,7 @@ pendant l'exécution du système live. Par exemple, `config/archives/live.list.chroot` vous permet d'installer les paquets du dépôt des instantanés debian live pendant la construction du système live. -``` +```shell deb http://debian-live.alioth.debian.org/ sid-snapshots main contrib non-free ``` @@ -1584,7 +1583,7 @@ Choisir apt ou aptitude pour plus de détails. La façon la plus simple de remplir votre liste de paquets consiste à utiliser un métapaquet de tâche maintenu par votre distribution. Par exemple: -``` +```shell $ lb config $ echo task-gnome-desktop > config/package-lists/desktop.list.chroot ``` @@ -1601,7 +1600,7 @@ Tous les métapaquets de tâches sont préfixés avec `task-`, donc un moyen rap pour déterminer lesquels sont disponibles (même s'il peut y avoir une poignée de faux positifs dont le nom correspond mais qui ne sont pas des métapaquets) est de faire correspondre le nom du paquet avec: -``` +```shell $ apt-cache search --names-only ^task- ``` En plus, vous trouverez d'autres métapaquets à des fins diverses. Certains sont @@ -1610,7 +1609,7 @@ que d'autres sont des pièces individuelles spécialisées d'un Debian Pure Blen comme les métapaquets `education-*`. Pour lister tous les métapaquets dans l'archive, installez le paquet `debtags` et listez tous les paquets ayant l'étiquette `role::metapackage` comme suit: -``` +```shell $ debtags search role::metapackage ``` @@ -1659,7 +1658,7 @@ En fait, la sélection des paquets avec la commande `grep-aptavail` (du paquet `dctrl-tools`) est si utile que `live-build` fournit un script `Packages` à titre de commodité. Ce script accepte deux arguments: `field` et `pattern`. Ainsi, vous pouvez créer une liste avec le contenu suivant: -``` +```shell $ lb config $ echo '! Packages Priority standard' > config/package-lists/standard.list.chroot ``` @@ -1675,7 +1674,7 @@ sélection des paquets qui font sens, comme `DISTRIBUTION`, `ARCHITECTURES` ou `ARCHIVE_AREAS`. Par exemple, pour installer `ia32-libs` si `--architectures amd64` est indiqué: -``` +```shell #if ARCHITECTURES amd64 ia32-libs #endif @@ -1683,7 +1682,7 @@ ia32-libs Vous pouvez tester pour un certain nombre de valeurs, par exemple pour installer _memtest86+_ si `--architectures i386` ou `--architectures amd64` est indiqué: -``` +```shell #if ARCHITECTURES i386 amd64 memtest86+ #endif @@ -1692,7 +1691,7 @@ memtest86+ Vous pouvez également tester avec des variables pouvant contenir plus d'une valeur, par exemple pour installer _vrms_ si `contrib` ou `non-free` est indiqué via `--archive-areas`: -``` +```shell #if ARCHIVE_AREAS contrib non-free vrms #endif @@ -1741,7 +1740,7 @@ langue et des paquets de méthodes de saisie, vous devez les indiquer dans votre configuration si vous les voulez. Par exemple, une image de bureau GNOME contenant la prise en charge de l'allemand pourrait inclure les métapaquets de tâches suivants: -``` +```shell $ lb config $ echo "task-gnome-desktop task-laptop" >> config/package-lists/my.list.chroot $ echo "task-german task-german-desktop task-german-gnome-desktop" >> config/package-lists/my.list.chroot @@ -1765,7 +1764,7 @@ l'option `--linux-packages`. Par exemple, supposons que vous construisiez une image pour l'architecture `amd64` et ajoutiez l'archive expérimentale pour faire des essais. Pour installer le noyau `linux-image-3.18.0-trunk-amd64` vous pouvez configurer cette image comme suit: -``` +```shell $ lb config --linux-packages linux-image-3.18.0-trunk $ echo "deb http://ftp.debian.org/debian/ experimental main" > config/archives/experimental.list.chroot ``` @@ -1918,7 +1917,7 @@ d'intérêt. Si vous ne voulez pas inclure les index d'APT dans l'image, vous pouvez les omettre avec: -``` +```shell $ lb config --apt-indices false ``` @@ -1931,7 +1930,7 @@ exemple, l'utilisateur doit faire `apt-get update` pour créer ces index. Si vous trouvez que l'installation des paquets recommandés fait trop gonfler votre image, à condition d'être prêt à faire face aux conséquences décrites ci-dessous, vous pouvez désactiver l'option par défaut d'APT avec: -``` +```shell $ lb config --apt-recommends false ``` @@ -1972,7 +1971,7 @@ vous ayez inclus quelque chose de `snapshot.debian.org` à des fins de test et que vous vouliez indiquer `Acquire::Check-Valid-Until=false` pour satisfaire APT avec le fichier `Release` obsolète. Vous le feriez comme dans l'exemple suivant, avec l'ajout de la nouvelle option après la valeur par défaut `--yes`: -``` +```shell $ lb config --apt-options "--yes -oAcquire::Check-Valid-Until=false" ``` @@ -2005,7 +2004,7 @@ autres paquets avec une priorité inférieure à la priorité par défaut de sor que seuls les paquets que vous voulez soient installés à partir de **sid** pendant la construction et que tous les autres viennent de la distribution du système cible, **buster**. Ce qui suit devrait accomplir cela: -``` +```shell $ echo "deb http://mirror/debian/ sid main" > config/archives/sid.list.chroot $ cat >> config/archives/sid.pref.chroot << EOF Package: live-* @@ -2026,7 +2025,7 @@ que l'utilisateur soit invité à stocker les mots de passe wifi dans le trousseau de clés. Cette liste comprend _lxde-core_, qui recommande _gksu_, qui à son tour recommande _gnome-keyring_. Donc, vous voulez omettre le paquet recommandé _gnome-keyring_. Cela peut être fait en ajoutant ce qui suit à `config/apt/preferences`: -``` +```shell Package: gnome-keyring Pin: version * Pin-Priority: -1 @@ -2078,12 +2077,12 @@ Pour inclure des fichiers, il suffit de les ajouter à votre répertoire `config/includes.chroot`. Ce répertoire correspond au répertoire racine `/` du système live. Par exemple, pour ajouter un fichier `/var/www/index.html` dans le système live, utilisez: -``` +```shell $ mkdir -p config/includes.chroot/var/www $ cp /path/to/my/index.html config/includes.chroot/var/www ``` Votre configuration aura alors le schéma suivant: -``` +```text -- config [...] |-- includes.chroot @@ -2106,7 +2105,7 @@ includes. Cela fonctionne de façon similaire aux chroot local includes. Par exemple, supposons que les fichiers `~/video_demo.*` sont des vidéos de démonstration du système live décrits par et liés par une page d'index HTML. Copiez simplement le matériel dans `config/includes.binary/` comme suit: -``` +```shell $ cp ~/video_demo.* config/includes.binary/ ``` @@ -2200,11 +2199,11 @@ Vous pouvez indiquer d'autres groupes pour l'utilisateur live en utilisant une des possibilités pour configurer _live-config_. Par exemple, pour ajouter l'utilisateur live au groupe `fuse`, vous pouvez ajouter le fichier suivant dans `config/includes.chroot/etc/live/config/user-setup.conf`: -``` +```text LIVE_USER_DEFAULT_GROUPS="audio cdrom dip floppy video plugdev netdev powerdev scanner bluetooth fuse" ``` ou utiliser -``` +```shell live-config.user-default-groups=audio,cdrom,dip,floppy,video,plugdev,netdev,powerdev,scanner,bluetooth,fuse# ``` comme paramètre d'amorçage. @@ -2215,7 +2214,7 @@ faire facilement comme suit: Pour modifier le nom de l'utilisateur par défaut, vous pouvez simplement l'indiquer dans votre configuration: -``` +```shell $ lb config --bootappend-live "boot=live components username=live-user" ``` @@ -2238,7 +2237,7 @@ Les paramètres régionaux par défaut pendant la construction d'un système Liv sont `locales=en_US.UTF-8`. Pour définir les paramètres régionaux qui doivent être générés, utilisez le paramètre `locales` dans l'option `--bootappend-live` de `lb config`, par exemple -``` +```shell $ lb config --bootappend-live "boot=live components locales=de_CH.UTF-8" ``` @@ -2259,7 +2258,7 @@ utilisez les paramètres de démarrage `keyboard-layouts`, `keyboard-variants`, peut trouver les options valides dans `/usr/share/X11/xkb/rules/base.lst`. Pour trouver les dispositions et les variantes correspondantes à une langue, essayez de rechercher le nom anglais de la nation où la langue est parlée, par exemple: -``` +```shell $ egrep -i '(^!|german.*switzerland)' /usr/share/X11/xkb/rules/base.lst ! model ! layout @@ -2276,7 +2275,7 @@ Chaque variante présente une description de la disposition appliquée. Souvent, seule la disposition doit être configurée. Par exemple, pour obtenir les fichiers des paramètres régionaux de l'allemand et la disposition du clavier suisse allemand dans X, utilisez: -``` +```shell $ lb config --bootappend-live "boot=live components locales=de_CH.UTF-8 keyboard-layouts=ch" ``` @@ -2284,7 +2283,7 @@ Toutefois, pour les cas d'utilisation très spécifiques, on peut inclure d'autres paramètres. Par exemple, pour mettre en place un système français avec une disposition French-Dvorak (Bépo) avec un clavier USB TypeMatrix EZ-Reach 2030, utilisez: -``` +```shell $ lb config --bootappend-live \ "boot=live components locales=fr_FR.UTF-8 keyboard-layouts=fr keyboard-variants=bepo keyboard-model=tm2030usb" ``` @@ -2298,7 +2297,7 @@ manuel `keyboard(5)` pour plus de détails et des exemples des variables valeurs `keyboard-layouts` (voir `setxkbmap(1)` option `-variant`). On peut utiliser des valeurs vides; par exemple pour régler deux dispositions, une par défaut US QWERTY et l'autre US Dvorak, utilisez: -``` +```shell $ lb config --bootappend-live \ "boot=live components keyboard-layouts=us,us keyboard-variants=,dvorak" ``` @@ -2355,7 +2354,7 @@ pour plus de détails. Voici quelques exemples montrant comment préparer un volume à utiliser pour la persistance. Cela peut être, par exemple, une partition ext4 sur un disque dur ou sur une clé usb créée avec: -``` +```shell # mkfs.ext4 -L persistence /dev/sdb1 ``` @@ -2363,13 +2362,13 @@ Voir aussi Utilisation de l'espace disponible sur une clé USB. Si vous avez déjà une partition sur votre périphérique, vous pouvez simplement modifier l'étiquette avec l'un des exemples suivants: -``` +```shell ` tune2fs -L persistence /dev/sdb1 ` for ext2,3,4 filesystems ``` Voici un exemple montrant comment créer un fichier image avec un système de fichiers ext4 pour être utilisé pour la persistance: -``` +```shell $ dd if=/dev/null of=persistence bs=1 count=0 seek=1G # for a 1GB sized image file $ /sbin/mkfs.ext4 -F persistence ``` @@ -2380,14 +2379,14 @@ répertoire et non pas tout le contenu de `/usr`, vous pouvez utiliser l'option «union». Si le fichier image se trouve dans votre répertoire personnel, copiez-le à la racine du système de fichiers de votre disque dur et montez-le dans `/mnt` comme suit: -``` +```shell # cp persistence / # mount -t ext4 /persistence /mnt ``` Ensuite, créez le fichier `persistence.conf` ajoutant du contenu et démontez le fichier image. -``` +```shell # echo "/usr union" >> /mnt/persistence.conf # umount /mnt ``` @@ -2408,7 +2407,7 @@ de manuel _persistence.conf_(5), mais un simple exemple devrait suffire pour la plupart des utilisations. Imaginons que nous voulions rendre notre répertoire personnel et APT cache persistants dans un système de fichiers ext4 sur la partition `/dev/sdb1`: -``` +```shell # mkfs.ext4 -L persistence /dev/sdb1 # mount -t ext4 /dev/sdb1 /mnt # echo "/home" >> /mnt/persistence.conf @@ -2485,13 +2484,13 @@ dans le système live avec lequel vous allez utiliser la partition persistante chiffrée. Pour installer _cryptsetup_ sur votre machine: -``` +```shell # apt-get install cryptsetup ``` Pour installer _cryptsetup_ dans votre système live, ajouter à vos listes de paquets: -``` +```shell $ lb config $ echo "cryptsetup" > config/package-lists/encryption.list.chroot ``` @@ -2501,7 +2500,7 @@ essentiellement besoin de créer une nouvelle partition, la chiffrer et démarre avec les paramètres `persistence` et `persistence-encryption=luks`. Nous aurions pu déjà anticipée cette étape et ajoutée ces paramètres de démarrage selon la procédure habituelle: -``` +```shell $ lb config --bootappend-live "boot=live components persistence persistence-encryption=luks" ``` @@ -2515,51 +2514,51 @@ La première étape est de brancher votre clé usb et de déterminer quel dispositif il est. La méthode recommandée pour lister les dispositifs dans _live-manual_ est utiliser `ls -l /dev/disk/by-id`. Après cela, créer une nouvelle partition et la chiffrer avec un mot de passe comme suit: -``` +```shell # cryptsetup --verify-passphrase luksFormat /dev/sdc2 ``` Ensuite, ouvrir la partition luks dans le mappeur de dispositifs virtuel. Utilisez n'importe quel nom que vous aimez. Nous utilisons **live** ici à titre d'exemple: -``` +```shell # cryptsetup luksOpen /dev/sdc2 live ``` La prochaine étape est de remplir le dispositif avec des zéros avant de créer le système de fichiers: -``` +```shell # dd if=/dev/zero of=/dev/mapper/live ``` Maintenant, nous sommes prêts à créer le système de fichiers. Notez que nous ajoutons l'étiquette `persistence` de sorte que le dispositif est monté en tant que magasin de persistance au moment du démarrage. -``` +```shell # mkfs.ext4 -L persistence /dev/mapper/live ``` Pour continuer avec notre configuration, nous avons besoin de monter le dispositif, par exemple dans `/mnt`. -``` +```shell # mount /dev/mapper/live /mnt ``` Et créer le fichier `persistence.conf` à la racine de la partition. Ceci est, comme expliqué précédemment, strictement nécessaire. Voir Le fichier persistence.conf. -``` +```shell # echo "/ union" > /mnt/persistence.conf ``` Puis, démontez le point de montage: -``` +```shell # umount /mnt ``` Et éventuellement, bien qu'il pourrait être un bon moyen de sécuriser les données que nous venons d'ajouter à la partition, nous pouvons fermer le dispositif: -``` +```shell # cryptsetup luksClose live ``` @@ -2604,7 +2603,7 @@ Pour modifier le délai de démarrage d'une image `iso-hybrid`, vous pouvez modifier un fichier **isolinux.cfg** en précisant le timeout dans les unités de 1/10 secondes. Un **isolinux.cfg** modifié pour démarrer cinq secondes plus tard serait semblable à ceci: -``` +```text include menu.cfg default vesamenu.c32 prompt 0 @@ -2699,7 +2698,7 @@ Debian dans les images, il doit être spécifiquement activé avec `lb config`. même, veuillez noter que pour que l'installateur "de bureau" fonctionne, le noyau du système live doit correspondre au noyau que `d-i` utilise pour l'architecture indiquée. Par exemple: -``` +```shell $ lb config --architectures i386 --linux-flavours 586 \ --debian-installer live $ echo debian-installer-launcher >> config/package-lists/my.list.chroot @@ -2718,7 +2717,7 @@ pas disponibles pendant les installations normales ». Ce type de personnalisation se fait mieux avec _live-build_ en plaçant la configuration dans un fichier `preseed.cfg` inclus dans `config/includes.installer/`. Par exemple, pour préconfigurer les paramètres régionaux pour `en_US`: -``` +```shell $ echo "d-i debian-installer/locale string en_US" \ >> config/includes.installer/preseed.cfg ``` @@ -2788,14 +2787,14 @@ du dépôt dans lequel vous souhaitez travailler. Pour plus d'informations sur l façon de modifier _live-manual_, consultez Contribuer à ce document. * Téléchargez la clé publique : -``` +```shell $ mkdir -p ~/.ssh/keys $ wget http://debian-live.alioth.debian.org/other/keys/git@debian-live.alioth.debian.org -O ~/.ssh/keys/git@debian-live.alioth.debian.org $ wget http://debian-live.alioth.debian.org/other/keys/git@debian-live.alioth.debian.org.pub -O ~/.ssh/keys/git@debian-live.alioth.debian.org.pub $ chmod 0600 ~/.ssh/keys/git@debian-live.alioth.debian.org* ``` * Ajoutez la section suivante à votre configuration openssh-client : -``` +```shell $ cat >> ~/.ssh/config << EOF Host debian-live.alioth.debian.org Hostname debian-live.alioth.debian.org @@ -2805,12 +2804,12 @@ Host debian-live.alioth.debian.org EOF ``` * Clonez _live-manual_ avec ssh : -``` +```shell $ git clone ssh://git.debian.org/git/debian-live/live-manual.git $ cd live-manual && git checkout debian-next ``` * Assurez-vous d'avoir renseigné les champs d'auteur et d'email dans Git : -``` +```shell $ git config user.name "John Doe" $ git config user.email john@example.org ``` @@ -2820,11 +2819,11 @@ $ cd live-manual && git checkout debian-next * Effectuez vos modifications. Dans cet exemple, vous devriez commencer par écrire une nouvelle section traitant l'application des correctifs et ensuite préparer l'ajout des fichiers et écrire le message de livraison comme ceci : -``` +```shell $ git commit -a -m "Adding a section on applying patches." ``` * Envoyez votre commit au serveur : -``` +```shell $ git push ``` @@ -2942,7 +2941,7 @@ besoin des informations suivantes: Vous pouvez générer un journal du processus de construction en utilisant la commande `tee`. Nous recommandons de faire cela automatiquement avec un script `auto/build` (voir Gestion d'une configuration pour les détails). -``` +```shell # lb build 2>&1 | tee build.log ``` Au démarrage, _live-boot_ et _live-config_ stockent un journal dans @@ -2982,7 +2981,6 @@ Si vous ne savez pas quel composant est responsable du bogue ou si le bogue est un bogue général concernant les systèmes live, vous pouvez remplir un rapport de bogue sur le pseudo-paquet debian-live. - Toutefois, nous apprécierions que vous essayiez de le réduire en fonction de l'endroit où le bogue apparaît. @@ -3102,14 +3100,14 @@ de `foo`. * Utilisez le «style Linux» des sauts de ligne: Mal: -``` +```shell if foo; then bar fi ``` Bien: -``` +```shell if foo then bar @@ -3119,13 +3117,13 @@ fi * La même chose vaut pour les fonctions: Mal: -``` +```shell Foo () { bar } ``` Bien: -``` +```shell Foo () { bar @@ -3147,24 +3145,24 @@ Foo () l'attribution des valeurs aux variables: Mal: -``` +```shell FOO=bar ``` Bien: -``` +```shell FOO="bar" ``` -* Si plusieurs variables sont utilisées, utilisez les guillemets pourl'expression complète: +* Si plusieurs variables sont utilisées, utilisez les guillemets pour l'expression complète: Mal: -``` +```shell if [ -f "${FOO}"/foo/"${BAR}"/bar ] then foobar fi ``` Bien: -``` +```shell if [ -f "${FOO}/foo/${BAR}/bar" ] then foobar @@ -3235,7 +3233,7 @@ modifications des utilisateurs. Un courriel pour l'annonce d'une évolutioun mineure peut être généré en utilisant le modèle ci-dessous et la commande suivante: -``` +```shell $ sed \ -e 's|@MAJOR@|9.0|g' \ -e 's|@MINOR@|9.0.1|g' \ @@ -3331,7 +3329,7 @@ un correctif ou contribuer avec une traduction, vous devriez savoir que le serveur git fournit un fichier `mrconfig` pour faciliter la manipulation de multiples dépôts. Pour l'utiliser, vous devez installer le paquet _mr_, puis lancer: -``` +```shell $ mr bootstrap http://debian-live.alioth.debian.org/other/mr/mrconfig ``` @@ -3368,7 +3366,7 @@ commodité, fixez par défaut votre système de construction dans variables `LB_MIRROR_*` correspondantes à votre miroir préféré. Tous les autres miroirs utilisés dans la construction seront choisis par défaut à partir de ces valeurs. Par exemple: -``` +```shell LB_MIRROR_BOOTSTRAP="http://mirror/debian/" LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security/" LB_MIRROR_CHROOT_BACKPORTS="http://mirror/debian-updates/" @@ -3384,7 +3382,7 @@ uniquement des paquets de base (pas de Xorg) et quelques paquets de prise en charge live, en guise de premier exercice dans l'utilisation de _live-build_. Vous ne pouvez pas faire plus simple que cela: -``` +```shell $ mkdir tutorial1 ; cd tutorial1 ; lb config ``` @@ -3394,7 +3392,7 @@ dans ce cas, utilisée immédiatement pour construire une image par défaut. Maintenant, en tant que superutilisateur, construisez l'image en enregistrant un journal avec `tee`. -``` +```shell # lb build 2>&1 | tee build.log ``` En supposant que tout se passe bien, après un certain temps, le répertoire @@ -3414,7 +3412,7 @@ apprenant à appliquer des personnalisations. Dans ce tutoriel, nous allons créer une image utilisable comme un utilitaire de navigation web, ce qui servira d'introduction à la personnalisation d'images live. -``` +```shell $ mkdir tutorial2 $ cd tutorial2 $ lb config @@ -3431,7 +3429,7 @@ nous laissons cela en exercice pour le lecteur. Construisez l'image, encore une fois en tant que superutilisateur, et gardez un journal comme dans Tutoriel 1: -``` +```shell # lb build 2>&1 | tee build.log ``` Encore une fois, vérifiez que l'image est OK et faites un test, comme dans Tutoriel 1: @@ -3453,13 +3451,13 @@ d'autoconfiguration via `auto` scripts tel que décrit dans Gestion d'une configuration. #### 18.4.1 première révision -``` +```shell $ mkdir -p tutorial3/auto $ cp /usr/share/doc/live-build/examples/auto/* tutorial3/auto/ $ cd tutorial3 ``` Éditez `auto/config` comme suit: -``` +```shell #!/bin/sh lb config noauto \ @@ -3469,11 +3467,11 @@ lb config noauto \ ``` Exécutez `lb config` pour générer l'arbre de configuration, en utilisant le script `auto/config` qu'on a créé: -``` +```shell $ lb config ``` Remplissez maintenant votre liste de paquets locaux: -``` +```shell $ echo "task-lxde-desktop firefox hexchat" >> config/package-lists/my.list.chroot ``` Tout d'abord, `--architectures i386` assure que sur notre système de @@ -3485,7 +3483,7 @@ métapaquet de la tâche _lxde_ pour nous donner un bureau minimal. Et enfin, nous avons ajouté deux premiers paquets préférés: _firefox_ et _hexchat_. Maintenant, construisez l'image: -``` +```shell # lb build ``` Notez que contrairement aux deux premiers tutoriels, nous n'avons plus besoin @@ -3495,7 +3493,7 @@ Une fois que vous avez testé l'image (comme dans Tutoriel 1) et vous êtes satisfait de son fonctionnement, il est temps d'initialiser notre dépôt `git`, en n'ajoutant que les scripts auto que nous avons juste créés, puis de faire le premier commit: -``` +```shell $ git init $ cp /usr/share/doc/live-build/examples/gitignore .gitignore $ git add . @@ -3513,21 +3511,21 @@ construction précédente à l'exception du cache, ce qui évite d'avoir à retélécharger les paquets. Cela garantit que la commande `lb build` suivante exécutera à nouveau toutes les étapes pour régénérer les fichiers de notre nouvelle configuration. -``` +```shell # lb clean ``` Ajoutez maintenant le paquet _vlc_ à votre liste de paquets locaux dans `config/package-lists/my.list.chroot`: -``` +```shell $ echo vlc >> config/package-lists/my.list.chroot ``` Construisez à nouveau: -``` +```shell # lb build ``` Testez et, quand vous êtes satisfait, faites le commit de la prochaine révision: -``` +```shell $ git commit -a -m "Ajout du lecteur de média vlc." ``` Bien sûr, des changements plus compliqués de la configuration sont possibles, @@ -3556,7 +3554,7 @@ désactivez «recommends» pour faire un système minimal. Puis créez deux list initiales de paquets: la première générée par un script fourni par _live-build_ nommée `Packages` (voir Générer listes de paquets), et la seconde incluant _xorg_, _gdm3_, _metacity_ et _xvnc4viewer_. -``` +```shell $ mkdir vnc-kiosk-client $ cd vnc-kiosk-client $ lb config -a i386 -k 686-pae --apt-recommends false @@ -3569,7 +3567,7 @@ votre image correctement. Une façon facile d'énumérer les paquets recommendés est d'utiliser _apt-cache_. Par exemple: -``` +```shell $ apt-cache depends live-config live-boot ``` @@ -3578,14 +3576,14 @@ paquets recommandés par _live-config_ et _live-boot_: `user-setup` pour l'autologin et `sudo` un logiciel essentiel pour arrêter le système. En outre, il pourrait être utile d'ajouter `live-tools` pour copier l'image dans la RAM et `eject` pour éjecter le support live. Alors: -``` +```shell $ echo "live-tools user-setup sudo eject" > config/package-lists/recommends.list.chroot ``` Après cela, créez le répertoire `/etc/skel` dans `config/includes.chroot` avec un fichier `.xsession` personnalisé pour l'utilisateur par défaut qui va lancer _metacity_ et _xvncviewer_, en reliant le port `5901` sur un serveur à `192.168.1.2`: -``` +```shell $ mkdir -p config/includes.chroot/etc/skel $ cat > config/includes.chroot/etc/skel/.xsession << EOF #!/bin/sh @@ -3597,7 +3595,7 @@ exit EOF ``` Construire l'image: -``` +```shell # lb build ``` @@ -3618,18 +3616,18 @@ détruire l'intégrité des paquets contenus, telle que la purge des données de localisation via le paquet _localepurge_, ou d'autres optimisations "intrusives". On notera en particulier que nous utilisons `--debootstrap-options` pour créer un système minimal à partir de zéro. -``` +```shell $ lb config --apt-indices false --apt-recommends false --debootstrap-options "--variant=minbase" --firmware-chroot false --memtest none ``` Pour faire que l'image fonctionne correctement, nous devons ajouter à nouveau au moins deux paquets recommandés qui sont laissés de côté par l'option `--apt-recommends false`. Voir Régler APT pour économiser de l'espace -``` +```shell $ echo "user-setup sudo" > config/package-lists/recommends.list.chroot ``` Maintenant, construisez l'image de la manière habituelle: -``` +```shell # lb build 2>&1 | tee build.log ``` Sur le système de l'auteur au moment de l'écriture, la configuration ci-dessus @@ -3672,18 +3670,18 @@ pourrions être chanceux et trouver ces noms par essais et erreurs, il existe un outil, `grep-dctrl`, qui peut être utilisé pour découvrir les descriptions des tâches dans tasksel-data. Pour la préparation, assurez-vous d'avoir ces deux outils: -``` +```shell # apt-get install dctrl-tools tasksel-data ``` Maintenant, nous pouvons rechercher les tâches appropriées, d'abord avec: -``` +```shell $ grep-dctrl -FTest-lang de /usr/share/tasksel/descs/debian-tasks.desc -sTask Task: german ``` Par cette commande, nous découvrons que la tâche est appelée, assez clairement, german. Maintenant, pour trouver les tâches liées: -``` +```shell $ grep-dctrl -FEnhances german /usr/share/tasksel/descs/debian-tasks.desc -sTask Task: german-desktop Task: german-kde-desktop @@ -3695,7 +3693,7 @@ morceaux ensemble. En nous rappelant grâce à Utilisation des métapaquets que les métapaquets sont préfixés `task-`, nous précisons ces paramètres de la langue pendant l'amorçage, puis nous ajoutons les paquets de priorité standard et tous nos métapaquets découverts à notre liste de paquets comme suit: -``` +```shell $ mkdir live-gnome-ch $ cd live-gnome-ch $ lb config \ @@ -3915,7 +3913,7 @@ pour traiter les fichiers texte et pour produire plusieurs formats. Il est recommandé de consulter le manuel SiSU [link: ] pour se familiariser avec son balisage, ou bien tapez: -``` +```shell $ sisu --help markup ``` Voici quelques exemples de balisage qui peuvent éventuellement vous aider: @@ -3931,7 +3929,7 @@ il produit: ``foo``. Utiliser par exemple, pour les noms des commandes. Et aussi pour souligner certains mots clés ou des choses comme les chemins. - Pour les blocs de code: -``` +```text code{ $ foo @@ -3940,7 +3938,7 @@ code{ }code ``` il produit: -``` +```text $ foo # bar ``` @@ -4044,7 +4042,7 @@ Les traducteurs ne doivent jamais traduire: - Les chemins -``` +```text ============================================================================== Titre: Manuel Live Systems diff --git a/docs/live-build/preseed-stretch.md b/docs/live-build/preseed-stretch.md index 7baa925..68dfadb 100644 --- a/docs/live-build/preseed-stretch.md +++ b/docs/live-build/preseed-stretch.md @@ -3,7 +3,7 @@ Contents of the preconfiguration file (for stretch) ## Localization -``` +```text # Preseeding only locale sets language, country and locale. d-i debian-installer/locale string en_US @@ -20,7 +20,7 @@ d-i keyboard-configuration/xkb-keymap select us ``` ## Network configuration -``` +```text # Disable network configuration entirely. This is useful for cdrom # installations on non-networked devices where the network questions, # warning and long timeouts are a nuisance. @@ -91,7 +91,7 @@ d-i netcfg/wireless_wep string ``` ## Network console -``` +```text # Use the following settings if you wish to make use of the network-console # component for remote installation over SSH. This only makes sense if you # intend to perform the remainder of the installation manually. @@ -102,7 +102,7 @@ d-i netcfg/wireless_wep string ``` ## Mirror settings -``` +```text # If you select ftp, the mirror/country string does not need to be set. #d-i mirror/protocol string ftp d-i mirror/country string manual @@ -117,7 +117,7 @@ d-i mirror/http/proxy string ``` ## Account setup -``` +```text # Skip creation of a root account (normal user account will be able to # use sudo). #d-i passwd/root-login boolean false @@ -146,7 +146,7 @@ d-i mirror/http/proxy string #d-i passwd/user-default-groups string audio cdrom video ``` ## Clock and time zone setup -``` +```text # Controls whether or not the hardware clock is set to UTC. d-i clock-setup/utc boolean true @@ -161,7 +161,7 @@ d-i clock-setup/ntp boolean true ``` ## Partitioning -``` +```text ## Partitioning example # If the system has free space you can choose to only partition that space. # This is only honoured if partman-auto/method (below) is not set. @@ -295,7 +295,7 @@ d-i partman/confirm_nooverwrite boolean true ``` ## Base system installation -``` +```text # Configure APT to not install recommended packages by default. Use of this # option can result in an incomplete system and should only be used by very # experienced users. @@ -307,7 +307,7 @@ d-i partman/confirm_nooverwrite boolean true ``` ## Apt setup -``` +```text # You can choose to install non-free and contrib software. #d-i apt-setup/non-free boolean true #d-i apt-setup/contrib boolean true @@ -339,7 +339,7 @@ d-i partman/confirm_nooverwrite boolean true ``` ## Package selection -``` +```text #tasksel tasksel/first multiselect standard, web-server, kde-desktop # Individual additional packages to install @@ -356,7 +356,7 @@ d-i partman/confirm_nooverwrite boolean true ``` ## Boot loader installation -``` +```text # Grub is the default boot loader (for x86). If you want lilo installed # instead, uncomment this: #d-i grub-installer/skip boolean true @@ -400,7 +400,7 @@ d-i grub-installer/with_other_os boolean true ``` ## Finishing up the installation -``` +```text # During installations from serial console, the regular virtual consoles # (VT1-VT6) are normally disabled in /etc/inittab. Uncomment the next # line to prevent this. @@ -420,7 +420,7 @@ d-i finish-install/reboot_in_progress note #d-i debian-installer/exit/poweroff boolean true ``` ## Preseeding other packages -``` +```text # Depending on what software you choose to install, or if things go wrong # during the installation process, it's possible that other questions may # be asked. You can preseed those too, of course. To get a list of every @@ -431,7 +431,7 @@ d-i finish-install/reboot_in_progress note ``` ### Advanced options -``` +```text ### Running custom commands during the installation # d-i preseeding is inherently not secure. Nothing in the installer checks # for attempts at buffer overflows or other exploits of the values of a