Changer le nom d'hôte de votre instance

Si vous souhaitez modifier le nom d'hôte d'une instance GitHub Enterprise Server existante, vous devez restaurer les paramètres et les données dans une nouvelle instance.

Dans cet article

À propos des modifications apportées au nom d'hôte pour GitHub Enterprise Server

Si vous devez utiliser un nouveau nom d'hôte pour votre instance GitHub Enterprise Server, vous devez sauvegarder les paramètres et les données de l'instance existante, configurer une nouvelle instance, restaurer la sauvegarde sur la nouvelle instance, puis ajuster votre configuration DNS pour envoyer le trafic à la nouvelle instance.

La migration vers une nouvelle instance nécessite un temps d'arrêt. Le temps d'arrêt nécessaire dépend de la quantité de données à sauvegarder, ainsi que de la vitesse de la connexion réseau entre l'hôte de sauvegarde et les instances.

Dans cet article, le terme « instance source » désigne l'instance avec l'ancien nom d'hôte, et le terme « instance de destination » désigne l'instance avec le nouveau nom d'hôte.

Avertissement : ne modifiez pas le nom d’hôte de GitHub Enterprise Server après la configuration initiale. La modification du nom d’hôte entraînera un comportement inattendu, pouvant aller jusqu’à des interruptions de l’instance et l’invalidation des clés de sécurité des utilisateurs. Si vous avez modifié le nom d’hôte de votre instance et rencontrez des problèmes, contactez Support GitHub Enterprise ou Support Premium GitHub.

Migration vers une instance avec un nouveau nom d'hôte

  1. Configurez une instance de destination de GitHub Enterprise Server avec le nouveau nom d'hôte que vous souhaitez utiliser. Pour plus d’informations, consultez la documentation suivante.

  2. Informez les utilisateurs de l'instance du temps d'arrêt planifié. Si vous le souhaitez, vous pouvez créer un message obligatoire qui s'affiche pour tous les utilisateurs qui se connectent. Pour plus d’informations, consultez « Personnalisation des messages utilisateur pour votre entreprise ».

  3. Sur l'instance source, activez le mode maintenance. Pour plus d’informations, consultez « Activation et planification du mode de maintenance ».

  4. Sauvegardez les données et les paramètres de l'instance source en utilisant GitHub Enterprise Server Backup Utilities. Pour plus d’informations, consultez « Configuration des sauvegardes sur votre instance ».

  5. Restaurez la sauvegarde sur l'instance de destination avec le nom d'hôte souhaité. Lorsque vous exécutez l'utilitaire ghe-restore, utilisez l'option -c pour remplacer la configuration de l'instance de destination. Pour plus d’informations, consultez « Configuration des sauvegardes sur votre instance ».

  6. Finalisez la configuration de l'instance de destination. Pour plus d’informations, consultez « Configuration de GitHub Enterprise ».

  7. Sur l'instance de destination, activez le mode maintenance.

  8. Si vous le souhaitez, lorsque l'instance de destination est en mode maintenance, validez la configuration de l'instance et vérifiez que les données utilisateur sont intactes. Pour plus d’informations, consultez « Activation et planification du mode de maintenance ».

  9. Pour diriger le trafic vers l'instance de destination, mettez à jour l'enregistrement DNS CNAME avec le nom d'hôte de l'instance source pour résoudre l'adresse IP de l'instance de destination.

    Remarque : le contenu restauré généré par l'utilisateur dans l'application web de l'instance contiendra probablement des URL qui font référence à l'ancien nom d'hôte de l'instance source. Si vous le souhaitez, pour vous assurer que ces liens continuent à être résolus vers l'instance de destination, vous pouvez configurer une redirection à l'aide du DNS. Outre l'enregistrement CNAME qui se résout au nom d'hôte de la nouvelle instance, configurez un deuxième enregistrement DNS CNAME qui dirige le trafic du nom d'hôte d'origine vers le nouveau nom d'hôte. Pour en savoir plus, reportez-vous à la documentation de votre fournisseur de DNS.

  10. Sur l'instance de destination, désactivez le mode maintenance.