Installieren und Konfigurieren der Suche
Azure DevOps Server 2022 – Azure DevOps Server 2019
In diesem Artikel erfahren Sie, wie Sie eine sichere Suchmaschine für Azure DevOps Server installieren, konfigurieren und deinstallieren, die auf Ihrer eigenen Hardware ausgeführt wird. Weitere Informationen finden Sie in den folgenden Artikeln:
- Verwaltung der Suche und Indizierung
- Software-Abhängigkeiten, weiter in diesem Artikel
- Azul Zulu OpenJDK
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 Azure DevOps Server installieren und konfigurieren und Anforderungen und Kompatibilität.
Hardware-Empfehlungen
Die Suche funktioniert auf jedem physischen Server oder jeder virtuellen Maschine, auf der Azure DevOps Server ausgeführt wird. Sie können sie auf demselben oder einem anderen Server für die Suche einrichten. Wenn Sie denselben Server verwenden, sollten Sie die CPU-Auslastung berücksichtigen.
Tipp
Wir empfehlen, die Suche auf einem separaten Server für Produktionsumgebungen 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 Applikationsebenen (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
Bedarf an Datenträger:
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 ausschließen, um den von der Suche verbrauchten Speicherplatz zu optimieren.
Softwareabhängigkeiten
Search hat die folgenden Abhängigkeiten, die automatisch als Element der Konfiguration installiert werden:
- Elasticsearch von Elasticsearch.
- Die Suche verwendet eine geänderte Version von Elasticsearch. Sie funktioniert nur mit dieser modifizierten 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. Je nach dem Volumen der Inhalte (Code-Dateien, Arbeitselemente und Wiki-Seiten) kann die Neuindizierung einige Zeit in Anspruch nehmen.
- Elasticsearch NEST-Client.
- Microsoft Build von OpenJDK Version 11.
- Der Microsoft-Build von OpenJDK installiert Updates nicht automatisch.
- Markdowndeep von Topten Software.
- Roslyn-Compilerplattform.
- ANTLR-Spracherkennungsparser.
Hinweis
- 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.
- 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. Wir empfehlen Ihnen, Elasticsearch auf einer separaten Maschine 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 eine Version von Server JRE-gleich oder später als die von der Suche benötigte Mindestanforderung ist und vom Konfigurationsassistenten nicht erkannt wird, stellen Sie sicher, dass die JAVA_HOME-Variable NICHT festgelegt ist. Führen Sie dann den Konfigurationsassistenten (
& "C:\Program Files\Azure DevOps Server XXX\Search\ES\vX.XX\bin\elasticsearch-service.bat" manager
) erneut aus, und wählen Sie die Version aus, indem Sie den Pfad zur Java Virtual Machinefestlegen.Wenn Sie die von der Suche erforderliche Java-Version aufgrund anderer Abhängigkeiten nicht installieren können, können Sie diese Aufgaben angehen:
- 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 bei der Suchkonfiguration die kommerziellen Funktionen der Server JRE weder aktiviert noch freigeschaltet.
- Wenn Sie sich dafür entscheiden, mit Oracle JRE fortzufahren, wenden Sie sich an Oracle, um ein Java SE Abonnement zu erhalten, damit Sie weiterhin JRE-Updates erhalten können.
Wechseln Sie von Oracle Server JRE zu Microsoft Build von OpenJDK
Die Suche in Azure DevOps Server unterstützt sowohl den Microsoft Build von OpenJDK als auch Oracle JRE, so dass Sie je nach Anforderung zwischen beiden wählen können.
Um in den Microsoft Build von OpenJDK zu wechseln, stellen Sie sicher, dass die JAVA_HOME Variable NICHT festgelegt ist. Führen Sie dann den Konfigurationsassistenten (& "C:\Program Files\Azure DevOps Server XXX\Search\ES\vX.XX\bin\elasticsearch-service.bat" manager
) erneut aus, und wählen Sie die Version aus, indem Sie den Pfad zur Java Virtual Machinefestlegen.
Verfügbarkeit von Funktionen
- Die Suche nach Arbeitselementen ist in Team Foundation Server (TFS) 2018 und späteren 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 Code Search später aus der lokalen Galerie 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.
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.
Konfigurationsüberlegungen
Beachten Sie die folgenden Informationen, wenn Sie die Suche konfigurieren:
- 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 entfernt werden.
- Die Codesuche-Erweiterung muss für jede Azure DevOps Server Sammlung installiert werden, in der Sie sie verwenden möchten. Wenn Sie die Suche anfänglich konfigurieren, können Sie ein Kontrollkästchen festlegen, um die Codesuche-Erweiterung automatisch für vorhandene und neue Projektsammlungen zu installieren, um diesen Vorgang 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 Regel dauert es weniger als eine Stunde, bis die Suche eine Sammlung indiziert. Je nach Größe und Anzahl der Codedateien, Arbeitselemente oder Wiki-Seiten kann dies jedoch bis zu 12 Stunden dauern. Wenn Sie nach diesem Zeitraum keine Ergebnisse erhalten, überprüfen Sie den Indizierungsstatus.
Verwenden einer zweiten Festplatte und eines Remoteservers
- Für maximale Leistung sollte sich der Ordner für den Suchindex auf einer separaten schnellen Festplatte befinden und von schnellem Speicher unterstützt werden, z. B. einem SSD-Laufwerk (Solid State Drive) oder einem SAN (Storage Area Network). Ordnen Sie bis zu 150 % der Größe aller zu indizierenden Repositorys zu, was im schlimmsten Fall der Fall ist. Der tatsächlich verbrauchte Speicherplatz hängt von der Menge und dem Typ der Code-Dateien 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 für einen Server mit mehreren ATs konfigurieren, installieren Sie sie auf einem separaten Server. Nachdem Sie Search auf dem Remote-Server installiert haben, verwenden Sie den Konfigurationsassistenten auf einem der AT-Server, um die Remote-Search-Instanz mit Ihrer Azure DevOps Server-Instanz zu linken. Wenn Sie die Suche dekonfigurieren, müssen Sie den Konfigurationsassistenten auf demselben AT-Server verwenden, auf dem die Konfiguration ursprünglich durchgeführt wurde.
Aktualisieren Sie Ihren Server
- 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 Möglichkeit, die Suche im Rahmen eines Upgrades in der Vorproduktion zu konfigurieren. Konfigurieren Sie sie stattdessen, nachdem das Upgrade der Vorproduktion 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 voraus. Verwenden Sie die Option "Neue Suchinstanz installieren" nur, wenn Sie eine neue Instanz der Suche auf demselben Server einrichten möchten. Das Einrichten einer neuen Instanz bewirkt, dass der gesamte Code, die Arbeitselemente und das Wiki erneut indiziert werden, was – abhängig von der Größe der Sammlungen – einige Zeit in Anspruch nehmen kann. Während der Indizierung sehen die Benutzer möglicherweise nur teilweise Suchergebnisse
- Wenn Sie Ihren Server auf neue Hardware aktualisieren, stehen Ihnen die folgenden beiden Optionen zur Auswahl. Wählen Sie aus diesen Optionen, je nachdem, wie Search zuvor konfiguriert wurde:
- Wenn sich die Suche auf einem separaten Server von Azure DevOps Server befindet, müssen Sie im Serverkonfigurationsassistenten "Suche installieren und konfigurieren" auswählen und dann "Vorhandene Suchinstanz verwenden" auswählen und die URL Ihrer vorhandenen Suchinstanz angeben, um die Suchkonfiguration zu konfigurieren.
- 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 Sie die Sammlung von der Quellinstanz des Azure DevOps Servers
- Konfigurieren der Suche in der Zielinstanz des Azure DevOps Servers (sofern noch nicht geschehen)
- Befestigen Sie die Sammlung am Zielserver von Azure DevOps
- 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, legen Sie das Kontrollkästchen Installieren und Konfigurieren von Search fest. auf der Seite Suche des Serverkonfigurations-Assistenten.
- Wählen Sie die Option Vorhandene Suchdienst verwenden aus.
- Verwenden Sie den im Assistenten bereitgestellten Link des Suchdienstpakets und, um auf eine Sammlung von Installer-Dateien auf dem lokalen Rechner 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
Der Search-Dienst verwendet eine modifizierte Version von Elasticsearch. Die Begriffe "Suche" und "Elasticsearch" werden im weiteren Verlauf dieses Abschnitts synonym verwendet. Administratoren müssen Anmeldeinformationen angeben, unabhängig davon, ob sich der Suchdienst auf demselben Computer wie der Azure DevOps Server befindet oder auf einem separaten Computer. 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 stehen in keinem Zusammenhang mit bereits existierenden Konto- oder Server-Anmeldeinformationen. 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 die Neukonfiguration der Suche müssen nur die Benutzerinformationen automatisch ausgefüllt werden, und Administratoren müssen Anmeldeinformationen angeben. Administratoren können, falls gewünscht, unterschiedliche Anmeldeinformationen 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
- Anmeldeinformationswerte sollten beide zwischen 8 und 64 Zeichen lang sein.
- 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 die Möglichkeit besteht, einen Zwischenzugriff anzufordern, konfigurieren Sie geeignete 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:
Sicherheit nur mit Authentifizierung konfigurieren:
- 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 Sie die 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-Suche.
- 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, konsultieren Sie Installieren oder Aktualisieren der Suche auf einem separaten Server, 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: Enthält eine grundlegende Authentifizierung für die Kommunikation zwischen dem TFS- und dem Search-Dienst, um diese sicherer zu machen. 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) auf Version Azure DevOps Server 2019 Update 1: Wenn die Suche auf einem separaten Server konfiguriert ist, ist eine erneute Installation der Suche erforderlich. 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
Suche deinstallieren
Bei einem Upgrade der Vorproduktion, einem Produktions-Upgrade, einer Migration auf neue Hardware, einem Klonen oder einem anderen Wartungsvorgang deaktiviert der Server-Konfigurationsassistent die Suche. Es ist jedoch einfach, nach Abschluss des Serverwartungsvorgangs neu zu konfigurieren.
Es kann Fälle geben, in denen Sie die Suche nicht mehr verwenden möchten oder eine Neuinstallation durchführen 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. Wechseln Sie zur Seite Erweiterungen verwalten jeder Sammlung in Ihrer Azure DevOps Server-Instanz:
Entfernen Sie die Suchfunktion.
- Öffnen Sie die Azure DevOps Server-Administrationskonsole.
- Wählen Sie den Namen des Servers.
- Wählen Sie Feature entfernen aus.
- Wählen Sie Suchdienst aus, und wählen Sie dann Entfernen aus.
Entfernen Sie den Elasticsearch-Dienst:
- Öffnen Sie die Eingabeaufforderung als Administrator.
- Ändern Sie das Verzeichnis,
cd "C:\Program Files\Microsoft Team Foundation Server 15.0\Search\ES\elasticsearch-5.4.1\bin"
. - Entfernen Sie den Dienst,
"elasticsearch-service.bat remove"
.
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,
Löschen Sie die Umgebungsvariable,
"SEARCH_ES_INDEX_PATH"
.
Konfiguration der Suche auf einem separaten Server aufheben
Führen Sie die folgenden Schritte aus, um die Suche (z. B. für Code, Arbeitselement oder Wiki) für jede Kollektion zu dekonfigurieren.
Wechseln Sie zur Seite Verwalten von Erweiterungen für jede Sammlung in Ihrer Azure DevOps Server-Instanz.
Entfernen Sie die Suchfunktion.
- Öffnen Sie das Dialogfeld Feature entfernen in der Verwaltungskonsole.
- Wählen Sie im linken Fensterbereich den Namen des Azure DevOps-Servers.
- 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 Dienst Elasticsearch und die Daten.
- Öffnen Sie PowerShell als Administrator.
- Öffnen Sie den Ordner Configure Search.ps1 zusammen mit den restlichen Dateien, die für eine Remote-Installation von Search erforderlich sind.
- Führen Sie das Skript mit der Option remove erneut aus:
"ConfigureTFSSearch.ps1 -remove".
Beschränkungen von Search
Die Suche nach Azure DevOps Server weist die folgende Einschränkung auf:
- Alle Ihre Auflistungen neu indizieren, wenn Sie einen Notfallwiederherstellungsvorgang (DR) ausführen und den Server zurück zu einer früheren Momentaufnahme Ihrer SQL-Datenbank verschieben.
- Die Suche ist nicht erweiterbar, aber Sie können eine neue Funktionsanforderung an die Developer Communitysenden.