Informationen zum Wartungsmodus
Bei einigen Vorgangstypen musst du Ihre GitHub Enterprise Server-Instance offlineschalten und in den Wartungsmodus versetzen:
- Upgrade auf eine neue Version von GitHub Enterprise Server
- Die der virtuellen Maschine zugeordneten CPU-, Arbeitsspeicher- oder Speicherressourcen erhöhen
- Daten von einer virtuelle Maschine zu einer anderen migrieren
- Daten aus einem GitHub Enterprise Server Backup Utilities-Snapshot wiederherstellen
- Fehlerbehebung bei bestimmten Typen kritischer Anwendungsprobleme
Du solltest ein Wartungsfenster für mindestens 30 Minuten in der Zukunft planen, um Benutzern Vorbereitungszeit zu geben. Nach der Planung eines Wartungsfensters wird allen Benutzern beim Zugriff auf die Website ein Banner angezeigt.
Wenn sich die Instanz im Wartungsmodus befindet, wird der gesamte normale HTTP- und Git-Zugriff abgelehnt. Dazu gehören Web- und API-Anforderungen, auf die die Appliance mit Statuscode 503
(Dienst nicht verfügbar) antwortet. Git-Abruf-, -Klon- und -Push-Vorgänge werden ebenfalls mit einer Fehlermeldung abgelehnt, die angibt, dass die Webseite temporär nicht verfügbar ist. Bei Konfigurationen mit Hochverfügbarkeit wird die Git-Replikation angehalten. GitHub Actions-Aufträge werden nicht ausgeführt. Wenn die Website in einem Browser aufgerufen wird, wird eine Wartungsseite angezeigt.
Du kannst die anfängliche Überprüfung deines Wartungsvorgangs durchführen, indem du eine IP-Ausnahmeliste konfigurierst, um den Zugriff auf Ihre GitHub Enterprise Server-Instance nur von den angegebenen IP-Adressen und Bereichen aus zu ermöglichen. Zugriffsversuche auf Ihre GitHub Enterprise Server-Instance über IP-Adressen, die nicht in der IP-Ausnahmeliste angegeben sind, erhalten dieselbe Antwort, die auch gesendet wird, wenn sich die Instanz im Wartungsmodus befindet.
Wartungsmodus sofort aktiviert oder Wartungsfenster für späteren Zeitpunkt planen
-
Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann in der rechten oberen Ecke einer beliebigen Seite auf „“.
-
Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
-
Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.
-
Klicke auf der oberen Navigationsleiste auf Wartung.
-
Wählen Sie unter "Aktivieren und planen" , ob der Wartungsmodus sofort aktiviert oder ein Wartungsfenster für einen späteren Zeitpunkt geplant werden soll.
- Wähle zum sofortigen Aktivieren des Wartungsmodus das Dropdownmenü aus, und klicke auf Jetzt.
- Wenn du ein Wartungsfenster für einen künftigen Zeitpunkt planen möchtest, wähle das Dropdownmenü aus, und klicke auf eine Startzeit.
-
Wenn Sie mit der Anzeigedauer des Fensters zufrieden sind, aktivieren Sie das Kontrollkästchen neben "Wartungsmodus aktivieren". Wenn Sie "Jetzt" ausgewählt haben, wird Ihre Instanz sofort in den Wartungsmodus versetzt.
Überprüfen von Änderungen im Wartungsmodus mithilfe der IP-Ausnahmeliste
Die IP-Ausnahmeliste bietet kontrollierten und eingeschränkten Zugriff auf Ihre GitHub Enterprise Server-Instance und eignet sich daher ideal für die anfängliche Überprüfung der Serverintegrität nach einem Wartungsvorgang. Nach der Aktivierung wird Ihre GitHub Enterprise Server-Instance aus dem Wartungsmodus entfernt und steht nur für die konfigurierten IP-Adressen zur Verfügung. Das Kontrollkästchen für den Wartungsmodus wird aktualisiert und spiegelt die Zustandsänderung wider.
Wenn du den Wartungsmodus erneut aktivierst, wird die IP-Ausnahmeliste deaktiviert, und Ihre GitHub Enterprise Server-Instance kehrt zum Wartungsmodus zurück. Wenn du einfach die IP-Ausnahmeliste deaktivierst, kehrt Ihre GitHub Enterprise Server-Instance zum normalen Vorgang zurück.
Du kannst auch ein Befehlszeilen-Hilfsprogramm verwenden, um die IP-Ausnahmeliste zu konfigurieren. Weitere Informationen findest du unter Befehlszeilenprogramme und unter Auf die Verwaltungsshell (SSH) zugreifen.
-
Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann in der rechten oberen Ecke einer beliebigen Seite auf „“.
-
Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
-
Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.
-
Klicke auf der oberen Navigationsleiste auf Wartung, und vergewissere dich, dass der Wartungsmodus bereits aktiviert ist.
-
Wähle unter „IP-Ausnahmeliste aktivieren und konfigurieren“ die Option IP-Ausnahmeliste aktivieren aus.
-
Gib rechts neben dem Kontrollkästchen zum Aktivieren der Liste eine gültige Liste mit durch Leerzeichen getrennten IP-Adressen oder CIDR-Blöcken ein, denen der Zugriff auf Ihre GitHub Enterprise Server-Instance gestattet werden soll.
-
Klicken Sie auf Speichern.
Planen des Wartungsmodus mit GitHub Enterprise Server APIs
Mit der GitHub Enterprise Server APIs kannst du die Wartung für unterschiedliche Zeitpunkt oder Datumsangaben planen. Weitere Informationen findest du unter REST-API-Endpunkte für die Verwaltungskonsole.