Live manual Debian Live

# Debian Live Manual

# Signaler des bogues

694

# 14. Signaler des bogues

695

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.

696

Pour les impatients:

697

- First check whether the bugs has been reported already. You can see the full list of bugs that are assigned to the live-team at ‹https://bugs.debian.org/cgi-bin/pkgreport.cgi?maint=debian-live%40lists.debian.org›.

698

- Before submitting a bug report always try to reproduce the bug with the most recent versions of the packages of live-build, live-boot, live-config and live-tools that you're using.

699

- 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.

700

14.1 Problèmes connus

701

Currently known issues are listed in the BTS at ‹https://bugs.debian.org/cgi-bin/pkgreport.cgi?maint=debian-live%40lists.debian.org›.

702

Note: Since Debian testing and Debian unstable distributions are moving targets, when you specify either of them as the target system distribution, a successful build may not always be possible.

703

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.

704

It is out of the scope of this manual to train you to correctly identify and fix problems in packages of the development distributions, however, you can always try the following: If a build fails when the target distribution is testing, try unstable. If unstable does work, revert to testing and pin the newer version of the failing package from unstable (see APT pinning for details).

705

14.2 Effectuer une recherche

706

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.

707

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.

708

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.

709

14.3 Reconstruire à partir de zéro

710

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.

711

14.4 Utiliser des paquets mis à jour

712

Using outdated packages can cause significant problems when trying to reproduce (and ultimately fix) your problem. Make sure your build system is up-to-date and any packages included in your image are up-to-date as well. If possible, try to reproduce the bug with the newest code from source, see Installation for details.

713

14.5 Recueillir l'information

714

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.

715

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

716

- L'architecture du système hôte

717

- Distribution du système hôte

718

- Version de live-build sur le système hôte

719

- Version de debootstrap sur le système hôte

720

- L'architecture du système live

721

- Répartition du système live

722

- Version de live-boot sur le système live

723

- Version de live-config sur le système live

724

- Version de live-tools sur le système live

725

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).

726

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

727

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.

728

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).

729

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`.

730

14.6 Isoler le cas qui échoue, si possible

731

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.

732

14.7 Utiliser le paquet adéquat pour rapporter un bogue

733

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.

734

Toutefois, nous apprécierions que vous essayiez de le réduire en fonction de l'endroit où le bogue apparaît.

735

14.7.1 Pendant la construction durant l'amorçage

736

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.

737

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.

738

14.7.2 Pendant la construction durant l'installation de paquets

739

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.

740

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.

741

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.

742

14.7.3 Pendant le démarrage

743

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.

744

14.7.4 Pendant l'exécution

745

If a package was successfully installed, but fails while actually running the Live system, this is probably a bug in live-config.

746

14.8 Où rapporter les bogues

747

Le Debian Live 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.

748

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.