Verwalten von Suchindizes für Ihre Instance

GitHub Enterprise Server stärkt die Suchfunktionen mit Elasticsearch und verfügt über Tools zum Verwalten des Such- und Indizierungsverhaltens.

Wer kann dieses Feature verwenden?

Enterprise owners can manage search indices for a GitHub Enterprise Server instance.

In diesem Artikel

Informationen zur Suche für GitHub Enterprise Server

Benutzer können Ihre Instance durchsuchen, um Issues, Pull Requests, Code und andere Inhalte in GitHub Enterprise Server zu finden, durchzugehen und zu verstehen. Elasticsearch stärkt die Suchfunktion für Ihre Instance. Sie können den aktuellen Status von Elasticsearch anzeigen und das Such- und Indizierungsverhalten steuern.

Weitere Informationen zur Suche für GitHub Enterprise Server findest du unter In der GitHub-Dokumentation suchen. Weitere Informationen zu Elasticsearch finden Sie auf der Elasticsearch-Website.

Informationen zur Indexverwaltung

GitHub Enterprise Server stimmt den Suchindexstatus automatisch und regelmäßig mit Daten in der Instanz ab, wie:

  • Issues, Pull Requests, Repositorys und Benutzer in der Datenbank
  • Git-Repositorys (Quellcode) auf dem Datenträger

Bei normaler Verwendung müssen Unternehmensbesitzer keine neuen Indizes erstellen oder Reparaturaufträge planen. Zur Problembehandlung oder zu anderen Supportzwecken kann der GitHub-Support dich anweisen, einen Reparaturauftrag auszuführen.

Anzeigen von Suchindizes

  1. Klicke in der oberen rechten Ecke einer beliebigen Seite auf .
  2. Klicken Sie in der linken Randleiste auf Suchindizes.
  3. Klicken Sie unter „Indexverwaltung“ auf den anzuzeigenden Suchindex.

Erstellen eines neuen Suchindex

  1. Klicke in der oberen rechten Ecke einer beliebigen Seite auf .

  2. Klicken Sie in der linken Randleiste auf Suchindizes.

  3. Klicken Sie neben „Indexverwaltung“ auf Neuen Index erstellen.

  4. Gehen Sie zum Dropdown-Menü Zu erstellenden Index auswählen und klicken Sie dann auf den zu erstellenden Suchindex.

  5. Wenn der Index durchsuchbar sein soll, aktivieren Sie das Kontrollkästchen Diesen Index durchsuchbar machen.

  6. Wenn der Index beschreibbar sein soll, aktivieren Sie das Kontrollkästchen Diesen Index beschreibbar machen.

  7. Klicken Sie auf Index erstellen.

  8. Wenn Ihre Instanz eine Hochverfügbarkeits- oder Clusterkonfiguration verwendet, müssen Sie ein Skript ausführen, um sicherzustellen, dass die Anzahl der Suchindizes in der gesamten Instanz ordnungsgemäß konfiguriert ist.

    Greifen Sie über SSH auf die administrative Shell für Ihre primäre Anwendung zu, und führen Sie dann einen der folgenden Befehle aus.

    Für Hochverfügbarkeitskonfigurationen:

    Shell
    /usr/local/share/enterprise/ghe-es-auto-expand -v 0-all

    Für Clusterkonfigurationen:

    Shell
    /usr/local/share/enterprise/ghe-es-auto-expand -v 0-1

    Weitere Informationen findest du unter Auf die Verwaltungsshell (SSH) zugreifen.

Verwalten von Suchindizes

Wenn Sie einen vorhandenen Suchindex im Websiteadministrator-Dashboard anzeigen, können Sie die folgenden Aktionen ausführen:

  • Festlegen des Indexes als durchsuchbar
  • Festlegen des Indexes als beschreibbar
  • Aktualisieren des Indexes
  • Löschen des Indexes.
  • Zurücksetzen des Indexreparaturzustands
  • Starten eines neuen Indexreparaturauftrags
  • Aktivieren oder Deaktivieren von Indexreparaturaufträgen

Sowohl Such- als auch Indizierungsvorgänge für Quellcode können aktiviert oder deaktiviert werden. Weitere Informationen zur Codesuche findest du unter Suchen von Code.

  1. Klicke in der oberen rechten Ecke einer beliebigen Seite auf .
  2. Klicken Sie in der linken Randleiste auf Suchindizes.
  3. Klicken Sie im Abschnitt „Codesuche“ neben „Suche“ oder „Indizierung“ auf Aktivieren oder Deaktivieren.

Reparieren von Suchindizes

Ihre Instance verwendet Reparaturaufträge zum Abstimmen der Daten und plant einen Reparaturauftrag im Hintergrund, wenn die folgenden Ereignisse eintreten:

  • Ein neuer Suchindex wird erstellt.
  • Fehlende Daten müssen abgeglichen werden.
  • Veraltete Suchdaten müssen aktualisiert werden.

Im Abschnitt „Reparatur“ zeigt eine Statusanzeige den aktuellen Status eines Reparaturauftrags auf allen Hintergrundworkern an. Sie können den Wert in der Statusanzeige ignorieren, nachdem ein Reparaturauftrag abgeschlossen wurde. Die Statusanzeige gibt den Unterschied zwischen dem Reparaturoffset und der höchsten Datensatz-ID in der Datenbank an. Dieser wird kleiner, je mehr Repositorys auf Ihre GitHub Enterprise Server-Instance hinzugefügt werden, selbst wenn diese Repositorys eigentlich indiziert sind.

Um die Auswirkungen auf die E/A-Leistung zu minimieren und die Wahrscheinlichkeit von Timeouts bei Vorgängen zu verringern, führe den Reparaturauftrag außerhalb der Spitzenzeiten durch. Während der Auftrag den Suchindex mit Datenbank- und Git-Repositorydaten abstimmt, wird eine CPU verwendet. Überwache die durchschnittlichen Auslastungswerte und die CPU-Auslastung deines Systems mit einem Hilfsprogramm wie top. Wenn du keinen signifikanten Anstieg des Ressourcenverbrauchs feststellst, solltest du einen Indexreparaturauftrag auch während der Spitzenzeiten ausführen können.

Reparaturaufträge verwenden einen „Reparaturversatz“ zur Parallelisierung. Dies ist ein Versatz in der Datenbanktabelle für den abzustimmenden Datensatz. Anhand dieses Versatzes können mehrere Hintergrundaufträge die Arbeit synchronisieren.