Installieren und Konfigurieren der Suche
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018
Erfahren Sie, wie Sie die folgenden Aktionen für die Sucherweiterung für Code-, Wiki- und Arbeitselementsuchen in Azure DevOps Server ausführen.
Informationen zum Verwalten der Suchindizierung finden Sie unter Verwalten von Suche und Indizierung.
Voraussetzungen
- Um die Sucherweiterung zu installieren, müssen Sie ein Project Collection Administrator (PCA) für die Organisation sein. Nicht administrative Benutzer können auch anfordern, dass die Erweiterung ihrem PCA hinzugefügt wird.
- Weitere Informationen finden Sie unter Installieren und Konfigurieren von Azure DevOps Server und Anforderungen und Kompatibilität.
Hardware-Empfehlungen
Sie können die Suche auf einem physischen Server oder virtuellen Computer jeder Größe verwenden, auf dem Azure DevOps Server ausgeführt wird. Sie können es auf demselben Server oder auf einem separaten Server konfigurieren, der der Suche gewidmet ist. Wenn Sie die Suche auf demselben Server konfigurieren, berücksichtigen Sie den vorhandenen CPU-Auslastungsfaktor aufgrund Azure DevOps Server selbst.
Tipp
Für Produktionsumgebungen empfiehlt es sich, die Suche auf einem separaten Server zu konfigurieren.
Berücksichtigen Sie die folgenden Empfehlungen, um eine akzeptable Leistung in Szenarien mit mehreren Benutzern zu erzielen:
- Weniger als 250 Benutzer mit Suchen auf dem Server (in der Regel zu Demonstrations- und Testzwecken verwendet):
- Quad Core-Prozessor, 16 GB (Minimum) RAM
- CPU-Auslastungsfaktor kleiner als 50 %
- Schnelle Festplatte, die von SSD-Speicher (Solid State Drive) unterstützt wird
- Weniger als 500 Benutzer mit Suche auf einem separaten Server:
- Dual Core-Prozessor, mindestens 8 GB RAM
- Schnelle Festplatte, die von SSD-Speicher (Solid State Drive) unterstützt wird
- Weniger als 1.000 Benutzer mit Suche auf einem separaten Server:
- Quad Core-Prozessor, 16 GB (Minimum) RAM
- Schnelle Festplatte, die von SSD-Speicher (Solid State Drive) unterstützt wird
- Mehr als 1.000 Benutzer mit Suche auf einem separaten Server:
- Quad Core-Prozessor, 16 GB (Minimum) RAM
- Schnelle Festplatte, die von SSD(Solid State Drive) oder SAN-Speicher (Storage Area Network) unterstützt wird
- Azure DevOps Server mit mehreren ATs:
- Installieren der Suche auf einem separaten Server
- Azure DevOps Server CPU-Auslastung von mehr als 50 % vor der Search-Installation:
- Installieren der Suche auf einem separaten Server
Speicherplatzbedarf:
Der von der Suche belegte Speicherplatz hängt hauptsächlich vom Typ und der Größe der indizierten Dateien ab. Bei der Codesuche kann der Speicherplatzbedarf erheblich sein, da Repositorys häufig groß sein können und unterschiedliche Codedateien in der Versionskontrolle enthalten. Ordnen Sie bis zu 150 % der Größe aller zu indizierten Repositorys zu. Ab TFS 2018 Update 3 können Benutzer Ordner aus ihren Repositorys für den Index ausschließen, um den von der Suche belegten Speicherplatz zu optimieren.
Softwareabhängigkeiten
Die Suche verfügt über die folgenden Abhängigkeiten, die automatisch als Teil der Konfiguration installiert werden:
- Elasticsearch von Elasticsearch BV (siehe Anmerkungen 1 und 2)
- Elasticsearch NEST-Client
- Azul Zulu OpenJDK (siehe Java-Installationshinweise)
- Markdowndeep von Topten Software
- Roslyn-Compilerplattform
- ANTLR-Spracherkennungsparser
Hinweis
- Die Suche verwendet eine geänderte Version von Elasticsearch. Es funktioniert nur mit dieser geänderten Version.
- Eine neuere Version von Elasticsearch wird mit TFS 2018 Update 2 und höher und Azure DevOps Server ausgeliefert. Alle Inhalte werden nach der Installation neu indiziert, wenn Sie ein Upgrade von einer älteren Version von Suchergebnissen durchführen. Abhängig von der Menge des Inhalts (Codedateien, Arbeitselemente und Wikiseiten) kann die Neuindizierung einige Zeit in Anspruch nehmen.
- Der System- oder Serveradministrator muss sicherstellen, dass die Server JRE gemäß den Empfehlungen des Softwareanbieters verwaltet und aktualisiert wird. Weitere Informationen finden Sie in den folgenden Java-Installationshinweisen .
- Das Azul Zulu OpenJDK installiert Updates nicht automatisch.
- Stellen Sie sicher, dass Sie regelmäßig nach Updates suchen
Java-Installationshinweise
- Wenn der Suchkonfigurations-Assistent keine funktionierende Installation einer Java Runtime Environment (JRE) erkennt, bietet er eine Option zum Herunterladen und Installieren der neuesten unterstützten Version. Zum Herunterladen ist eine Internetverbindung erforderlich. Wenn der Zielserver keine Internetverbindung aufweist, müssen Sie eine JRE manuell herunterladen und installieren, bevor Sie versuchen, Search zu installieren.
- Versionen der Suche vor Azure DevOps Server die Oracle Server Java Runtime-Umgebung verwendet. In Azure DevOps Server ist die Standard-JRE Azul Zulu OpenJDK.
- Während der Installation legt der Assistent die JAVA_HOME Umgebungsvariable so fest, dass sie auf den JRE-Installationsordner verweist. Der Konfigurations-Assistent erkennt möglicherweise keine vorhandene JRE-Installation, wenn sie nicht ordnungsgemäß konfiguriert wurde oder wenn die einstellung JAVA_HOME auf eine frühere Version verweist, die für die Suche erforderlich ist.
Hinweis
Wir raten davon ab, Elasticsearch auf einem Computer zu installieren, auf dem Ressourcen gemeinsam genutzt werden, insbesondere nicht in einer großen Unternehmensumgebung mit mehreren Anwendungsebenen. Stattdessen wird empfohlen, Elasticsearch auf einem separaten dedizierten Computer einzurichten. Auf diese Weise wird die JAVA-Umgebung nicht computerübergreifend für andere Zwecke freigegeben.
Wenn eine JRE-Version früher als die für Search erforderliche Mindestversion vorhanden ist und die JAVA_HOME Variable auf diese Version festgelegt wurde, empfiehlt es sich, Search auf einem separaten Server zu installieren. Wenn Sie den Wert der variablen JAVA_HOME ändern, kann dies zu einem Fehler bei anderer installierter Software führen.
Wenn es eine Version von Server JRE gibt, die mindestens dem für die Suche erforderlichen Minimum entspricht und vom Konfigurations-Assistenten nicht erkannt wird, legen Sie den Wert der variablen JAVA_HOME auf diese Version fest. Diese Aktion wird im JRE-Installationshandbuch beschrieben. Führen Sie dann den Konfigurations-Assistenten erneut aus.
Wenn Sie die von Search erforderliche Java-Version aufgrund anderer Abhängigkeiten nicht installieren können, können Sie die folgenden Aufgaben ausführen:
- Installieren Sie Azure DevOps Server mit der Search-Erweiterung auf einem Server, auf dem Java nicht installiert ist. Wir empfehlen diese Aktion nicht für mehr als 250 Benutzer oder eine CPU-Auslastung von mehr als 50 % oder mehrere ATs.
- Installieren von Search und JRE auf einem separaten Server von Azure DevOps Server
Hinweis
Wenn Sie Oracle Server JRE 8 verwenden, was die Standardeinstellung für Die Suche in TFS war (Azure DevOps Server nicht Oracle Server JRE 8 verwendet), beachten Sie die folgenden Informationen:
- Die Suche verwendet oder unterstützt keine kommerziellen Features von Server JRE 8. Daher werden während der Suchkonfiguration die kommerziellen Features der Server JRE weder aktiviert noch entsperrt.
- Wenn Sie mit Oracle JRE fortfahren möchten, wenden Sie sich an Oracle, um ein Java SE-Abonnement zu erhalten, damit Sie weiterhin JRE-Updates erhalten können.
Migrieren zu Zulu OpenJDK von Oracle Server JRE
Die Suche in Azure DevOps Server unterstützt sowohl Azul Zulu OpenJDK als auch Oracle JRE, sodass Sie je nach Ihren Anforderungen zwischen ihnen wählen können. Wenn Sie während der Installation eine JRE auswählen, Azure DevOps Server standardmäßig Azul Zulu OpenJDK 8.
Führen Sie die folgenden Schritte aus, um zum Azul Zulu OpenJDK zu wechseln:
Weitere Informationen finden Sie unter GitHub Code-Search Java Migration.
Hinweis
- Wenn Sie Azul Zulu OpenJDK verwenden möchten, stellen Sie sicher, dass Sie Version 8 herunterladen.
Verfügbarkeit von Funktionen
- Die Arbeitselementsuche ist in TFS 2018 und höheren Versionen verfügbar.
- Die Wikisuche ist in TFS 2018 Update 2 und höheren Versionen verfügbar.
- Arbeitselement- und Wikisuche sind integrierte Erweiterungen, die standardmäßig während der Suchkonfiguration installiert werden.
- Die Codesuche ist in TFS 2018 und höheren Versionen verfügbar und ist ein Opt-In-Feature. Sie können die Codesuche später über den lokalen Katalog installieren. Wechseln Sie als Administrator zu Lokaler Katalog (
http://{server}/_gallery
). Nicht administrative Benutzer können die Erweiterung auch für Azure DevOps Server anfordern. Weitere Informationen finden Sie unter Installieren einer Erweiterung in der Dokumentation zum lokalen Katalog.
Konfigurieren der Suche
Konfigurieren Sie die Suchdienst mithilfe der dedizierten Seiten im Serverkonfigurations-Assistenten, während Sie Azure DevOps Server installieren. Sie können die Suche auch anschließend aufheben, indem Sie den Serverkonfigurations-Assistenten erneut ausführen oder den Suchkonfigurations-Assistenten starten. Beachten Sie zum Konfigurieren der Suche die Konfigurationsüberlegungen.
Überlegungen zur Konfiguration
Berücksichtigen Sie beim Konfigurieren der Suche die folgenden Informationen:
Sowohl die Arbeitselement- als auch die Wikisuche werden standardmäßig aktiviert, wenn die Suche konfiguriert ist. Diese Erweiterungen können später bei Bedarf von der Seite Erweiterungen verwalten von Azure DevOps Server
Die Codesuche-Erweiterung muss für jede Azure DevOps Server Sammlung installiert werden, in der Sie sie verwenden möchten. Beim anfänglichen Konfigurieren der Suche können Sie ein Kontrollkästchen auf Code Search-Erweiterung automatisch installieren für vorhandene und neue Projektsammlungen festlegen, um diesen Prozess zu automatisieren.
- Wenn Sie das Kontrollkästchen nicht zum Installieren der Codesuche-Erweiterung für alle Projektsammlungen festlegen, kann ihr PCA sie aus dem lokalen Katalog installieren. Stellen Sie sicher, dass Sie von Ihrer Azure DevOps Server Portalseite zum lokalen Katalog (
http://{Server}/_gallery
) wechseln. Weitere Informationen finden Sie unter Installieren einer Erweiterung in der Dokumentation zum lokalen Katalog.
- Wenn Sie das Kontrollkästchen nicht zum Installieren der Codesuche-Erweiterung für alle Projektsammlungen festlegen, kann ihr PCA sie aus dem lokalen Katalog installieren. Stellen Sie sicher, dass Sie von Ihrer Azure DevOps Server Portalseite zum lokalen Katalog (
Verwenden einer zweiten Festplatte und eines Remoteservers
Um eine maximale Leistung zu erzielen, sollte sich der Suchindexordner auf einer separaten schnellen Festplatte befinden und von schnellem Speicher wie einem Solid-State-Laufwerk (SSD) oder einem Storage Area Network (SAN) unterstützt werden. Ordnen Sie bis zu 150 % der Größe aller zu indizierenden Repositorys zu, was im schlimmsten Fall der Fall ist. Der tatsächliche Speicherplatz, der belegt wird, hängt von der Menge und dem Typ der Codedateien sowie von der Anzahl der Arbeitselemente und Wiki-Seiten in dieser Sammlung ab.
- Sofern nicht angegeben, verwenden der Indizierungsdienst und die Elasticsearch-Engine das Netzwerkdienstkonto während der Installation, um die Indexdateien zu erstellen und darauf zuzugreifen. Wenn Sie ein anderes Konto auswählen, muss es über die Berechtigung "Als Dienst anmelden" verfügen.
- Schränken Sie die Berechtigungen für den Indexdatenträger und -ordner ein, um den Index vor versehentlichen oder böswilligen Änderungen oder Löschungen zu schützen. Konfigurieren der entsprechenden Sicherheitseinstellungen für den Dienst
Wenn Sie die Suche nach einem Server mit mehreren Anwendungsebenen (ATs) konfigurieren, stellen Sie sicher, dass er auf einem separaten Server installiert ist. Nachdem Sie Search auf dem Remoteserver installiert haben, verwenden Sie den Konfigurations-Assistenten auf einem der AT-Server, um die Remotesucheinstanz mit Ihrer Azure DevOps Server-Instanz zu verknüpfen. Wenn Sie die Suche in Zukunft entkonfigurieren, müssen Sie den Konfigurations-Assistenten auf demselben AT-Server verwenden, auf dem die Konfiguration ursprünglich ausgeführt wurde.
Aktualisieren Ihres Servers
Wenn Sie ein Vorabproduktionsupgrade auf einem Server durchführen, auf dem Search bereits konfiguriert war, müssen Sie die Suche erneut vollständig neu konfigurieren, um eine Beschädigung Ihrer Produktionsinstanz zu vermeiden. Es gibt keine Option zum Konfigurieren der Suche im Rahmen eines Vorabproduktionsupgrades. Konfigurieren Sie es stattdessen, nachdem das Upgrade vor der Produktion abgeschlossen ist. Sie können die Option Codesuche für alle vorhandenen und neuen Sammlungen während der Konfiguration automatisch installieren und konfigurieren deaktivieren. Installieren Sie stattdessen die Sucherweiterung für nur eine oder zwei Ihrer Sammlungen, nachdem die Konfiguration abgeschlossen ist.
Wenn Sie ein Produktionsupgrade auf einem Server durchführen, auf dem die Suche konfiguriert ist und sie beibehalten möchten, aktivieren Sie das Kontrollkästchen neben Installieren und Konfigurieren der Suche. Der Assistent erkennt Ihre vorhandene Suchinstanz und wählt automatisch Vorhandene Suchinstanz verwenden aus, und füllt Ihre aktuelle Suchdienst-URL vorab auf. Verwenden Sie die Option Neue Suchinstanz installieren nur, wenn Sie eine neue Instanz von Search auf demselben Server einrichten möchten. Das Einrichten einer neuen Instanz führt dazu, dass Der gesamte Code, Die Arbeitselemente und das Wiki erneut indiziert werden, was je nach Größe der Sammlungen einige Zeit in Anspruch nehmen kann. Während der Indizierung werden Benutzern möglicherweise partielle Suchergebnisse angezeigt.
Wenn Sie Ihren Server auf neue Hardware aktualisieren, stehen Ihnen die folgenden beiden Optionen zur Auswahl. Wählen Sie eine der folgenden Optionen aus, je nachdem, wie Die Suche zuvor konfiguriert wurde:
- Wenn sich die Suche auf einem separaten Server von Azure DevOps Server befindet, müssen Sie im Serverkonfigurations-Assistenten die Option Suche installieren und konfigurieren auswählen und dann Vorhandene Suchinstanz verwenden auswählen und die URL Ihrer vorhandenen Suchinstanz angeben, um die Suchkonfiguration abzuschließen.
- Wenn Die Suche zusammen mit Ihrer Azure DevOps Server-Instanz auf dem alten Server konfiguriert ist, müssen Sie im Serverkonfigurations-Assistenten die Option Suche installieren und konfigurieren auswählen. Wählen Sie dann Erneut eine neue Search-Instanz auf dem neuen Server installieren aus, wenn Sie weiterhin die Suche cohostieren und Azure DevOps Server möchten. Alle Suchindizes für alle Sammlungen werden neu erstellt, was je nach Größe der einzelnen Auflistungen einige Zeit dauern kann.
Wenn Sie eine Auflistung von einer Azure DevOps Server Instanz trennen, um sie an eine andere Instanz anzufügen, führen Sie die folgenden Schritte aus:
- Trennen der Auflistung von Azure DevOps Server Quellinstanz
- Konfigurieren der Suche für die Zielinstanz Azure DevOps Server (falls noch nicht abgeschlossen)
- Anfügen der Auflistung an die Ziel-Azure DevOps Server
- Deinstallieren Sie Ihre Sucherweiterungen wie Code, Arbeitselement oder Wiki für die Sammlung aus dem lokalen Katalog in Ihrem Azure DevOps Server
- Installieren Sie die Sucherweiterung für die Sammlung aus dem lokalen Katalog, indem Sie von Ihrer Ziel-Azure DevOps Server-Instanz zu ihr navigieren.
Installieren oder Aktualisieren der Suche auf einem separaten Server
Führen Sie zum Installieren oder Aktualisieren der Suche auf einem separaten Server oder einem Remoteserver die folgenden Schritte aus, wenn in der Regel mehr als 250 Benutzer vorhanden sind:
Wenn Sie Azure DevOps Server auf dem primären Server installieren, aktivieren Sie das Kontrollkästchen Suche installieren und konfigurieren auf der Seite Suchen des Serverkonfigurations-Assistenten.
Wählen Sie die Option Vorhandene Suchdienst verwenden aus.
Verwenden Sie den Suchdienst-Paketlink, der im Assistenten bereitgestellt wird, um auf eine Reihe von Suchinstallationsprogrammdateien auf dem lokalen Computer zuzugreifen. Kopieren Sie dann diese Dateien auf den Remoteserver.
Befolgen Sie die Anweisungen in der dateiReadme.txt, die sich im Satz der Installationsdateien befindet, um die Suchdienst auf dem Remoteserver zu installieren oder zu aktualisieren.
Kopieren Sie nach Abschluss der Installation die resultierende Suchserver-URL in das Feld Such-URL des Konfigurations-Assistenten, der auf der Azure DevOps Server-Instanz ausgeführt wird.
Wenn beide Installationen abgeschlossen sind, konfigurieren Sie die entsprechenden Sicherheitseinstellungen für beide Server.
Sichere Suche
Die Suchdienst verwendet eine geänderte Version von Elasticsearch (die Begriffe "Search" und "Elasticsearch" werden für den Rest dieses Abschnitts synonym verwendet). Administratoren müssen Anmeldeinformationen angeben, unabhängig davon, ob sich die Suchdienst auf demselben Computer wie Azure DevOps Server oder auf einem separaten Computer befindet. Diese Aktion ist Teil des Konfigurierens des Suchfeatures über den Server oder den Assistenten für die Konfiguration der Suche. Diese Anmeldeinformationen sind neu und beziehen sich nicht auf bereits vorhandene Konto- oder Serveranmeldeinformationen. Sie werden zum Einrichten und Herstellen einer Verbindung mit Suchdienst verwendet. Diese neuen Anmeldeinformationen ermöglichen die Standardauthentifizierung im Suchdienst.
Für ein Upgrade von TFS 2018 Update 1.1 auf TFS 2018 Update 3 oder für eine Neukonfiguration der Suche werden nur die Benutzerinformationen automatisch aufgefüllt, und Administratoren müssen Kennwortanmeldeinformationen angeben. Administratoren können auf Wunsch einen anderen Benutzernamen und ein anderes Kennwort angeben. Wenn sich die Suchdienst auf demselben Computer wie Azure DevOps Server befindet, können Administratoren im Konfigurations-Assistenten einen neuen Satz von Anmeldeinformationen bereitstellen, um die Suchdienst einzurichten, falls gewünscht. Wenn sich der Suchdienst jedoch auf einem Remotecomputer befindet, müssen Administratoren zuerst die neuen Anmeldeinformationen für das Suchdienst Setupskript angeben.
Hinweis
- Die Werte für Benutzername und Kennwort sollten beide zwischen 8 und 64 Zeichen lang sein. Während dem Kennwort ein beliebiger Wert zugewiesen werden kann, darf der Benutzername nur alphanumerische Zeichen und Unterstriche enthalten.
- Suchanmeldeinformationen authentifizieren nur die Benutzer, und stellen Sie sicher, dass nicht authentifizierte Benutzer nicht auf den Elasticsearch-Endpunkt zugreifen können. Elasticsearch unterstützt jedoch https nicht, sodass diese Anmeldeinformationen über das Netzwerk als Base64-codierte Zeichenfolgen gesendet werden. Wenn es die Möglichkeit gibt, einen zwischengeschalteten Zugriff anzufordern, konfigurieren Sie die entsprechenden Sicherheitseinstellungen basierend auf den Sicherheits- und Complianceanforderungen Ihres Unternehmens.
- Ziel ist es, den Zugriff sowohl auf die Suche als auch die Indizierung auf bestimmte Benutzer oder Benutzergruppen mithilfe der Verschlüsselung über IPSec zu beschränken. Dies wird wie folgt beschrieben.
Betrachten Sie die folgenden Techniken für die Verwendung von IPSec zum Schützen von Elasticsearch auf einem Windows-Server:
Konfigurieren der Sicherheit nur mit Authentifizierung:
- Stellt sicher, dass nur autorisierte Benutzer auf den Elasticsearch-Port zugreifen können. Es erfordert nur dienstseitige Regeln (Firewallregeln nur auf dem Server, auf dem Elasticsearch ausgeführt wird)
- Voraussetzung: Azure DevOps Server muss mit einem Domänenkonto konfiguriert werden
- Führen Sie die Schritte unter Erstellen von Firewallregeln aus, die IPsec-geschützten Netzwerkdatenverkehr zulassen.
Konfigurieren der Sicherheit mit Authentifizierung, Integritätsschutz und Verschlüsselung:
- Stellt sicher, dass Verschlüsselung und Integritätsschutz zusammen mit der Authentifizierung angewendet werden. Es erfordert clientseitige und dienstseitige Regeln (Firewallregeln auf dem Server mit Elasticsearch und allen Azure DevOps Server App-Ebenenservern).
- Voraussetzung: Azure DevOps Server muss mit einem Domänenkonto konfiguriert werden
- Führen Sie die Schritte unter Isolieren eines Servers durch Anfordern von Verschlüsselung und Gruppenmitgliedschaft aus.
Upgradesuche
TFS 2018 Update 2 enthält aktualisierte Suchkomponenten und Wiki Search.
- Wenn die Suchdienst während des RTM-Upgrades 2018 eingerichtet und im TFS-System, das Sie aktualisieren, konfiguriert wurde, werden die Komponenten automatisch aktualisiert.
- Wenn Die Suche auf einem Remoteserver konfiguriert wurde, führen Sie die folgenden Anweisungen aus , um sie zu aktualisieren.
In beiden Fällen werden alle vorhandenen Inhalte (Codedateien und Arbeitselemente) automatisch neu indiziert, um die aktualisierten Komponenten nach der Konfiguration zu unterstützen. Je nach Inhaltsmenge kann es einige Zeit dauern, bis dieses Upgrade abgeschlossen ist.
TFS 2018 Update 1.1 und TFS 2018 Update 3 enthalten die Standardauthentifizierung für die Kommunikation zwischen TFS und Suchdienst, um die Sicherheit zu erhöhen. Jede Installation oder ein Upgrade auf TFS 2018 Update 1.1 oder TFS 2018 Update 3 muss beim Konfigurieren der Suchfunktion über den Server oder den Suchkonfigurations-Assistenten Anmeldeinformationen bereitstellen.
TFS 2018 Update 2 (oder höher) für Version Azure DevOps Server 2019 Update 1 erfordert eine Neuinstallation der Suche, wenn die Suche auf einem separaten Server konfiguriert ist. Führen Sie in Schritt 4 den folgenden Befehl aus
Configure-TFSSearch.ps1 – Operation update
, um die Suche erneut zu installieren:
Configure-TFSSearch.ps1 -Operation remove
Configure-TFSSearch.ps1 -Operation install -TFSSearchInstallPath <install location> -TFSSearchIndexPath $env:SEARCH_ES_INDEX_PATH
Deinstallieren der Suche
Für ein Präproduktionsupgrade, ein Produktionsupgrade, eine neue Hardwaremigration, ein Klonen oder einen anderen Wartungsvorgang hebt der Serverkonfigurations-Assistent die Konfiguration der Suche auf. Es ist jedoch einfach, nach Abschluss des Serverwartungsvorgangs neu zu konfigurieren.
Es kann jedoch Vorkommen geben, in denen Sie die Suche nicht mehr verwenden möchten oder eine neu und neu installieren möchten. Dieser Vorgang erfordert mehrere Schritte, je nachdem, ob die Suche auf demselben Server wie Azure DevOps Server oder auf einem separaten Server konfiguriert ist.
Heben Sie die Konfiguration der Suche auf dem Computer auf, der als Ihr Azure DevOps Server
Deinstallieren Sie die Sucherweiterung für jede Sammlung, in der sie installiert ist. Wechseln Sie zur Seite Erweiterungen verwalten jeder Sammlung in Ihrer Azure DevOps Server-Instanz:
Entfernen Sie das Suchfeature:
- Öffnen der Azure DevOps Server-Verwaltungskonsole
- Wählen Sie im linken Bereich den Namen des Servers aus.
- Wählen Sie im rechten Bereich Feature entfernen aus.
- Wählen Sie im Dialogfeld Feature entfernen die Option Suchdienst und dann Entfernen aus.
Entfernen Sie den Elasticsearch-Dienst:
- Eingabeaufforderung als Administrator öffnen
- Ändern Sie das Verzeichnis:
- Für TFS 2018 Update 2 und höher und Azure DevOps Server
cd "C:\Program Files\Microsoft Team Foundation Server 15.0\Search\ES\elasticsearch-5.4.1\bin"
- Für TFS 2018 Update 2 und höher und Azure DevOps Server
- Entfernen Sie den Dienst:
- Für TFS 2018 und Azure DevOps Server:
"elasticsearch-service.bat remove"
- Für TFS 2018 und Azure DevOps Server:
Entfernen von Suchdaten:
- Löschen des Inhalts des von der Umgebungsvariablen beschriebenen Speicherorts
SEARCH_ES_INDEX_PATH
- Löschen des Inhalts des von der Umgebungsvariablen beschriebenen Speicherorts
Entfernen von Umgebungsvariablen:
- Löschen der Umgebungsvariablen
"SEARCH_ES_INDEX_PATH"
- Löschen Sie die Umgebungsvariable
"ES_HEAP_SIZE"
(diese Umgebungsvariable ist für TFS 2018 Update 2 und höher veraltet und Azure DevOps Server)
- Löschen der Umgebungsvariablen
Deaktivieren der Konfiguration der Suche, wenn sie auf einem separaten Server konfiguriert ist
Deinstallieren Sie die Sucherweiterung, z. B. für Code, Arbeitselement oder Wiki, für jede Sammlung, in der sie installiert ist. Wechseln Sie zur Seite Erweiterungen verwalten jeder Sammlung in Ihrer Azure DevOps Server-Instanz.
Entfernen Sie das Suchfeature:
- Öffnen des Dialogfelds "Feature entfernen" in der Verwaltungskonsole
- Wählen Sie im linken Bereich den Namen der Azure DevOps Server
- Wählen Sie im rechten Bereich Feature entfernen aus.
- Wählen Sie im Dialogfeld Feature entfernen die Option Suchdienst und dann Entfernen aus.
Entfernen Sie den Elasticsearch-Dienst und die Daten:
- Öffnen von PowerShell als Administrator
- Öffnen Sie den Ordner Configure Search.ps1 zusammen mit den restlichen Dateien, die für eine Remoteinstallation von Search erforderlich sind.
- Führen Sie das Skript mit der Option remove erneut aus:
"ConfigureTFSSearch.ps1 -remove"
Sucheinschränkungen
Die Suche nach Azure DevOps Server weist die folgende Einschränkung auf:
- Wenn Sie einen Notfallwiederherstellungsvorgang durchführen und Ihren Server zurück zu einer früheren Momentaufnahme Ihrer SQL-Datenbank verschieben, indizieren Sie alle Ihre Sammlungen erneut.