Manuel Debian Live

À propos

1. À propos de ce manuel

1.1 Pour les impatients
1.2 Terminologie
1.3 Auteurs
1.4 Contribuer à ce document
1.4.1 Appliquer des modifications
1.4.2 Traduction

2. À propos du projet Debian Live

2.1 Motivation
2.1.1 Quel est le problème avec les systèmes live actuels
2.1.2 Pourquoi créer notre propre système live?
2.2 Philosophie
2.2.1 Seulement des paquets inchangés de Debian «main»
2.2.2 Pas de configuration des paquets du système live
2.3 Contact

Utilisateur

3. Installation

3.1 Exigences
3.2 Installation de live-build
3.2.1 À partir du dépôt Debian
3.2.2 À partir du code source
3.2.3 À partir des instantanés
3.3 Installation de live-boot et live-config
3.3.1 À partir du dépôt Debian
3.3.2 À partir du code source
3.3.3 À partir des instantanés

4. Les bases

4.1 Qu'est-ce c'est un système live?
4.2 Premières étapes: la construction d'une image ISO hybride
4.3 Utilisation d'une image ISO hybride live
4.3.1 Graver une image ISO sur un support physique
4.3.2 Copie d'une image ISO hybride sur une clé USB
4.3.3 Démarrer le support live
4.4 Utiliser une machine virtuelle pour les tests
4.4.1 Test d'une image ISO avec QEMU
4.4.2 Test d'une image ISO avec virtualbox-ose
4.5 Construction d'une image HDD
4.6 Utiliser une image HDD
4.6.1 Test d'une image HDD avec Qemu
4.6.2 Utilisation de l'espace disponible sur une clé USB
4.7 Construction d'une image netboot
4.7.1 Serveur DHCP
4.7.2 Serveur TFTP
4.7.3 Serveur NFS
4.7.4 Guide pratique pour expérimenter avec une image Netboot
4.7.5 Qemu
4.7.6 VMWare Player

5. Aperçu des outils

5.1 Le paquet live-build
5.1.1 La commande lb config
5.1.2 La commande lb build
5.1.3 La commande lb clean
5.2 Le paquet live-boot
5.3 Le paquet live-config

6. Gestion d'une configuration

6.1 Traiter les modifications de configuration
6.1.1 Pourquoi utiliser des scripts auto? Que font-ils?
6.2 Utilisez scripts auto d'exemple
6.3 Cloner une configuration publiée via Git

7. Vue d'ensemble de la personnalisation

7.1 Configuration pendant la construction vs. l'amorçage
7.2 Étapes de la construction
7.3 Supplément lb config avec des fichiers
7.4 Tâches de personnalisation

8. Personnalisation de l'installation de paquets

8.1 Sources des paquets
8.1.1 Distribution, archive areas et mode
8.1.2 Miroirs de distribution
8.1.3 Miroirs de distribution utilisés au temps de construction
8.1.4 Miroirs de distribution utilisés au moment de l'exécution
8.1.5 Dépôts additionnels
8.2 Choisir les paquets à installer
8.2.1 Listes de paquets
8.2.2 Using metapackages
8.2.3 Listes de paquets locaux
8.2.4 Listes locaux de paquets binaires
8.2.5 Générer listes de paquets
8.2.6 Utilisant des conditionnels dans les listes de paquets
8.2.7 Tâches de bureau et de la langue
8.3 Installation des paquets modifiés ou de tiers
8.3.1 Utilisant packages.chroot pour installer paquets personnalisés
8.3.2 Utiliser un dépôt APT pour installer des paquets personnalisés.
8.3.3 Les paquets personnalisés et APT
8.4 Configuration d'APT au moment de la construction
8.4.1 Choisir apt ou aptitude
8.4.2 Utilisation d'un proxy avec APT
8.4.3 Tweaking APT to save space
8.4.4 Passer des options à apt ou aptitude
8.4.5 APT pinning

