Instalowanie i konfigurowanie wyszukiwania

Azure DevOps Server 2022 — Azure DevOps Server 2019

W tym artykule dowiesz się, jak zainstalować, skonfigurować i odinstalować bezpieczną wyszukiwarkę dla serwera Azure DevOps Server, który działa na własnym sprzęcie. Aby uzyskać więcej informacji, zobacz następujące artykuły:

• Zarządzanie wyszukiwaniem i indeksowaniem
• Zależności oprogramowania, dalsze w tym artykule
• Azul Zulu OpenJDK

Wymagania wstępne

• Aby zainstalować rozszerzenie wyszukiwania, musisz być kolekcją projektów Administracja istrator (PCA) dla organizacji. Użytkownicy niebędący administratorami mogą również zażądać dodania rozszerzenia do umowy PCA.
• Aby uzyskać więcej informacji, zobacz Instalowanie i konfigurowanie serwera Azure DevOps Server oraz wymagań i zgodności.

Zalecenia dotyczące sprzętu

Wyszukiwanie działa na dowolnym serwerze fizycznym lub maszynie wirtualnej z uruchomionym serwerem Azure DevOps Server. Można go skonfigurować na tym samym serwerze lub na innym serwerze wyszukiwania. Jeśli używasz tego samego serwera, rozważ użycie procesora CPU.

Napiwek

Zalecamy skonfigurowanie funkcji Wyszukiwania na osobnym serwerze dla środowisk produkcyjnych.

Aby uzyskać akceptowalną wydajność w scenariuszach obejmujących wielu użytkowników, należy wziąć pod uwagę następujące zalecenia:

• Mniej niż 250 użytkowników z wyszukiwaniem znajdującym się na serwerze (zazwyczaj używanych do celów demonstracyjnych i próbnych):
  • Czterordzeniowy procesor, 16 GB (minimalna) pamięć RAM
  • Współczynnik wykorzystania procesora CPU mniejszy niż 50%
  • Szybki dysk twardy wspierany przez magazyn ssd
• Mniej niż 500 użytkowników z wyszukiwaniem znajdującym się na osobnym serwerze:
  • Dwurdzeniowy procesor, 8 GB (minimalna) pamięć RAM
  • Szybki dysk twardy wspierany przez magazyn ssd
• Mniej niż 1000 użytkowników z wyszukiwaniem znajdującym się na osobnym serwerze:
  • Czterordzeniowy procesor, 16 GB (minimalna) pamięć RAM
  • Szybki dysk twardy wspierany przez magazyn ssd
• Ponad 1000 użytkowników z wyszukiwaniem znajdującym się na osobnym serwerze:
  • Czterordzeniowy procesor, 16 GB (minimalna) pamięć RAM
  • Szybki dysk twardy wspierany przez magazyn SSD (SOLID State Drive) lub Storage Area Network (SAN)
• Usługa Azure DevOps Server z wieloma warstwami aplikacji (ATs):
  • Instalowanie wyszukiwania na osobnym serwerze
• Użycie procesora CPU usługi Azure DevOps Server większe niż 50% przed instalacją usługi Search:
  • Instalowanie wyszukiwania na osobnym serwerze

Wymaganie dotyczące miejsca na dysku:

Ilość miejsca na dysku używanego przez wyszukiwanie zależy głównie od typu i rozmiaru indeksowanych plików. Wyszukiwanie kodu, ponieważ wiele razy repozytoria mogą być duże i mają różne pliki kodu w kontroli wersji, wymaganie dotyczące miejsca na dysku może być znaczące. Przydziel do 150% rozmiaru wszystkich repozytoriów do indeksowania. W programie TFS 2018 Update 3 i nowszym użytkownicy mogą wykluczać foldery z repozytoriów dla indeksu, aby zoptymalizować miejsce na dysku używane przez wyszukiwanie.

Zależności oprogramowania

Wyszukiwanie ma następujące zależności, które są instalowane automatycznie w ramach konfiguracji:

• Elasticsearch by Elasticsearch.
  • Wyszukiwanie używa zmodyfikowanej wersji programu Elasticsearch. Działa tylko z tą zmodyfikowaną wersją.
  • Nowsza wersja programu Elasticsearch jest dostarczana z programem TFS 2018 Update 2 i nowszym oraz serwerem Azure DevOps Server. Cała zawartość jest ponownie indeksowana po instalacji po uaktualnieniu ze starszej wersji wyników wyszukiwania. W zależności od ilości zawartości (plików kodu, elementów roboczych i stron typu wiki) ponowne indeksowanie może zająć trochę czasu.
