Ändern des Hostnamens für deine Instanz

Wenn du den Hostnamen für eine vorhandene GitHub Enterprise Server-Instanz ändern möchtest, musst du die Einstellungen und Daten in einer neuen Instanz wiederherstellen.

In diesem Artikel

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.

Warnung: Ä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

  1. Konfiguriere eine Zielinstanz von GitHub Enterprise Server mit dem neuen Hostnamen, den du verwenden möchtest. Weitere Informationen findest du in der folgenden Dokumentation.

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

  3. Aktiviere in der Quellinstanz den Wartungsmodus. Weitere Informationen findest du unter Wartungsmodus aktivieren und planen.

  4. Sichere die Daten und Einstellungen der Quellinstanz mithilfe von GitHub Enterprise Server Backup Utilities. Weitere Informationen findest du unter Konfigurieren von Sicherungen auf einer Instanz.

  5. Stelle die Sicherung auf der Zielinstanz mit dem gewünschten Hostnamen wieder her. Wenn du das ghe-restore-Hilfsprogramm ausführst, verwende die -c-Option, um die Konfiguration der Zielinstanz zu überschreiben. Weitere Informationen findest du unter Konfigurieren von Sicherungen auf einer Instanz.

  6. Schließe die Konfiguration der Zielinstanz ab. Weitere Informationen findest du unter Konfigurieren von GitHub Enterprise.

  7. Aktiviere in der Zielinstanz den Wartungsmodus.

  8. Während sich die Zielinstanz im Wartungsmodus befindet, überprüfe die Konfiguration der Instanz, und stelle sicher, dass die Benutzerdaten intakt sind. Weitere Informationen findest du unter Wartungsmodus aktivieren und planen.

  9. 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 DNS CNAME-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.

  10. Deaktiviere in der Zielinstanz den Wartungsmodus.