Informationen zu Änderungen am Hostnamen für GitHub Enterprise Server
Wenn du einen neuen Hostnamen für Ihre GitHub Enterprise Server-Instance verwenden musst, musst du die Einstellungen und Daten der vorhandenen Instanz sichern, eine neue Instanz konfigurieren, die Sicherung auf die neue Instanz wiederherstellen und dann deine DNS-Konfiguration so anpassen, dass Datenverkehr an die neue Instanz gesendet wird.
Die Migration zu einer neuen Instanz erfordert Ausfallzeiten. Die erforderliche Ausfallzeit hängt davon ab, wie viel Daten du sichern musst, und von der Geschwindigkeit der Netzwerkverbindung zwischen dem Sicherungshost und den Instanzen.
In diesem Artikel bezieht sich der Begriff „Quellinstanz“ auf die Instanz mit dem alten Hostnamen, und „Zielinstanz“ bezieht sich auf die Instanz mit dem neuen Hostnamen.
Warning
Ändere den Hostnamen für GitHub Enterprise Server nach der Ersteinrichtung nicht mehr. Das Ändern des Hostnamens wird zu unerwartetem Verhalten führen, bis hin zu Instanzausfällen und der Ungültigkeit der Sicherheitsschlüssel der Benutzer. Wenn Sie den Hostnamen für Ihre Instanz geändert haben und Probleme auftreten, wenden Sie sich an GitHub Enterprise Support oder GitHub Premium-Support.
Migrieren zu einer Instanz mit einem neuen Hostnamen
-
Konfiguriere eine Zielinstanz von GitHub Enterprise Server mit dem neuen Hostnamen, den du verwenden möchtest. Weitere Informationen findest du in der folgenden Dokumentation.
-
Informiere die Benutzer der Instanz über die geplante Ausfallzeit. Optional kannst du eine obligatorische Nachricht erstellen, die für alle Benutzer angezeigt wird, die sich anmelden. Weitere Informationen findest du unter Anpassen von Benutzernachrichten für dein Unternehmen.
-
Aktiviere in der Quellinstanz den Wartungsmodus, um zu verhindern, dass Deltas auftreten. Weitere Informationen finden Sie unter Wartungsmodus aktivieren und planen.
-
Sichere die Daten und Einstellungen der Quellinstanz mithilfe von GitHub Enterprise Server Backup Utilities. Weitere Informationen finden Sie unter Konfigurieren von Sicherungen auf einer Instanz. (Dieser Schritt kann bis zu mehreren Stunden dauern.)
-
Wenn deine Quellinstanz für Ihre GitHub Enterprise Server-Instance aktiviert ist, musst du den externen Speicheranbieter für GitHub Actions auf der Zielinstanz konfigurieren. Weitere Informationen findest du unter Sichern und Wiederherstellen von GitHub Enterprise Server mit aktivierten GitHub Actions.
-
Aktiviere auf der Zielinstanz den Wartungsmodus, um die Wiederherstellung der Sicherung aus der Quellinstanz zu ermöglichen.
-
Stelle die Sicherung auf der Zielinstanz mit dem gewünschten Hostnamen wieder her. Führe das Hilfsprogramm
ghe-restore
ohne die Option-c
aus, um zu verhindern, dass die Konfiguration der Zielinstanz überschrieben wird. Weitere Informationen findest du unter Konfigurieren von Sicherungen auf einer Instanz. -
Schließe die Konfiguration der Zielinstanz ab. Weitere Informationen finden Sie unter Konfigurieren von GitHub Enterprise.
-
Während sich die Zielinstanz im Wartungsmodus befindet, überprüfe die Konfiguration der Instanz und das Konfigurationsausführungsprotokoll (
/data/user/common/ghe-config.log
), und stelle sicher, dass die Benutzerdaten intakt sind. Weitere Informationen finden Sie unter Wartungsmodus aktivieren und planen. -
Um den Datenverkehr an die Zielinstanz zu leiten, aktualisiere den DNS
CNAME
-Datensatz mit dem Hostnamen der Quellinstanz, um die IP-Adresse der Zielinstanz aufzulösen.Note
Wiederhergestellte, von Benutzern generierte Inhalte in der Webanwendung der Instanz enthalten wahrscheinlich URLs, die auf den alten Hostnamen der Quellinstanz verweisen. Wenn du optional sicherstellen möchtest, dass diese Links weiterhin zur Zielinstanz aufgelöst werden, kannst du eine Umleitung mit DNS konfigurieren. Konfiguriere zusätzlich zum
CNAME
-Datensatz, der zum Hostnamen der neuen Instanz aufgelöst wird, einen zweiten DNSCNAME
-Datensatz, der den Datenverkehr vom ursprünglichen Hostnamen an den neuen Hostnamen weitergibt. Weitere Informationen findest du in der Dokumentation für den DNS-Anbieter. -
Deaktiviere in der Zielinstanz den Wartungsmodus.