• Klient NEST usługi Elasticsearch.
• Microsoft Build of OpenJDK w wersji 11.
  • Zestaw Microsoft Build openJDK nie instaluje automatycznie aktualizacji.
• Markdowndeep firmy Topten Software.
• Platforma kompilatora Roslyn .
• Analizator rozpoznawania języka ANTLR .

Uwaga

• Administrator systemu lub serwera musi upewnić się, że środowisko JRE serwera jest utrzymywane i aktualizowane zgodnie z zaleceniami dostawcy oprogramowania. Zapoznaj się również z poniższymi uwagami dotyczącymi instalacji języka Java.
• Regularnie sprawdzaj dostępność aktualizacji.

Uwagi dotyczące instalacji języka Java

• Jeśli kreator konfiguracji wyszukiwania nie wykryje działającej instalacji środowiska Java Runtime Environment (JRE), udostępnia opcję pobierania i instalowania najnowszej obsługiwanej wersji. Do pobrania jest wymagana łączność z Internetem. Jeśli serwer docelowy nie ma łączności z Internetem, należy pobrać i zainstalować środowisko JRE ręcznie przed podjęciem próby zainstalowania usługi Search.

• Wersje wyszukiwania przed serwerem Azure DevOps Server używały środowiska uruchomieniowego Java Oracle Server. W usłudze Azure DevOps Server domyślnym serwerem JRE jest Azul Zulu OpenJDK.

• Podczas instalacji kreator ustawia zmienną środowiskową JAVA_HOME , aby wskazywała folder instalacyjny środowiska JRE. Kreator konfiguracji może nie wykryć istniejącej instalacji środowiska JRE, jeśli nie została poprawnie skonfigurowana lub jeśli ustawienie JAVA_HOME wskazuje wcześniejszą wersję niż wymagana przez usługę Search.

  Uwaga

  Nie zalecamy instalowania usługi Elasticsearch na maszynie, na której są udostępniane zasoby, zwłaszcza w dużym środowisku przedsiębiorstwa z wieloma warstwami aplikacji. Zalecamy skonfigurowanie usługi Elasticsearch na osobnej dedykowanej maszynie. W ten sposób środowisko JAVA nie jest współużytkowane między maszynami w innych celach.

• Jeśli istnieje wersja środowiska JRE wcześniejsza niż minimalna wymagana przez usługę Search, a zmienna JAVA_HOME została ustawiona na wersję, zalecamy zainstalowanie funkcji Search na osobnym serwerze.

• Jeśli istnieje wersja środowiska JRE serwera równa lub nowsza niż minimalna wymagana przez kreatora wyszukiwania i nie rozpoznana przez kreatora konfiguracji, upewnij się , że zmienna JAVA_HOME NIE jest ustawiona. Następnie uruchom ponownie kreatora konfiguracji (& "C:\Program Files\Azure DevOps Server XXX\Search\ES\vX.XX\bin\elasticsearch-service.bat" manager) i wybierz wersję, ustawiając ścieżkę dla maszyny wirtualnej Java.

• Jeśli nie możesz zainstalować wersji języka Java wymaganej przez usługę Search ze względu na inne zależności, możesz wykonać następujące zadania:

  • Zainstaluj serwer Azure DevOps Server z rozszerzeniem Search na serwerze, na którym nie zainstalowano języka Java. Nie zalecamy wykonania tej akcji dla ponad 250 użytkowników ani użycia procesora CPU większego niż 50% lub wielu ATS.
  • Zainstaluj usługę Search i środowisko JRE na osobnym serwerze z usługi Azure DevOps Server.

  Uwaga

  Jeśli używasz środowiska Oracle Server JRE 8, który był domyślnym ustawieniem wyszukiwania w programie TFS (serwer Azure DevOps Server nie używa środowiska Oracle Server JRE 8), pamiętaj o następujących informacjach:

  • Wyszukiwanie nie używa ani nie obsługuje żadnych funkcji komercyjnych serwera JRE 8. W związku z tym podczas konfiguracji wyszukiwania funkcje komercyjne środowiska JRE serwera nie są ani aktywowane, ani odblokowane.
  • Jeśli zdecydujesz się kontynuować korzystanie z środowiska Oracle JRE, skontaktuj się z firmą Oracle w celu uzyskania subskrypcji środowiska Java SE, aby nadal otrzymywać aktualizacje środowiska JRE.

