Les systèmes live sont loin d'être parfaits, mais nous voulons les rendre aussi parfaits que possible − 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 de bons rapports de bogues.
Pour les impatients:
● Commencez toujours par vérifier les mises à jour du statut de l'image sur notre page d'accueil http://live-systems.org/ pour voir les problèmes connus.
● Avant de présenter un rapport de bogue, toujours essayer de reproduire le bogue avec les versions les plus récentes de la branche de live-build, live-boot, live-config et live-tools que vous utilisez (comme la dernière version 4.x de live-build si vous utilisez live-build 4).
● 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.
Puisque les distributions Debian testing et Debian unstable sont des cibles mouvantes, quand vous les indiquez comme distributions du système cible, une construction avec succès n'est pas toujours possible.
Si cela vous pose trop de difficulté, ne construisez pas un système basé sur testing ou unstable, mais utilisez plutôt stable. live-build utilise toujours la version stable par défaut.
Les problèmes connus sont énumérés dans la section «statut» sur notre page http://live-systems.org/.
Le sujet de ce manuel n'est pas de vous former à identifier et corriger correctement 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, revenez à testing et fixez la nouvelle version du paquet qui échoue de unstable (voir APT pinning pour plus de détails).
Afin de vous assurer qu'un bogue en particulier n'est pas causé par un système mal construit, veuillez toujours reconstruire l'ensemble du système live à partir de zéro pour voir si le bogue est reproductible.
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.
Veuillez fournir assez d'informations avec votre rapport. Incluez au moins la version exacte de live-build où le bogue est rencontré et les mesures pour le reproduire. Veuillez utiliser 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 au moins besoin des informations suivantes:
● L'architecture du système hôte
● Distribution du système hôte
● Version de live-build sur le système hôte
● Version de debootstrap sur le système hôte
● L'architecture du système live
● Répartition du système live
● 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
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 et live-config stockent un journal dans /var/log/live/boot.log. Vérifiez-les pour des messages d'erreur.
Par ailleurs, pour écarter d'autres erreurs, c'est toujours une bonne idée de 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 puissions 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 produits avec les paramètres régionaux anglais. Par exemple, exécutez vos commandes live-build précédées par LC_ALL=C ou LC_ALL=en_US.
Si possible, isolez 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 bienvotre cycle de développement, en utilisant de 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é. S'il est difficile de trier vos modifications qui cassent, il est possible que vous incluiez trop dans chaque ensemble de modifications et vous devriez développer en petits incréments.
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.
live-build amorce d'abord un système Debian de base avec debootstrap. 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 le système live, mais plutôt dans Debian lui-même que probablement nous ne pouvons pas le résoudre directement. Veuillez signaler un bogue sur l'outil d'amorçage ou du paquet défaillant.
live-build installe des paquets supplémentaires de l'archive Debian et en fonction de la distribution Debian utilisée et l'état quotidien 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 le système live, mais plutôt dans Debian − veuillez envoyer 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, veuillez toujours le reproduire en amorçant d'abord sur un miroir officiel.
Si votre image ne démarre pas, veuillez le signaler à la liste de diffusion avec les informations demandées dans Recueillir l'information. N'oubliez pas de mentionner, comment/quand l'image a échoué, soit en virtualisation ou sur du matériel réel. Si vous utilisez une technologie de virtualisation de quelconque sorte, veuillez toujours tester sur du matériel réel avant de signaler un bogue. Fournir une copie d'écran de l'échec est également très utile.
Si un paquet a été installé avec succès, mais qu'il échoue lors de l'exécution du système Live, il s'agit probablement d'un bogue dans le système live. Cependant:
Avant de présenter le bogue, veuillez rechercher sur le web le message d'erreur ou un symptôme particulier que vous obtenez. Comme il est hautement improbable que vous soyez la seule personne faisant l'expérience d'un problème particulier, il y a toujours une chance qu'il ait été discuté ailleurs, et qu'une solution possible, un correctif, ou une solution de contournement ait été proposés.
Vous devez prêter une attention particulière à la liste de diffusion du système live, ainsi qu'à la page d'accueil, car elles sont susceptibles de contenir des informations à jour. Si ces informations existent, incluez toujours les références au sein de vos rapports 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 pas déjà été signalée.
Le ${project} conserve la trace de tous les bogues dans le système de suivi des bogues (BTS). Pour plus d'informations sur la façon d'utiliser le système, veuillez consulter https://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 lors du démarrage contre live-boot, et les erreurs d'exécution contre live-config. Si vous n'êtes pas sûr du paquet approprié ou si vous avez besoin d'aide avant de soumettre un rapport de bogue, veuillez signaler le bogue contre le pseudo-paquet debian-live. Nous le réattribuerons s'il y a lieu.
Veuillez noter 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 s'ils peuvent être également reproduits sur un système Debian en utilisant les paquets Debian officiels.
License: Ce programme est un logiciel libre; vous pouvez le redistribuer ou le modifier suivant les termes de la Licence Générale Publique GNU telle que publiée par la Free Software Foundation: soit la version 3 de cette licence, soit (à votre gré) toute version ultérieure.
Ce programme est distribué dans l’espoir qu’il vous sera utile, mais SANS AUCUNE GARANTIE: sans même la garantie implicite de COMMERCIALISABILITÉ ni d’ADÉQUATION À UN OBJECTIF PARTICULIER. Consultez la Licence Générale Publique GNU pour plus de détails.
Vous devriez avoir reçu une copie de la Licence Générale Publique GNU avec ce programme ; si ce n’est pas le cas, consultez http://www.gnu.org/licenses/.
Le texte complet de la Licence Générale Publique GNU peut être trouvé dans le fichier / usr/share/common-licenses/GPL-3
≅ SiSU Spine ፨ (object numbering & object search)
(web 1993, object numbering 1997, object search 2002 ...) 2024