ElasticSearch-Indizes zu GitHub Enterprise Server 2.14 oder höher migrieren
Als Vorbereitung für ein Upgrade auf GitHub Enterprise Server 2.14 müssen Sie Ihre Indizes mit unserem Migrationsskript zu ElasticSearch 5.6 migrieren.
GitHub Enterprise Server 2.14 enthält ein Upgrade auf ElasticSearch 5.6. Bevor Sie ein Upgrade von GitHub Enterprise Server 2.12 oder 2.13 auf 2.14 durchführen, sollten Sie die ElasticSearch-Migrationstools herunterladen, installieren und ausführen, damit Ihre größten Indizes online migriert werden, während Ihre Appliance weiterhin über Online-Zugriff verfügt.
In diesem Handbuch
- Suchindizes
- Webhook-Indizes
- Verfügbare Indizes
- GitHub Enterprise Server-Appliance der Version 2.12 oder 2.13 vorbereiten
Suchindizes
Das Migrationsskript sucht zunächst nach Suchindizes, während die Appliance online ist. Die Migration der Suchindizes kann je nach ihrer Größe zwischen wenigen Minuten und einigen Tagen in Anspruch nehmen. Beispielsweise nahm die Migration großer Indizes in unserer Testumgebung mehrere Tage in Anspruch.
admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6
green open blog-1 1 0 0 0 144b 144b
green open projects-1 1 0 0 0 144b 144b
green open registry-packages-1 1 0 0 0 144b 144b
green open showcases-1 1 0 0 0 144b 144b
health status index pri rep docs.count docs.deleted store.size pri.store.size
green open pull-requests-1 1 0 1 0 9.3kb 9.3kb
green open wikis-1 1 0 2 0 5kb 5kb
green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb
green open repos-1 1 0 1638 1 1.4mb 1.4mb
green open gists-1 1 0 3531 64 291.9kb 291.9kb
green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb
green open users-1 1 0 19866 56 2.7mb 2.7mb
green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb
green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb
green open issues-1 1 0 26405 6 82.8mb 82.8mb
green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb
green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb
green open code-search-1 1 0 6932626 44 42.9gb 42.9gb
green open commits-1 1 0 63753587 1485 45.4gb 45.4gbDie Suchindizes beginnen mit:
- blog-
- code-search-
- commits-
- gists-
- issues-
- labels-
- marketplace-listings-
- non-marketplace-listings-
- projects-
- pull-requests-
- registry-packages-
- repos-
- showcases-
- topics-
- users-
Webhook-Indizes
Nachdem das Migrationsskript die erforderlichen Suchindizes online neu erstellt hat, überprüft das Skript, ob Webhook-Indizes neu erstellt werden müssen. Wenn die Ausführung Ihrer Appliance mit GitHub Enterprise Server 2.12 oder 2.13 mindestens 14 Tage gedauert hat, benötigen Sie Ihre Webhook-Indizes wahrscheinlich nicht, da Webhook-Indizes eine standardmäßige Aufbewahrungsrichtlinie von sieben Tagen aufweisen. Wenn Sie Ihre Appliance von GitHub Enterprise 2.11 oder früher aktualisieren, dann müssen Sie die Webhook-Indizes möglicherweise neu erstellen.
Wenn Webhook-Indizes neu erstellt werden müssen, werden Sie aufgefordert, den Wartungsmodus zu aktivieren, bevor das Skript die Webhook-Indizes neu erstellen kann. Obwohl die Migration von Webhook-Indizes zu einer gewissen Ausfallzeit führt, sind keine ausgedehnten Wartungsfenster oder Ausfallzeiten nötig.
Die Webhook-Indizes beginnen mit hookshot-logs-.
Verfügbare Indizes
Mittels „curl“ können Sie die auf Ihrer Appliance verfügbaren Indizes anzeigen.
admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6
green open blog-1 1 0 0 0 144b 144b
green open projects-1 1 0 0 0 144b 144b
green open registry-packages-1 1 0 0 0 144b 144b
green open showcases-1 1 0 0 0 144b 144b
health status index pri rep docs.count docs.deleted store.size pri.store.size
green open pull-requests-1 1 0 1 0 9.3kb 9.3kb
green open wikis-1 1 0 2 0 5kb 5kb
green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb
green open repos-1 1 0 1638 1 1.4mb 1.4mb
green open gists-1 1 0 3531 64 291.9kb 291.9kb
green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb
green open users-1 1 0 19866 56 2.7mb 2.7mb
green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb
green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb
green open issues-1 1 0 26405 6 82.8mb 82.8mb
green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb
green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb
green open code-search-1 1 0 6932626 44 42.9gb 42.9gb
green open commits-1 1 0 63753587 1485 45.4gb 45.4gbGitHub Enterprise Server-Appliance der Version 2.12 oder 2.13 vorbereiten
Wenn Sie ein Upgrade auf GitHub Enterprise Server 2.14 oder höher durchführen, ohne die Migrationstools auszuführen, sind die vorhandenen ElasticSearch-Indizes möglicherweise ungültig und funktionieren nicht richtig. Zum Ausführen des ElasticSearch-Migrationsskripts muss Ihre GitHub Enterprise Server-Appliance Version 2.12 oder 2.13 von GitHub Enterprise ausführen.
Warnung:
- Bei der Verwendung von GitHub Enterprise Server-Backup-Dienstprogramme werden nach der Wiederherstellung alte ElasticSearch-Indizes vernichtet, die nicht mit 5.X kompatibel sind. In diesem Fall wäre eine manuelle Neuindizierung erforderlich.
- Wenn GitHub Enterprise Server für die Hochverfügbarkeit konfiguriert ist, muss das Migrationsskript während der Ausführung der Replikation ausgeführt werden. Es muss zugelassen werden, dass die Änderungen vollständig mit der anderen Appliance repliziert werden, bevor das Upgrade gestartet wird. Wenn die Replikation während der Ausführung des Migrationsskripts nicht ausgeführt wird, werden Ihre ElasticSearch-Indizes möglicherweise ungültig.
-
Authentifizieren Sie sich mittels SSH mit aktivierter Hochverfügbarkeit bei der primären Appliance.
-
Laden Sie das Migrationsskript auf die Appliance herunter, und installieren Sie es:
$ wget https://github-enterprise.s3.amazonaws.com/util/es-5x-transition-tools.tar.gz $ sudo tar -C / -xvf es-5x-transition-tools.tar.gzWenn Sie einen GitHub Enterprise Server-Cluster verwalten, authentifizieren Sie sich mittels SSH bei einem der ElasticSearch-Serverknoten, und installieren Sie dort die Migrationstools. Suchen Sie sie wie folgt:
$ ghe-cluster-each -r elasticsearch -p ghe-test-data-0 ghe-test-data-1 ghe-test-data-2 -
Führen Sie das Migrationsskript aus:
$ /usr/local/share/enterprise/ghe-es-5x-migration -rHinweis: Wenn
Webhook-Indizes migriert werden sollen, werden Sie nach dem Ausführen der Online-Migrationen aufgefordert, den Wartungsmodus zu aktivieren. -
Wenn Sie einen GitHub Enterprise Server-Cluster ausführen, sollten Sie die offizielle Upgrade-Dokumentation für einzelne VMs oder Hochverfügbarkeitsumgebungen oder den Leitfaden zum Cluster-Upgrade befolgen. Weitere Informationen finden Sie unter „Upgrade von GitHub Enterprise Server“ oder „Cluster-Upgrade“.