Symptoms
MSSQL s’exécute sur votre instance GitHub Enterprise Server uniquement lorsque GitHub Actions est activé. Lorsque ses journaux de transactions deviennent trop volumineux, vous pouvez voir l’un des éléments suivants.
- L’utilisation des disques de données augmente régulièrement et ne diminue pas.
- Des erreurs MSSQL indiquent que le journal des transactions d’une base de données est complet.
- Les runners auto-hébergés ne parviennent pas à s’inscrire. Un seul journal de transactions ne peut pas dépasser 2 To, et une fois qu’il atteint cette limite, les écritures dans cette base de données échouent.
- La réplication MSSQL échoue ou prend beaucoup plus de temps que prévu.
Les Causes
Chaque base de données MSSQL a un fichier de données se terminant par .mdf et un journal des transactions se terminant par _log.ldf. Chaque modification est d’abord écrite dans le journal des transactions.
Dans une configuration à haute disponibilité, les bases de données s’exécutent dans le modèle de récupération COMPLÈTE, ce qu’exige la réplication. Dans ce modèle, l’espace du journal est uniquement réutilisable lorsqu’une sauvegarde est exécutée. Si les sauvegardes ne s’exécutent pas assez souvent ou échouent, le journal continue d’étendre le fichier pour contenir de nouveaux enregistrements. Sa taille augmentera jusqu’à ce qu’il remplisse le disque de données, ou jusqu’à ce qu’il atteigne la limite de 2 To par fichier, selon ce qui se produit en premier.
Confirmer le problème
-
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 le répertoire de données MSSQL.
sudo ls -lth /data/user/mssql/data -
Comparez chaque
.mdffichier de données à son_log.ldfjournal des transactions correspondant et identifiez les fichiers qui utilisent le plus d’espace.Un fichier volumineux
_log.ldfn’est pas une preuve en soi que la troncation échoue. La troncature rend l’espace à l’intérieur du fichier réutilisable, elle ne réduit pas le fichier, de sorte qu’un journal qui a été tronqué avec succès peut toujours être volumineux. Ce que la liste vous indique, ce sont les fichiers qui consomment le disque.-rw-r----- 1 mssql mssql 156G Apr 17 02:52 Mps_cf856db1-88f0-412a-b35d-8df36a8350ac_log.ldf -rw-r----- 1 mssql mssql 72M Apr 17 02:52 Mps_cf856db1-88f0-412a-b35d-8df36a8350ac.mdf -rw-r----- 1 mssql mssql 836M Apr 17 02:52 Pipelines_45f96584-c933-460c-8706-5d8928261202_log.ldf -rw-r----- 1 mssql mssql 72M Apr 17 02:52 Pipelines_45f96584-c933-460c-8706-5d8928261202.mdf -rw-r----- 1 mssql mssql 3.4G Apr 17 02:58 Mps_Configuration_log.ldf -rw-r----- 1 mssql mssql 136M Apr 17 02:58 Mps_Configuration.mdfChaque fichier journal ici fait plus de cinq fois la taille de son fichier de données, ce qui dépasse largement la croissance normale. Dans cet exemple, le premier fichier journal est de 156 Go par rapport à un fichier de données de 72 Mo. Il s’agit donc de celui qui remplit le disque.
Résolution du problème
Les procédures ci-dessous basculent temporairement les bases de données vers le modèle de récupération SIMPLE, ce qui permet aux journaux des transactions d’être tronqués, puis restaurent le modèle de récupération COMPLET.
Suivez la procédure correspondant à votre environnement. Les deux diffèrent, car la réplication s’appuie sur le modèle de récupération COMPLÈTE. Par conséquent, dans une configuration de haute disponibilité, la réplication doit être désactivée avant que les journaux puissent être tronqués.
Environnements à haute disponibilité
Utilisez cette procédure si votre instance GitHub Enterprise Server possède un ou plusieurs réplicas. Exécutez chaque commande sur le serveur principal.
Avertissement
Cette procédure supprime le groupe de disponibilité et supprime les fichiers de base de données MSSQL sur chaque réplica, qui sont ensuite recréés par initialisation. L’amorçage d’une base de données volumineuse prend du temps et vos répliques ne vous protègent pas tant que l’amorçage n’est pas terminé.
-
Effectuez une sauvegarde manuelle à l’aide de votre solution de sauvegarde configurée.
ghe-backupSi aucune solution de sauvegarde n’est configurée, exportez plutôt les bases de données MSSQL.
ghe-export-mssql --compress --stats 1 -
Enregistrez les tailles de fichier actuelles, de sorte que vous puissiez confirmer la réduction par la suite.
sudo du --all --human-readable /data/user/mssql/data -
Purger les journaux de transactions. Cela désactive la réplication MSSQL sur chaque réplica, supprime le groupe de disponibilité, bascule les bases de données vers le mode de récupération SIMPLE et réduit les journaux.
sudo /usr/local/share/enterprise/ghe-mssql-shrinkfile --disable-mssql-replication --set-simple-recovery-model -
Vérifiez que les fichiers sont plus petits.
sudo du --all --human-readable /data/user/mssql/data -
Vérifiez que les conteneurs MSSQL sont sains.
ghe-actions-check -s mssql -
Réactivez la réplication MSSQL. Cela recrée le groupe de disponibilité et restaure le modèle de récupération complet.
ghe-cluster-each --serial --exclude --role mssql -- /usr/local/share/enterprise/ghe-repl-start-mssql -
Surveillez l’amorçage jusqu’à ce que les réplicas soient synchronisés. Tant que l’amorçage n’est pas terminé, les réplicas ne contiennent pas de données MSSQL.
Contrairement aux étapes ci-dessus, exécutez-le sur chaque réplica plutôt que sur le réplica principal.
ghe-repl-status
Environnements autonomes
Utilisez cette procédure si votre instance GitHub Enterprise Server n’a aucun réplica.
-
Effectuez une sauvegarde manuelle à l’aide de votre solution de sauvegarde configurée.
ghe-backupSi aucune solution de sauvegarde n’est configurée, exportez plutôt les bases de données MSSQL.
ghe-export-mssql --compress --stats 1 -
Enregistrez les tailles de fichier actuelles.
sudo du --all --human-readable /data/user/mssql/data -
Tronquer les journaux des transactions. Cela bascule les bases de données vers le modèle de récupération SIMPLE et réduit les fichiers journaux.
sudo /usr/local/share/enterprise/ghe-mssql-shrinkfile --set-simple-recovery-model -
Vérifiez que les fichiers sont plus petits.
sudo du --all --human-readable /data/user/mssql/data -
Vérifiez que les conteneurs MSSQL sont sains.
ghe-actions-check -s mssql -
Effectuez une nouvelle sauvegarde. Cela restaure le modèle de récupération COMPLET.
ghe-export-mssql --compress --stats 1Avertissement
Sur une instance autonome, le modèle de récupération COMPLET n’est pas restauré automatiquement. Vous devez effectuer cette sauvegarde. Si les bases de données restent dans le modèle de récupération SIMPLE, les journaux des transactions sont tronqués à chaque point de contrôle et la réplication échoue si vous ajoutez un réplica ultérieurement.
Prévenir les récurrences
Les journaux des transactions sont effacés par les sauvegardes. Les journaux restent donc d’une taille raisonnable uniquement lorsque les sauvegardes s’exécutent de manière fiable.
- Exécutez des sauvegardes selon une planification et vérifiez qu’elles se terminent. Pour plus d’informations, consultez « Configuration du service de sauvegarde ».
- Surveillez l’utilisation du disque de données afin de voir les journaux croître avant que le disque ne soit plein. Pour plus d’informations, consultez « Seuils d’alerte recommandés ».
- Après une période où les sauvegardes ont échoué, vérifiez à nouveau les tailles de fichier, car les journaux d’activité ont augmenté entre-temps.
Contacter Support GitHub
Si ces étapes ne résolvent pas le problème, ou si vous avez des doutes sur l’une de ces étapes, 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 ».