diff options
Diffstat (limited to 'markup/pod/live-manual/media/text/fr/project_bugs.ssi')
-rw-r--r-- | markup/pod/live-manual/media/text/fr/project_bugs.ssi | 223 |
1 files changed, 223 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/fr/project_bugs.ssi b/markup/pod/live-manual/media/text/fr/project_bugs.ssi new file mode 100644 index 0000000..4f785ca --- /dev/null +++ b/markup/pod/live-manual/media/text/fr/project_bugs.ssi @@ -0,0 +1,223 @@ +:B~ Signaler des bogues + +1~bugs Signaler des bogues + +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. + +2~ Problèmes connus + +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. + +% FIXME: + +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}#apt-pinning pour plus de +détails). + +2~ Reconstruire à partir de zéro + +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. + +2~ Utiliser des 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. + +2~collect-information Recueillir l'information + +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}#managing-a-configuration pour les détails). + +code{ + + # lb build 2>&1 | tee build.log + +}code + +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}#. + +2~ Isoler le cas qui échoue, si possible + +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. + +2~ Utiliser le paquet adéquat pour rapporter un 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 +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. + +3~ Pendant la construction durant l'amorçage + +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. + +3~ Pendant la construction durant 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 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. + +3~ Pendant le démarrage + +Si votre image ne démarre pas, veuillez le signaler à la liste de diffusion +avec les informations demandées dans {Recueillir +l'information}#collect-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. + +3~ Pendant l'exécution + +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: + +2~ Effectuer une recherche + +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. + +2~ Où rapporter les bogues + +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. |