Symptoms
L’horloge est rarement mentionnée dans ce que vous voyez réellement. Les problèmes touchent plutôt ce qui dépend de deux systèmes qui s’accordent sur l’heure.
- Les utilisateurs ne peuvent pas se connecter, ou les sessions se terminent plus tôt que prévu.
- GitHub Connect ne parvient pas à se connecter, ou la page de licence retourne une erreur de serveur.
- GitHub Actions les travaux ne parviennent pas à démarrer, ou les jetons sont rejetés comme non valides.
/var/log/github/exceptions.logcontient des erreurs relatives à un claim d’expiration du jeton trop éloignée dans le futur, comme'Expiration time' claim ('exp') is too far in the future.- Les horodatages dans l’interface web, dans les journaux ou dans les commits ne correspondent pas à l’heure attendue.
Un jeton signé par une instance dont l’horloge est déréglée semble invalide pour le système qui le reçoit, même si rien n’est incorrect avec le jeton lui-même. C’est pourquoi ces échecs pointent vers l’authentification plutôt qu’à l’heure.
Les Causes
GitHub Enterprise Server maintient l’exactitude de son horloge en se synchronisant avec les serveurs NTP (Network Time Protocol) sur le port UDP 123. Il doit atteindre au moins l’un d’entre eux, en continu.
Un serveur configuré cesse d’être accessible pour des raisons courantes.
- Un pare-feu ou un groupe de sécurité bloque le port UDP sortant 123, ce qui peut facilement passer inaperçu, car le reste de l’instance fonctionne.
- Un serveur de temps interne est mis hors service ou renommé, et l’instance est toujours pointée à l’ancienne adresse.
- Le nom d’hôte ne se résout plus.
- Un seul serveur est configuré. Il n’y a donc aucune solution de secours quand il disparaît.
Quand aucun serveur configuré n’est accessible, chrony continue d’exécuter l’horloge système locale sans correction externe, signalant le stratum de secours de 10 que GitHub Enterprise Server configure. Il ne s’agit pas de l’horloge matérielle, qui est un appareil distinct géré en dehors de chrony.
Rien n’échoue à ce moment-là, et aucune erreur n’est générée. L’horloge cesse d’être corrigée et dérive, lentement au début, jusqu’à ce que quelque chose qui dépend d’un temps précis tombe en panne. Plus la dérive est grande, plus les défaillances sont étendues.
Un hyperviseur qui tente également de définir l’horloge de la machine virtuelle peut produire le même résultat, en entrant en conflit avec la propre synchronisation de l’instance.
Confirmation du problème en cours
-
Connectez-vous en SSH à l’interpréteur de commandes d’administration. Pour plus d’informations, consultez « Accès à l’interpréteur de commandes d’administration (SSH) ».
-
Répertoriez les sources de temps et leur état.
sudo chronyc sources -vLisez la
MScolonne à gauche de chaque élément source.?signifie que chrony n’utilise pas cette source. En soi, ce n’est pas la preuve d’un problème réseau, car le même marqueur apparaît pour un serveur qui est lui-même non synchronisé et pour une source qui n’a pas encore fourni suffisamment de mesures.Ce qui identifie une source inaccessible est la preuve à l’appui sur la même ligne. Dans la sortie ci-dessous,
0estReach, ce qui signifie qu’aucun des sondages récents n’a reçu de réponse, etLastRxest-, ce qui signifie qu’aucun échantillon n’est encore jamais arrivé. Aucun serveur n’a jamais répondu.MS Name/IP address Stratum Poll Reach LastRx Last sample =============================================================================== ^? ntp1.example.com 0 10 0 - +0ns[ +0ns] +/- 0ns ^? ntp2.example.com 0 10 0 - +0ns[ +0ns] +/- 0nsSi une source est marquée
*, chrony l’a sélectionnée, ce qui exclut le problème de joignabilité. Il ne confirme pas que l’horloge est exacte, car chrony corrige progressivement un décalage important et l’instance peut être très éloignée de l’heure réelle pendant qu’elle le fait. Continuez avec les vérifications restantes dans tous les cas. -
Vérifiez à quoi l’instance est réellement synchronisée.
sudo chronyc trackingUn ID de référence avec un nom vide entre crochets, ainsi qu’une strate de
10, signifie que l’instance a renoncé à ses serveurs configurés et utilise sa propre horloge.Reference ID : 7F7F0101 () Stratum : 10 System time : 0.000000000 seconds fast of NTP timeStratum compte le nombre de niveaux qui séparent l’instance d’une horloge de référence, et une instance indique toujours une valeur supérieure de un à celle du serveur qu’elle suit. La valeur de
10est spécifique : il s’agit de la configuration de secours que GitHub Enterprise Server définit lorsqu’aucune source n’est disponible, le fait de la voir accompagnée d’un ID de référence sans nom est donc le signal.Une instance saine nomme à la place le serveur qu’il suit et signale un stratum supérieur de un à celui de ce serveur.
Reference ID : D9723B03 (ntp1.example.com) Stratum : 3 System time : 0.000079420 seconds fast of NTP time
System time est mesuré par rapport aux serveurs que l’instance suit. Par conséquent, lorsqu’elle suit sa propre horloge, la valeur est sans signification. Il indique une valeur proche de zéro, quelle que soit la distance à laquelle l’horloge a dérivé.
-
Mesurez la dérive par vous-même en comparant l’horloge de l’instance à une source en laquelle vous avez confiance.
date -uNotez à quel point il est erroné. Une grande différence confirme que l’horloge a dérivé.
-
Si vous souhaitez obtenir les détails complémentaires sur chaque source, par exemple dans quelle mesure elle est asymétrique et combien d’échantillons ont été conservés, utilisez la commande suivante.
sudo chronyc sourcestats -v
Résolution du problème
Restaurez d’abord la synchronisation, puis corrigez la dérive qui s’est générée pendant qu’elle était perdue. Corriger la dérive sans corriger l’atteignabilité ne fait que retarder son retour.
-
Vérifiez sur quels serveurs l’instance est configurée, dans la section « Heure » de la Management Console. Pour plus d’informations, consultez « Configuration de la synchronisation de l’heure ».
-
Vérifiez que l’instance peut les atteindre. Le port UDP sortant 123 doit être ouvert vers chaque serveur, dans chaque pare-feu et groupe de sécurité entre l’instance et le serveur. Pour plus d’informations, consultez « Ports réseau ».
-
Si un serveur est parti ou si vous ne pouvez pas ouvrir le chemin d’accès à celui-ci, configurez les serveurs auxquels l’instance peut accéder. Configurez-en au moins deux, afin que si l’un devient indisponible, l’instance ne se retrouve pas sans rien.
-
Vérifiez que chrony a à nouveau sélectionné une source. L’un d’eux doit maintenant être marqué
*, avec une valeurReachnon nulle.sudo chronyc sources -v -
Corrigez la dérive qui s’est générée pendant que l’instance n’a pas été synchronisée. NTP corrige les petites différences par elle-même, mais une grande différence nécessite la commande suivante. Pour plus d’informations, consultez « Configuration de la synchronisation de l’heure ».
sudo chronyc -a makestep -
Vérifiez que l’horloge est maintenant d’accord avec une source en laquelle vous avez confiance. Il s’agit de la vérification qui vous indique que la dérive a réellement disparu, plutôt qu’elle est encore en cours de correction.
date -u -
Réessayez tout ce qui a échoué.
Prévenir la réapparition
- Configurez au moins deux serveurs de temps, de sorte que la perte d’un serveur n’arrête pas la synchronisation.
- Après avoir modifié les serveurs, vérifiez que l’instance peut réellement les atteindre. Un serveur configuré n’est pas nécessairement un serveur opérationnel, et rien ne vous avertit quand il cesse de répondre.
- Conservez le port UDP sortant 123 ouvert vers vos serveurs NTP lorsque les règles de pare-feu changent.
- Empêchez votre hyperviseur de définir l’horloge de la machine virtuelle, afin que ce réglage n’entre pas en conflit avec la propre synchronisation de l’instance. Pour plus d’informations, consultez la documentation fournie par votre fournisseur de virtualisation.
- Vérifiez la source horaire dans le cadre de vos contrôles de bon fonctionnement de routine. La dérive est inoffensive jusqu’à ce qu’elle ne le soit plus, et l’attraper tant qu’elle est faible vous évite d’avoir à déterminer laquelle de plusieurs défaillances non liées provenait de l’horloge.
Contacter Support GitHub
Si l’instance ne peut toujours pas atteindre un serveur de temps après avoir vérifié la configuration et le chemin d’accès réseau, ou si les symptômes d’origine continuent une fois que l’horloge est à l’heure, contactez Support GitHub plutôt que de continuer. Pour plus d’informations, consultez « Création d’un ticket de support ».
Si vous avez déjà ouvert un ticket, joindre un bundle de support aide Support GitHub à diagnostiquer le problème plus rapidement. Pour plus d’informations, consultez « Fourniture de données au support GitHub ».