Migrowanie do platformy Microsoft Build zestawu OpenJDK z środowiska Oracle Server JRE

Wyszukiwanie w usłudze Azure DevOps Server obsługuje zarówno platformę Microsoft Build of OpenJDK, jak i środowisko Oracle JRE, które pozwala wybrać między nimi na podstawie Twoich potrzeb.

Aby przejść do wersji Microsoft Build zestawu OpenJDK, upewnij się , że zmienna JAVA_HOME nie jest ustawiona. Następnie uruchom ponownie kreatora konfiguracji (& "C:\Program Files\Azure DevOps Server XXX\Search\ES\vX.XX\bin\elasticsearch-service.bat" manager) i wybierz wersję, ustawiając ścieżkę dla maszyny wirtualnej Java.

Dostępność funkcji

• Wyszukiwanie elementów roboczych jest dostępne w programie Team Foundation Server (TFS) 2018 i nowszych wersjach.
• Wyszukiwanie w witrynie typu wiki jest dostępne w programie TFS 2018 Update 2 i nowszych wersjach.
• Wyszukiwanie elementów roboczych i stron typu wiki to wbudowane rozszerzenia, które są instalowane domyślnie podczas konfigurowania wyszukiwania.
• Wyszukiwanie kodu jest dostępne w programie TFS 2018 i nowszych wersjach oraz jest funkcją opt-in. Możesz zainstalować wyszukiwanie kodu później z poziomu galerii lokalnej. Przejdź do galerii lokalnej (http://{server}/_gallery) jako administrator. Użytkownicy niebędący administratorami mogą również zażądać rozszerzenia dla usługi Azure DevOps Server. Aby uzyskać więcej informacji, zobacz Instalowanie rozszerzenia.

Konfigurowanie wyszukiwania

Skonfiguruj usługa wyszukiwania przy użyciu dedykowanych stron w Kreatorze konfiguracji serwera podczas instalowania serwera Usługi Azure DevOps Server. Możesz również nie skonfigurować wyszukiwania później, uruchamiając Ponownie Kreatora konfiguracji serwera lub uruchamiając Kreatora konfiguracji wyszukiwania.

Zagadnienia dotyczące konfiguracji

Podczas konfigurowania wyszukiwania należy wziąć pod uwagę następujące informacje:

• Wyszukiwanie elementów roboczych i stron typu wiki jest domyślnie włączone po skonfigurowaniu wyszukiwania. Te rozszerzenia można później usunąć w razie potrzeby ze strony Zarządzanie rozszerzeniami serwera Azure DevOps Server.
• Rozszerzenie wyszukiwania kodu musi być zainstalowane dla każdej kolekcji usługi Azure DevOps Server, w której ma być używana. Podczas początkowego konfigurowania wyszukiwania można ustawić pole wyboru Automatycznie zainstaluj rozszerzenie wyszukiwania kodu dla istniejących i nowych kolekcji projektów w celu zautomatyzowania tego procesu.
• Jeśli nie ustawisz pola wyboru, aby zainstalować rozszerzenie wyszukiwania kodu dla wszystkich kolekcji projektów, pcA może zainstalować je z galerii lokalnej. Upewnij się, że przejdź do galerii lokalnej (http://{Server}/_gallery) ze strony portalu usługi Azure DevOps Server. Aby uzyskać więcej informacji, zobacz Instalowanie rozszerzenia.
• Indeksowanie kolekcji zwykle trwa mniej niż jedną godzinę. Jednak może upłynąć do 12 godzin na podstawie rozmiaru i liczby plików kodu, elementów roboczych lub stron typu wiki. Jeśli po tym okresie nie otrzymasz żadnych wyników, sprawdź stan indeksowania.

Używanie drugiego dysku twardego i serwera zdalnego

• Aby uzyskać maksymalną wydajność, folder indeksu wyszukiwania powinien znajdować się na oddzielnym szybkim dysku twardym i wspieranym przez szybki magazyn, taki jak dysk półprzewodnikowy (SSD) lub sieć SAN( Storage Area Network). Przydziel do 150% rozmiaru wszystkich repozytoriów do indeksowania, co jest najgorszym scenariuszem. Rzeczywiste użyte miejsce zależy od ilości i typu plików kodu oraz liczby elementów roboczych i stron typu wiki w tej kolekcji.
  • O ile nie określono, usługa indeksowania i aparat Elasticsearch używają konta usługi sieciowej podczas instalacji do tworzenia i uzyskiwania dostępu do plików indeksu. Jeśli wybierzesz inne konto, musi mieć uprawnienie Zaloguj się jako usługa .
  • Ogranicz uprawnienia dysku indeksu i folderu, aby chronić indeks przed przypadkowymi lub złośliwymi modyfikacjami lub usunięciem. Skonfiguruj odpowiednie ustawienia zabezpieczeń dla usługi.
• Podczas konfigurowania funkcji Wyszukaj serwer z wieloma sieciami AT należy zainstalować na osobnym serwerze. Po zainstalowaniu funkcji Wyszukiwania na serwerze zdalnym użyj Kreatora konfiguracji na dowolnym serwerze usługi AT, aby połączyć zdalne wystąpienie wyszukiwania z wystąpieniem usługi Azure DevOps Server. W przypadku nieskonfiguracji wyszukiwania należy użyć Kreatora konfiguracji na tym samym serwerze AT, na którym pierwotnie przeprowadzono konfigurację.

Uaktualnianie serwera

• Jeśli przeprowadzasz uaktualnienie przedprodukcyjne na serwerze, na którym usługa Search została już skonfigurowana, musisz ponownie skonfigurować usługę Search, aby uniknąć uszkodzenia wystąpienia produkcyjnego. Nie ma możliwości skonfigurowania funkcji Wyszukiwania w ramach uaktualnienia przedprodukcyjnego. Zamiast tego skonfiguruj ją po zakończeniu uaktualniania przedprodukcyjnego. Możesz usunąć zaznaczenie pola wyboru Automatycznie zainstaluj i skonfiguruj wyszukiwanie kodu dla wszystkich istniejących i nowych kolekcji podczas konfiguracji. Zamiast tego zainstaluj rozszerzenie Wyszukiwania tylko dla jednej lub dwóch kolekcji po zakończeniu konfiguracji
• Jeśli przeprowadzasz uaktualnienie produkcyjne na serwerze, na którym jest skonfigurowane wyszukiwanie i chcesz je zachować, zaznacz pole wyboru obok pozycji Zainstaluj i skonfiguruj wyszukiwanie. Kreator wykrywa istniejące wystąpienie wyszukiwania i automatycznie wybiera pozycję Użyj istniejącego wystąpienia wyszukiwania i wstępnie wypełnia bieżący adres URL usługa wyszukiwania. Użyj opcji Zainstaluj nowe wystąpienie wyszukiwania tylko wtedy, gdy chcesz skonfigurować nowe wystąpienie usługi Search na tym samym serwerze. Skonfigurowanie nowego wystąpienia powoduje ponowne indeksowanie całego kodu, elementów roboczych i witryny typu wiki, co — w zależności od rozmiaru kolekcji — może zająć trochę czasu. Podczas indeksowania użytkownicy mogą zobaczyć częściowe wyniki wyszukiwania
• Jeśli uaktualniasz serwer do nowego sprzętu, masz następujące dwie opcje. Wybierz z tych opcji, w zależności od tego, jak funkcja Wyszukiwania została wcześniej skonfigurowana:
  • Jeśli usługa Search znajduje się na osobnym serwerze z usługi Azure DevOps Server, musisz wybrać pozycję Zainstaluj i skonfiguruj wyszukiwanie w Kreatorze konfiguracji serwera, a następnie wybrać pozycję Użyj istniejącego wystąpienia wyszukiwania i podać adres URL istniejącego wystąpienia wyszukiwania, aby ukończyć konfigurację wyszukiwania
  • Jeśli usługa Search jest skonfigurowana obok wystąpienia usługi Azure DevOps Server na starym serwerze, musisz wybrać pozycję Zainstaluj i skonfiguruj wyszukiwanie w Kreatorze konfiguracji serwera. Następnie wybierz ponownie pozycję Zainstaluj nowe wystąpienie wyszukiwania na nowym serwerze, jeśli chcesz kontynuować współhost Search i Azure DevOps Server. Wszystkie indeksy wyszukiwania dla wszystkich kolekcji są tworzone ponownie, co w zależności od rozmiaru każdej kolekcji może zająć trochę czasu
• Jeśli odłączasz kolekcję od jednego wystąpienia usługi Azure DevOps Server w celu dołączenia go do innego wystąpienia, wykonaj następujące czynności:
  1. Odłączanie kolekcji od źródłowego wystąpienia usługi Azure DevOps Server
  2. Konfigurowanie wyszukiwania w docelowym wystąpieniu usługi Azure DevOps Server (jeśli jeszcze nie zostało to zrobione)
  3. Dołączanie kolekcji do docelowego serwera Azure DevOps Server
  4. Odinstaluj rozszerzenia wyszukiwania, takie jak Kod, Element roboczy lub Wiki dla kolekcji z galerii lokalnej na serwerze Azure DevOps Server
  5. Zainstaluj rozszerzenie Search dla kolekcji z galerii lokalnej, przechodząc do niej z docelowego wystąpienia usługi Azure DevOps Server

Instalowanie lub aktualizowanie wyszukiwania na osobnym serwerze

Aby zainstalować lub zaktualizować wyszukiwanie na osobnym lub zdalnym serwerze, zazwyczaj gdy istnieje więcej niż 250 użytkowników, wykonaj następujące czynności:

1. Podczas instalowania serwera Azure DevOps Server na serwerze podstawowym ustaw pole wyboru Zainstaluj i skonfiguruj wyszukiwanie . na stronie Wyszukiwanie Kreatora konfiguracji serwera.
2. Wybierz opcję Użyj istniejącej usługa wyszukiwania.
3. Użyj linku usługa wyszukiwania pakietu podanego w kreatorze, aby uzyskać dostęp do zestawu plików instalatora wyszukiwania na komputerze lokalnym. Następnie skopiuj te pliki do serwera zdalnego.
4. Postępuj zgodnie z instrukcjami w pliku Readme.txt znajdującym się w zestawie plików instalatora, aby zainstalować lub zaktualizować usługa wyszukiwania na serwerze zdalnym.
5. Po zakończeniu instalacji skopiuj wynikowy adres URL serwera wyszukiwania do pola Adres URL wyszukiwania kreatora konfiguracji uruchomionego w wystąpieniu usługi Azure DevOps Server.
6. Po zakończeniu obu instalacji skonfiguruj odpowiednie ustawienia zabezpieczeń dla obu serwerów.

Bezpieczne wyszukiwanie

W usługa wyszukiwania jest używana zmodyfikowana wersja programu Elasticsearch. Terminy "Search" i "Elasticsearch" są używane zamiennie w pozostałej części tej sekcji. Administracja istratory muszą podać poświadczenia, czy usługa wyszukiwania znajduje się na tej samej maszynie co usługa Azure DevOps Server, czy na osobnej maszynie. Ta akcja jest częścią konfigurowania funkcji wyszukiwania za pośrednictwem serwera lub kreatora konfiguracji wyszukiwania. Te poświadczenia są nowe i nie są powiązane z żadnymi wcześniej istniejącymi poświadczeniami konta ani serwera. Są one używane do konfigurowania i nawiązywania połączenia z usługa wyszukiwania. Te nowe zestawy poświadczeń umożliwiają uwierzytelnianie podstawowe w usłudze wyszukiwania.

W przypadku uaktualnienia z wersji TFS 2018 Update 1.1 do TFS 2018 Update 3 lub ponownej konfiguracji wyszukiwania tylko informacje o użytkowniku są wypełniane automatycznie, a administratorzy muszą podać poświadczenia hasła. Administracja istratorzy mogą podać inną nazwę użytkownika i hasło, jeśli chcesz. Jeśli usługa wyszukiwania znajduje się na tej samej maszynie co usługa Azure DevOps Server, administratorzy mogą podać nowy zestaw poświadczeń w Kreatorze konfiguracji, aby skonfigurować usługa wyszukiwania, jeśli chcesz. Jeśli jednak usługa wyszukiwania znajduje się na komputerze zdalnym, administratorzy muszą najpierw podać nowe poświadczenia skryptowi konfiguracji usługa wyszukiwania.

Uwaga

• Wartości nazwy użytkownika i hasła powinny mieć długość od 8 do 64 znaków. Chociaż hasło można przypisać dowolną wartość, nazwa użytkownika może zawierać tylko znaki alfanumeryczne i podkreślenia.
• Poświadczenia wyszukiwania uwierzytelniają tylko użytkowników i upewnij się, że nieuwierzytelniony użytkownicy nie mogą uzyskać dostępu do punktu końcowego usługi Elasticsearch. Jednak usługa Elasticsearch nie obsługuje protokołu HTTPS i dlatego te poświadczenia są wysyłane za pośrednictwem sieci jako ciągi zakodowane w formacie Base64. Jeśli istnieje możliwość pośredniego dostępu do żądania, skonfiguruj odpowiednie ustawienia zabezpieczeń na podstawie firmowych wymagań dotyczących zabezpieczeń i zgodności.
• Należy ograniczyć dostęp zarówno do wyszukiwania, jak i indeksowania określonych użytkowników lub grup użytkowników przy użyciu szyfrowania za pośrednictwem protokołu IPSec, opisanych w następujący sposób.

Rozważ następujące techniki używania protokołu IPSec do zabezpieczania usługi Elasticsearch na serwerze z systemem Windows:

• Konfigurowanie zabezpieczeń tylko przy użyciu uwierzytelniania:

  • Gwarantuje, że tylko autoryzowani użytkownicy będą mogli uzyskać dostęp do portu elasticsearch. Wymaga tylko reguł po stronie usługi (reguły zapory tylko na serwerze z uruchomionym usługą Elasticsearch)
  • Wymaganie wstępne: serwer Azure DevOps Server musi być skonfigurowany przy użyciu konta domeny
  • Wykonaj kroki opisane w temacie Tworzenie reguł zapory, które zezwalają na ruch sieciowy chroniony przez protokół IPsec

• Konfigurowanie zabezpieczeń przy użyciu uwierzytelniania, ochrony integralności i szyfrowania:

  • Gwarantuje, że szyfrowanie i ochrona integralności są stosowane wraz z uwierzytelnianiem. Wymaga zarówno reguł po stronie klienta, jak i po stronie usługi (reguły zapory na serwerze z uruchomionym usługą Elasticsearch i wszystkimi serwerami warstwy aplikacji serwera Usługi Azure DevOps)
  • Wymaganie wstępne: serwer Azure DevOps Server musi być skonfigurowany przy użyciu konta domeny
  • Wykonaj kroki opisane w temacie Izolowanie serwera przez wymaganie szyfrowania i członkostwa w grupie

Wyszukiwanie uaktualniania

• TFS 2018 Update 2: zawiera zaktualizowane składniki wyszukiwania i wyszukiwanie w witrynie typu wiki.

  • Jeśli usługa wyszukiwania został skonfigurowany podczas uaktualniania 2018 RTM i skonfigurowany w uaktualnianych systemach TFS, jego składniki są aktualizowane automatycznie.
  • Jeśli usługa Search została skonfigurowana na serwerze zdalnym, zobacz Instalowanie lub aktualizowanie wyszukiwania na osobnym serwerze , aby go zaktualizować.

  W obu przypadkach cała istniejąca zawartość (pliki kodu i elementy robocze) jest automatycznie ponownie indeksowana w celu obsługi zaktualizowanych składników po konfiguracji. W zależności od ilości zawartości uaktualnienie może zająć trochę czasu.

• TFS 2018 Update 1.1 i TFS 2018 Update 3: obejmuje uwierzytelnianie podstawowe dla komunikacji między serwerem TFS i usługa wyszukiwania, aby zwiększyć bezpieczeństwo. Każda instalacja lub uaktualnienie do wersji TFS 2018 Update 1.1 lub TFS 2018 Update 3 musi podać poświadczenia w ramach konfigurowania funkcji wyszukiwania za pośrednictwem serwera lub kreatora konfiguracji wyszukiwania.

• TFS 2018 Update 2 (lub nowsza) do wersji azure DevOps Server 2019 Update 1: Po skonfigurowaniu wyszukiwania na osobnym serwerze wymaga ponownej instalacji wyszukiwania. Wykonując instrukcje uaktualniania, w kroku 4 zamiast aktualizowania Configure-TFSSearch.ps1 – Operation updateuruchom następujące polecenie, aby ponownie zainstalować wyszukiwanie.

Configure-TFSSearch.ps1 -Operation remove
Configure-TFSSearch.ps1 -Operation install -TFSSearchInstallPath <install location> -TFSSearchIndexPath $env:SEARCH_ES_INDEX_PATH

Odinstalowywanie wyszukiwania

W przypadku uaktualnienia przedprodukcyjnego, uaktualnienia produkcyjnego, nowej migracji sprzętu, klonowania lub innej operacji konserwacji Kreator konfiguracji serwera nie konfiguruje wyszukiwania. Jednak po zakończeniu operacji konserwacji serwera można łatwo przeprowadzić ponowną konfigurację.

Mogą wystąpić przypadki, w których nie chcesz już używać funkcji Wyszukaj lub chcesz przeprowadzić nową i czystą instalację. Ta operacja wymaga wielu kroków, w zależności od tego, czy usługa Search jest skonfigurowana na tym samym serwerze co serwer Usługi Azure DevOps, czy na osobnym serwerze.

Nieskonfigurowane wyszukiwanie na maszynie skonfigurowanej jako serwer Usługi Azure DevOps

1. Odinstaluj rozszerzenie Wyszukiwania dla każdej kolekcji. Przejdź do strony Zarządzanie rozszerzeniami każdej kolekcji w wystąpieniu usługi Azure DevOps Server:

   

2. Usuń funkcję wyszukiwania:

   1. Otwórz konsolę Administracja istration serwera Azure DevOps Server.
   2. Wybierz nazwę serwera.
   3. Wybierz pozycję Usuń funkcję.
   4. Wybierz pozycję usługa wyszukiwania, a następnie wybierz pozycję Usuń.

3. Usuń usługę Elasticsearch:

   1. Otwórz wiersz polecenia jako administrator.
   2. Zmień katalog , cd "C:\Program Files\Microsoft Team Foundation Server 15.0\Search\ES\elasticsearch-5.4.1\bin".
   3. Usuń usługę , "elasticsearch-service.bat remove".

4. Usuń dane wyszukiwania:

   • Usuń zawartość lokalizacji opisanej przez zmienną środowiskową SEARCH_ES_INDEX_PATH.

5. Usuń zmienną środowiskową , "SEARCH_ES_INDEX_PATH".

Nieskonfigurowane wyszukiwanie na osobnym serwerze

Wykonaj następujące kroki, aby nie skonfigurować wyszukiwania, takiego jak kod, element roboczy lub witryna typu wiki dla każdej kolekcji.

1. Przejdź do strony Zarządzanie rozszerzeniami dla każdej kolekcji w wystąpieniu usługi Azure DevOps Server.

   

2. Usuń funkcję wyszukiwania:

   1. Otwórz okno dialogowe Usuwanie funkcji, Administracja istration Console.
   2. W okienku po lewej stronie wybierz nazwę serwera Usługi Azure DevOps.
   3. W okienku po prawej stronie wybierz pozycję Usuń funkcję.
   4. W oknie dialogowym Usuwanie funkcji wybierz pozycję usługa wyszukiwania, a następnie wybierz pozycję Usuń.

3. Usuń usługę Elasticsearch i dane.

   1. Otwórz program PowerShell jako administrator.
   2. Otwórz folder Configure Search.ps1 wraz z pozostałymi plikami wymaganymi do zdalnej instalacji usługi Search.
   3. Uruchom ponownie skrypt z opcją usuwania: "ConfigureTFSSearch.ps1 -remove".

Ograniczenia wyszukiwania

Wyszukiwanie usługi Azure DevOps Server ma następujące ograniczenie:

• Ponownie zaindeksuj wszystkie kolekcje , jeśli wykonasz operację odzyskiwania po awarii i przenieś serwer z powrotem do wcześniejszej migawki bazy danych SQL.
• Wyszukiwanie nie jest rozszerzalne, ale możesz przesłać nowe żądanie funkcji w społeczności deweloperów.

Powiązane artykuły

• Zarządzanie indeksowaniem wyszukiwania
• Wprowadzenie do wyszukiwania