Skip to main content
Skip to content

Troncation des journaux des transactions MSSQL

Lorsque GitHub Actions est activé, les journaux des transactions MSSQL augmentent jusqu’à ce qu’une sauvegarde les tronque. Si les sauvegardes ne s’exécutent pas assez souvent, les journaux peuvent remplir le disque de données sur votre instance GitHub Enterprise Server.

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

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

  2. Répertoriez le répertoire de données MSSQL.

    sudo ls -lth /data/user/mssql/data
    
  3. Comparez chaque .mdf fichier de données à son _log.ldf journal des transactions correspondant et identifiez les fichiers qui utilisent le plus d’espace.

    Un fichier volumineux _log.ldf n’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.mdf
    

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

  1. Effectuez une sauvegarde manuelle à l’aide de votre solution de sauvegarde configurée.

    ghe-backup
    

    Si aucune solution de sauvegarde n’est configurée, exportez plutôt les bases de données MSSQL.

    ghe-export-mssql --compress --stats 1
    
  2. 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
    
  3. 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
    
  4. Vérifiez que les fichiers sont plus petits.

    sudo du --all --human-readable /data/user/mssql/data
    
  5. Vérifiez que les conteneurs MSSQL sont sains.

    ghe-actions-check -s mssql
    
  6. 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
    
  7. 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.

  1. Effectuez une sauvegarde manuelle à l’aide de votre solution de sauvegarde configurée.

    ghe-backup
    

    Si aucune solution de sauvegarde n’est configurée, exportez plutôt les bases de données MSSQL.

    ghe-export-mssql --compress --stats 1
    
  2. Enregistrez les tailles de fichier actuelles.

    sudo du --all --human-readable /data/user/mssql/data
    
  3. 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
    
  4. Vérifiez que les fichiers sont plus petits.

    sudo du --all --human-readable /data/user/mssql/data
    
  5. Vérifiez que les conteneurs MSSQL sont sains.

    ghe-actions-check -s mssql
    
  6. Effectuez une nouvelle sauvegarde. Cela restaure le modèle de récupération COMPLET.

    ghe-export-mssql --compress --stats 1
    

    Avertissement

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

Pour en savoir plus