Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2024-07-09. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Problèmes connus liés aux sauvegardes pour votre instance

Consultez une vue d’ensemble des solutions de contournement pour les problèmes qui impactent le processus de sauvegarde ou de restauration pour GitHub Enterprise Server.

Dans cet article

À propos des problèmes connus avec les sauvegardes de GitHub Enterprise Server

GitHub fournit des solutions de contournement pour les problèmes suivants qui peuvent impacter la sauvegarde ou la restauration des données pour une instance GitHub Enterprise Server. Pour plus d’informations, consultez « Problèmes connus » dans les Notes de publication de GitHub Enterprise Server.

Les utilisateurs ne peuvent pas se connecter après la restauration d’une sauvegarde

Remarque : ce problème connu a été corrigé dans GitHub Enterprise Server Backup Utilities 3.9.1.

Si vous avez utilisé GitHub Enterprise Server Backup Utilities 3.7.0, 3.8.0, ou 3.9.0 pour sauvegarder une instance exécutant n'importe quelle version de la GitHub Enterprise Server 3.7 ou 3.8, après avoir restauré la sauvegarde dans une nouvelle instance, les utilisateurs ne peuvent pas se connecter. Même si les utilisateurs ne peuvent pas se connecter, la sauvegarde elle-même n’est pas affectée et toutes les données sont intactes.

Après avoir restauré une sauvegarde existante affectée par ce problème, vous pouvez le résoudre en modifiant la configuration sur la nouvelle instance.

Restauration à partir d’une sauvegarde existante

Si vous avez restauré une sauvegarde existante à partir de GitHub Enterprise Server Backup Utilities 3.7.0, 3.8.0, ou 3.9.0 vers une nouvelle instance et que les utilisateurs ne peuvent pas se connecter, vous devez générer des données de configuration à partir de l'instance GitHub Enterprise Server source et ajuster la configuration sur l'instance cible.

Pour vous assurer que les utilisateurs peuvent se connecter à la nouvelle instance cible, assurez-vous que votre environnement répond aux exigences suivantes.

  1. Connectez-vous en mode SSH à l’instance GitHub Enterprise Server source que vous avez sauvegardée. Si votre instance comprend plusieurs nœuds, par exemple si la haute disponibilité ou la géoréplication sont configurées, connectez-vous via SSH au nœud principal. Si vous utilisez un cluster, vous pouvez vous connecter via SSH à n’importe quel nœud. Remplacez HOSTNAME par le nom d’hôte réel de votre instance. Pour plus d’informations sur l’accès SSH, consultez « Accès à l’interpréteur de commandes d’administration (SSH) ».

    Shell
    ssh -p 122 admin@HOSTNAME

  2. Pour afficher la liste des clés de déchiffrement, exécutez la commande suivante.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material

  3. Copiez la sortie vers un emplacement sécurisé et temporaire.

  4. Pour afficher la liste des clés de chiffrement, exécutez la commande suivante.

    Shell
    ghe-config secrets.github.encrypted-column-current-encryption-key

  5. Copiez la sortie vers un emplacement sécurisé et temporaire.

  6. Connectez-vous en mode SSH à l’instance GitHub Enterprise Server de destination où vous avez restauré la sauvegarde. Remplacez HOSTNAME par le nom d’hôte réel de votre instance.

    Shell
    ssh -p 122 admin@HOSTNAME

  7. Activez le mode maintenance. Pour plus d’informations, consultez « Activation et planification du mode de maintenance ».

  8. Pour vérifier que l'instance de destination est prête pour la configuration, exécutez les commandes suivantes. Aucune sortie ne doit être affichée.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
ghe-config secrets.github.encrypted-column-current-encryption-key

  9. Pour mettre à jour les clés de déchiffrement sur l’instance de destination, exécutez la commande suivante. Remplacez DECRYPTION-KEY-LIST par la sortie de l’étape 1.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material "DECRYPTION-KEY-LIST"

  10. Pour mettre à jour la clé de chiffrement sur l’instance de destination, exécutez la commande suivante. Remplacez ENCRYPTION-KEY par la sortie de l’étape 4.

    Shell
    ghe-config secrets.github.encrypted-column-current-encryption-key "ENCRYPTION-KEY"

  11. Pour appliquer la configuration, exécutez la commande suivante.

    Shell
    ghe-config-apply

  12. Attendez la fin de l’exécution de la configuration.

  13. Pour vous assurer que la configuration de l'instance cible contient les clés, exécutez les commandes suivantes et vérifiez que la sortie correspond à l'étape 1 et à l'étape 4.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
ghe-config secrets.github.encrypted-column-current-encryption-key

  14. Faites en sorte qu’un utilisateur se connecte à l’instance de destination. En cas de problème, contactez le Support GitHub Enterprise. Pour plus d’informations, consultez « Contacter le support GitHub ».