Signalement de bogues
Si une partie du projet etcd présente des bogues ou des erreurs de documentation, veuillez nous en informer en ouvrant une demande . Nous prenons très au sérieux les bogues et les erreurs, et considérons qu’aucun problème n’est trop petit. Avant de créer un rapport de bogue, veuillez vérifier qu’une demande signalant le même problème n’existe pas déjà.
Pour que le rapport de bogues soit précis et facile à comprendre, veuillez essayer de rédiger des rapports de bogues qui sont :
Spécifique. Inclure autant de détails que possible : version utilisée, environnement, configuration, etc. Si le bug est lié à l’exécution du serveur etcd, veuillez joindre le journal d’etcd (le journal de démarrage avec la configuration d’etcd est particulièrement important).
Reproductible. Incluez les étapes permettant de reproduire le problème. Nous comprenons que certains problèmes peuvent être difficiles à reproduire ; veuillez inclure les étapes qui pourraient mener au problème. Si possible, joignez le répertoire de données etcd affecté ainsi que la trace d’empilement (stack strace) au rapport de bogues.
Isolé. Essayez de reproduire le bug en minimisant les dépendances. Un nombre trop élevé de dépendances dans un rapport de bug ralentit considérablement la résolution. Le débogage des systèmes externes qui dépendent d’etcd est hors sujet, mais nous sommes heureux de fournir des indications dans la bonne direction ou d’aider à utiliser etcd lui-même.
Unique. Ne pas dupliquer le rapport de bogues existant.
Étendu. Un seul bogue par rapport. Ne pas faire de suivi avec un autre bogue dans un même rapport.
Il peut être utile de lire l’article d’Elika Etemad sur la rédaction de bons rapports de bogues avant de créer un rapport.
Nous pouvons demander des informations supplémentaires pour localiser un bogue. Un rapport de bogue en double sera fermé.
Questions fréquemment posées
Comment obtenir une trace de pile
Comment obtenir la version d’etcd
Comment obtenir la configuration et les journaux d’état d’etcd lorsqu’il s’exécute en tant que service systemd « etcd2.service »
En raison d’un bogue upstream dans systemd, journald peut manquer les dernières lignes de journal lorsque ses processus se terminent. Si journalctl indique que etcd s’est arrêté sans message d’erreur ou d’incident critique, essayez sudo journalctl -f -t etcd2 afin d’obtenir la totalité du journal.