9. Personnalisation des contenus

9.1 Includes
9.1.1 Live/chroot local includes
9.1.2 Binary local includes
9.2 Hooks
9.2.1 Live/chroot local hooks
9.2.2 Hooks au moment du démarrage
9.2.3 Binary local hooks
9.3 Préconfigurer questions de debconf

10. Personnalisation des comportements au moment de l'exécution

10.1 Personnalisation de l'utilisateur Live
10.2 Personnalisation des paramètres régionaux et de la langue
10.3 Persistance
10.3.1 Le fichier live-persistence.conf
10.3.2 Utilisation de plusieurs dispositifs de persistance

11. Personnalisation de l'image binaire

11.1 Chargeur d'amorçage
11.2 Métadonnées ISO

12. Personnalisation de l'installateur Debian

12.1 Types de l'installateur Debian
12.2 Personnalisation de l'installateur Debian par préconfiguration
12.3 Personnalisation de contenu pour l'Installateur Debian

Projet

13. Rapporter des bogues

13.1 Problèmes connus
13.2 Reconstruire à partir de zéro
13.3 Utilisez paquets mis à jour
13.4 Recueillir l'information
13.5 Isoler le cas qui échoue, si possible
13.6 Utilisez le paquet adéquat pour rapporter le bogue
13.6.1 Au moment de la construction tandis l'amorçage
13.6.2 Au moment de la construction tandis l'installation de paquets
13.6.3 Au moment du démarrage
13.6.4 Au moment de l'exécution
13.7 Faire les recherches
13.8 Où rapporter les bogues

14. Style du code

14.1 Compatibilité
14.2 Indentation
14.3 Adaptateur
14.4 Variables
14.5 Autres

15. Procédures

15.1 Télécharger Udebs
15.2 Évolutions majeures
15.3 Èvolutions mineures
15.3.1 Dernière évolution mineure d'une version Debian
15.3.2 Modèle pour l'annonce d'une évolution mineure

Exemples

16. Exemples

16.1 En utilisant les exemples
16.2 Tutorial 1: Une image standard
16.3 Tutoriel 2: Un utilitaire de navigateur Web
16.4 Tutoriel 3: Une image personnalisée
16.4.1 Première révision
16.4.2 Deuxième révision
16.5 Un client Kiosk VNC
16.6 Une image de base pour une clé USB de 128M
16.7 Un bureau KDE localisé et installateur

Appendix

17. Style guide

17.1 Guidelines for authors
17.1.1 Linguistic features
17.1.2 Procedures
17.2 Guidelines for translators
17.2.1 Translation hints

Manuel Debian Live

Projet

13. Rapporter des bogues

Debian Live est loin d'être parfait, mais nous voulons le rendre aussi proche que possible de parfait - avec votre aide. N'hésitez pas à signaler un bogue. Il est préférable de remplir un rapport deux fois plus que jamais. Toutefois, ce chapitre contient des recommandations pour présenter des rapports de bogues.

