Informationen zum Wartungsmodus
Bei einigen Vorgangstypen musst du deine GitHub Enterprise Server-Instanz 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 deine GitHub Enterprise Server-Instanz nur von den angegebenen IP-Adressen und Bereichen aus zu ermöglichen. Zugriffsversuche auf deine GitHub Enterprise Server-Instanz ü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 deine GitHub Enterprise Server-Instanz und eignet sich daher ideal für die anfängliche Überprüfung der Serverintegrität nach einem Wartungsvorgang. Nach der Aktivierung wird deine GitHub Enterprise Server-Instanz 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 deine GitHub Enterprise Server-Instanz kehrt zum Wartungsmodus zurück. Wenn du einfach die IP-Ausnahmeliste deaktivierst, kehrt deine GitHub Enterprise Server-Instanz 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 deine GitHub Enterprise Server-Instanz 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 Verwaltungskonsole.
Aktivieren oder Deaktivieren des Wartungsmodus für GitHub Enterprise Server über die CLI
Mit dem Hilfsprogramm ghe-maintenance kannst du den Wartungsmodus für eine einzelne Instanz von GitHub Enterprise Server festlegen oder deaktivieren.
$ ghe-maintenance -h
# Shows options
$ ghe-maintenance -q
# Queries the current mode
$ ghe-maintenance -s
# Sets maintenance mode
$ ghe-maintenance -u
# Unsets maintenance mode
Aktivieren oder Deaktivieren des Wartungsmodus für alle Knoten in einem Cluster über die CLI
Mit dem ghe-cluster-maintenance-Hilfsprogramm kannst du den Wartungsmodus für jeden Knoten in einem Cluster festlegen oder die Festlegung aufheben.
$ ghe-cluster-maintenance -h
# Shows options
$ ghe-cluster-maintenance -q
# Queries the current mode
$ ghe-cluster-maintenance -s
# Sets maintenance mode
$ ghe-cluster-maintenance -u
# Unsets maintenance mode