Vorbereiten des Elasticsearch-Upgrades inGitHub Enterprise Server 3.13

Übersicht

Elasticsearch (ES) treibt die Suchfunktion Ihrer GitHub Enterprise Server-Instanz an. Um die Vorteile einer besseren Leistung und des Sicherheitsstatus zu erzielen, wird beim Upgrade Ihrer Instanz auf Version 3.13 oder höher die Elasticsearch-Version in der Anwendung von 5.6.16 auf 8.7.0 aktualisiert.

Die folgenden Abschnitte helfen Administratoren bei der Vorbereitung und Überwachung des Elasticsearch-Upgrades. Die wichtigsten Punkte sind:

• Das Upgrade beeinträchtigt vorübergehend die Erfahrung der Such- und Überwachungsprotokollfunktionen.
• Wenn Sie eine Instanz in einer Clusterkonfiguration aktualisieren, müssen Sie ein Skript ausführen, um den Cluster für das ES-Upgrade vorzubereiten. Weitere Informationen findest du unter Upgrade eines Clusters.
• Bei Backups sollten alle Kunden eine Momentaufnahme ihrer Instanz machen, wenn das Upgrade abgeschlossen ist.

Auswirkungen auf Such- und Überwachungsprotokolle

Alle Suchindizes werden nach dem Upgrade auf ES8 neu erstellt. Benutzer werden während der Neuerstellung eine beeinträchtigte Sucherfahrung erleben, doch die Instanz wird ansonsten als funktionsfähig und verfügbar eingestuft. Der Index-Neuerstellungsprozess hängt von der Größe des Datensets ab und kann einige Stunden bis hin zu Tagen dauern.

Überwachungsprotokolle sind nach dem Upgrade nicht sofort verfügbar, und es kann mehrere Stunden dauern, alle Überwachungsprotokolle zu migrieren.

Es wird dringend empfohlen, unmittelbar nach Abschluss der Index-Neuerstellung ein Backup (mithilfe von Backup-Dienstprogrammen) zu erstellen und diese Momentaufnahme für alle zukünftigen Wiederherstellungen zu verwenden. Weitere Informationen findest du unter Konfigurieren von Sicherungen auf deiner Instanz mithilfe von Sicherungshilfsprogrammen. Wenn Sie ein Backup aus einer Instanz wiederherstellen, in der GitHub Enterprise Server 3.11 oder 3.12 ausgeführt wird, sind alle Inhalte, die auf ES basieren, erst dann verfügbar, nachdem die ES-Indizes auf die 3.13-Instanz migriert und dort neu aufgebaut wurden.

Überwachen des Elasticsearch-Upgrades

Sie können den Fortschritt des ES-Upgrades im Website-Administrator-Dashboard überwachen.

1. Klicke in der oberen rechten Ecke einer beliebigen Seite auf .
2. Klicken Sie in der linken Randleiste auf Suchindizes.

Wenn der Neuaufbau der Indizes abgeschlossen ist, sollten alle Suchindizes grün angezeigt werden und '100 %' erreicht haben.

Ändern der Anzahl der Reparaturmitarbeiter

Standardmäßig wird die Anzahl der Indexreparaturworker auf die Anzahl der CPU-Kerne geteilt durch 8 (mit einer Obergrenze von 16) festgelegt. Um die Indexerstellung zu beschleunigen, können Sie die Anzahl der Mitarbeiter anpassen. Bevor Sie dies tun, sollten Sie jedoch die potenziellen Auswirkungen auf den Load berücksichtigen.

1. Melde dich über SSH bei Ihre GitHub Enterprise Server-Instance an. Wenn deine Instanz mehrere Knoten umfasst, wenn z. B. Hochverfügbarkeit oder Georeplikation konfiguriert ist, wird SSH im primären Knoten konfiguriert. Wenn du einen Cluster verwendest, kannst du SSH in einen beliebigen Knoten einfügen. Ersetzen Sie HOSTNAME durch den Hostnamen Ihrer Instanz bzw. durch den Hostnamen oder die IP-Adresse eines Knotens. Weitere Informationen finden Sie unter Auf die Verwaltungsshell (SSH) zugreifen.

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. Um die Anzahl der Mitarbeiter zu ändern, geben Sie den folgenden Befehl ein.

   Shell

   ghe-config app.github.es-workers NUMBER-OF-WORKERS
   

3. Führen Sie ghe-config-apply aus.

Sie können die Anzahl der Mitarbeiter auch für einzelne Index-Neuerstellungen im Abschnitt "Suchindizes" des Website-Administrator-Dashboards anpassen. Weitere Informationen findest du im Abschnitt Überwachen des Elasticsearch-Upgrades.