Pour les impatients:

  • Commencez toujours par vérifier les mises à jour de la situation de l'image sur notre page d'accueil ‹http://live.debian.net/› pour voir les problèmes connus.
  • Toujours essayer de reproduire le bogue avec les versions les plus récentes de live-build, live-boot, live-config et live-tools avant de présenter un rapport de bogue.
  • Essayez de donner des informations aussi précises que possible sur le bogue. Cela comprend (au moins) la version de live-build, live-boot, live-config et live-tools, de la distribution utilisée et du système live que vous construisez.
  • 13.1 Problèmes connus

    Parce que les distributions Debian testing et Debian unstable sont une cible mouvante, quand vous les spécifiez comme les distributions du système cible, une construction avec succès n'est pas toujours possible.

    Si cela provoque trop de difficulté pour vous, ne pas construire un système basé sur testing or unstable, mais plutôt utiliser stable. live-build fait toujours défaut à la version stable.

    Les problèmes connus sont énumérés sous la section "status" sur notre page à ‹http://live.debian.net/›.

    Il est hors cadre de ce manuel vous former correctement à identifier et corriger les problèmes dans les paquets des distributions de développement, cependant, il y a deux choses que vous pouvez toujours essayer: Si une construction échoue lorsque la distribution cible est testing, essayez unstable. Si unstable ne fonctionne pas non plus, revenir à testing et fixer la nouvelle version du paquet qui échoue de unstable (voir APT pinning pour plus de détails).

    13.2 Reconstruire à partir de zéro

    Afin de s'assurer que un bogue en particulier n'est pas causé par un système construit malpropre, s'il vous plaît toujours reconstruire l'ensemble du système live à partir de zéro pour voir si le bogue est reproductible.

    13.3 Utilisez paquets mis à jour

    L'utilisation de paquets obsolètes peut causer des problèmes importants en essayant de reproduire (et finalement régler) votre problème. Assurez-vous que votre système de construction est mis à jour et tous les paquets inclus dans votre image sont mis à jour aussi.

    13.4 Recueillir l'information

    S'il vous plaît fournir assez d'informations avec votre rapport. Inclure au moins la version exacte de live-build où le bogue est rencontré et les mesures pour le reproduire. S'il vous plaît utilisez votre bon sens et incluez d'autres renseignements pertinents, si vous pensez que cela pourrait aider à résoudre le problème.

    Pour tirer le meilleur parti de votre rapport de bogue, nous avons besoin d'au moins les informations suivantes:

  • L'architecture du système hôte
  • Version de live-build sur le système hôte
  • Version de live-boot sur le système live
  • Version de live-config sur le système live
  • Version de live-tools sur le système live
  • Version de debootstrap et/ou cdebootstrap sur le système hôte
  • L'architecture du système live
  • Répartition du système live
  • Version du noyau sur le système live
  • 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).

    # lb build 2>&1 | tee build.log

    Au démarrage, live-boot stocke un journal dans /var/log/live-boot.log.

    Par ailleurs, pour écarter d'autres erreurs, c'est toujours une bonne idée faire un tar de votre répertoire config/ et de le télécharger quelque part (ne pas l'envoyer en pièce jointe à la liste de diffusion), de sorte que nous pouvons essayer de reproduire les erreurs que vous rencontrez. Si cela est difficile (en raison par exemple de la taille) vous pouvez utiliser la sortie de lb config --dump qui produit un résumé de votre arbre de config (c'est-à-dire les listes des fichiers dans les sous-répertoires de config/ mais ne les inclut pas).

    N'oubliez pas d'envoyer tous les journaux qui ont été produits avec le paramètre régionaux anglais, par exemple exécuter vos commandes live-build précédées par LC_ALL=C ou LC_ALL=en_US.

    13.5 Isoler le cas qui échoue, si possible

    Si possible, isoler le cas qui échoue au plus petit changement possible. Il n'est pas toujours facile de faire cela, donc si vous ne pouvez pas le gérer pour votre rapport, ne vous inquiétez pas. Toutefois, si vous planifiez votre cycle de développement bien, en utilisant petits ensembles de changements par itération, vous pourriez être capable d'isoler le problème en construisant une configuration simple «base» qui correspond étroitement à la configuration réelle avec seulement le changement cassé ajouté. Si il est difficile de trier vos modifications qui cassent, il est possible que vous y compris trop dans chaque ensemble de modifications et vous devriez developper en petits incréments.

    13.6 Utilisez le paquet adéquat pour rapporter le bogue

    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 bogue sur le pseudo-paquet debian-live.

    Toutefois, nous apprécierons si vous essayez de le réduire en fonction de l'endroit où le bogue apparaît.

    13.6.1 Au moment de la construction tandis l'amorçage

    live-build amorce d'abord un système Debian de base avec debootstrap ou cdebootstrap. Selon l'outil d'amorçage utilisé et de la distribution Debian il peut échouer. Si un bogue apparaît ici, vérifiez si l'erreur est liée à un paquet Debian spécifique (plus probable), ou si elle est liée à l'outil d'amorçage lui-même.

    Dans les deux cas, ce n'est pas un bogue dans Debian Live, mais plutôt dans Debian lui-même que probablement nous ne pouvons pas le résoudre directement. S'il vous plaît rapportez un bogue sur l'outil d'amorçage ou du paquet défaillant.

    13.6.2 Au moment de la construction tandis l'installation de paquets

    live-build installe des paquets supplémentaires de l'archive Debian et en fonction de la distribution Debian utilisée et l'état quotidienne de l'archive, il peut échouer. Si un bogue apparaît ici, vérifiez si l'erreur est également reproductible sur un système normal.

    Si c'est le cas, ce n'est pas un bogue dans Debian Live, mais plutôt dans Debian - s'il vous plaît faire le rapport sur le paquet défaillant. L'exécution de debootstrap séparément du système de construction ou l'exécution de lb bootstrap --debug vous donnera plus d'informations.

    Aussi, si vous utilisez un miroir local et/ou un proxy et vous rencontrez un problème, s'il vous plaît toujours le reproduire d'abord bootstrapping sur un miroir officiel.

    13.6.3 Au moment du démarrage

    Si votre image ne démarre pas, s'il vous plaît le signaler à la liste de diffusion avec les informations demandées dans Recueillir l'information. Ne pas oublier de mentionner, comment/quand l'image a échoué, soit dans Qemu, VirtualBox, VMWare ou matériel réel. Si vous utilisez une technologie de virtualisation d'aucune sorte, s'il vous plaît toujours tester sur matériel réel avant de rapporter un bogue. Fournir une copie d'écran de l'échec est également très utile.

    13.6.4 Au moment de l'exécution

    Si un paquet a été installé avec succès, mais il échoue tout en exécutant le système Live, c'est probablement un bogue dans Debian Live. Cependant:

    13.7 Faire les recherches

    Avant de présenter le bogue, s'il vous plaît recherchez sur le web le message d'erreur ou un symptôme particulier que vous obtenez. Comme il est hautement improbable que vous êtes la seule personne qui expérience un problème particulier, il y a toujours une chance qu'il a été discuté ailleurs, et une solution possible, un correctif, ou une solution de contournement a été proposée.

    Vous devez prêter une attention particulière à la liste de diffusion de Debian Live, ainsi que à la page d'accueil, car elles sont susceptibles de contenir des informations à jour. Si ces informations existent, toujours inclure les références au sein de vos rapport de bogues.

    En outre, vous devriez vérifier les listes de bogues en cours de live-build, live-boot, live-config et live-tools pour voir si quelque chose de semblable n'a été déjà signalée.

    13.8 Où rapporter les bogues

    Le projet Debian Live conserve la trace de tous les bogues dans le système Debian Bug Tracking System (BTS). Pour plus d'informations sur la façon d'utiliser le système, s'il vous plaît voir ‹http://bugs.debian.org/›. Vous pouvez également soumettre les bogues en utilisant la commande reportbug du paquet du même nom.

    En général, vous devez signaler les erreurs de construction contre le paquet live-build, les erreurs en temps de démarrage contre live-boot, et les erreurs d'exécution contre live-config. Si vous n'êtes pas sûr de quel paquet est approprié ou avez besoin d'aide avant de soumettre un rapport de bogue, s'il vous plaît signalez le rapport contre le pseudo-paquet debian-live. Nous le réattribuerons s'il y a lieu.

    S'il vous plaît notez que les bogues trouvés dans les distributions dérivées de Debian (comme Ubuntu et autres) ne doivent pas être rapportés au BTS de Debian, sauf qu'ils peuvent être également reproduits sur un système Debian en utilisant les paquets Debian officiels.