Arama'yı yükleme ve yapılandırma
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018
Azure DevOps Server'da Kod, Wiki ve İş öğesi aramaları için Arama uzantısı için aşağıdaki eylemlerin nasıl yapılacağını öğrenin.
Arama dizinini yönetme hakkında bilgi için bkz. Arama ve dizin oluşturmayı yönetme.
Önkoşullar
- Arama uzantısını yüklemek için kuruluş için Proje Koleksiyonu Yöneticisi (PCA) olmanız gerekir. Yönetici olmayan kullanıcılar da uzantının PCA'larına eklenmesini isteyebilir.
- Bkz. Azure DevOps Server yükleme ve yapılandırma ve Gereksinimler ve uyumluluk.
Donanım önerileri
Arama özelliğini Azure DevOps Server çalıştıran herhangi bir boyuttaki fiziksel sunucuda veya sanal makinede kullanabilirsiniz. Bunu aynı sunucuda veya Arama'ya ayrılmış ayrı bir sunucuda yapılandırabilirsiniz. Arama'yı aynı sunucuda yapılandırırken, Azure DevOps Server nedeniyle mevcut CPU kullanım faktörünü göz önünde bulundurun.
İpucu
Üretim ortamları için Ayrı bir sunucuda Arama'yı yapılandırmanızı öneririz.
Çok kullanıcılı senaryolarda kabul edilebilir performans için aşağıdaki önerileri göz önünde bulundurun:
- Sunucuda arama bulunan 250'den az kullanıcı (genellikle gösterim ve deneme amacıyla kullanılır):
- Dört çekirdekli işlemci, 16 GB (minimum) RAM
- CPU Kullanımı faktörü %50'den az
- Katı Hal Sürücüsü (SSD) depolama destekli hızlı sabit sürücü
- Arama ayrı bir sunucuda bulunan 500'den az kullanıcı:
- Çift çekirdekli işlemci, 8 GB (minimum) RAM
- Katı Hal Sürücüsü (SSD) depolama destekli hızlı sabit sürücü
- Arama ayrı bir sunucuda bulunan 1.000'den az kullanıcı:
- Dört çekirdekli işlemci, 16 GB (minimum) RAM
- Katı Hal Sürücüsü (SSD) depolama destekli hızlı sabit sürücü
- Arama ayrı bir sunucuda bulunan 1.000'den fazla kullanıcı:
- Dört çekirdekli işlemci, 16 GB (minimum) RAM
- Katı Hal Sürücüsü (SSD) veya Depolama Alanı Ağı (SAN) depolaması tarafından yedeklenen hızlı sabit sürücü
- Birden Çok AT ile Azure DevOps Server:
- Arama'yı ayrı bir sunucuya yükleme
- Arama yüklemesinden önce %50'den fazla CPU kullanımı Azure DevOps Server:
- Arama'yı ayrı bir sunucuya yükleme
Disk alanı gereksinimi:
Arama tarafından kullanılan disk alanı miktarı temel olarak dizine alınan dosyaların türüne ve boyutuna bağlıdır. Kod araması için depolar birçok kez büyük olabileceğinden ve sürüm denetiminde farklı kod dosyalarına sahip olabileceğinden disk alanı gereksinimi önemli olabilir. Dizine eklenecek tüm depoların boyutunun %150'sine kadar ayırın. TFS 2018 Güncelleştirme 3 ve sonrasında kullanıcılar, arama tarafından kullanılan disk alanını iyileştirmek için klasörleri dizin depolarından hariç tutabilir.
Yazılım bağımlılıkları
Arama, yapılandırmanın bir parçası olarak otomatik olarak yüklenen aşağıdaki bağımlılıklara sahiptir:
- Elasticsearch BV tarafından elasticsearch (bkz. Not 1 ve 2)
- Elasticsearch NEST istemcisi
- Azul Zulu OpenJDK (bkz . Java yükleme notları)
- Topten Software tarafından markdowndeep
- Roslyn derleyici platformu
- ANTLR dil tanıma ayrıştırıcısı
Not
- Arama, Elasticsearch'in değiştirilmiş bir sürümünü kullanır. Yalnızca bu değiştirilmiş sürümle çalışır
- Elasticsearch'in daha yeni bir sürümü TFS 2018 Güncelleştirme 2 ve ileri ve Azure DevOps Server ile birlikte geliyor. Arama sonuçlarının eski bir sürümünden yükseltme yaptığınızda yüklemeden sonra tüm içerik yeniden dizine eklenir. İçerik hacmine (kod dosyaları, iş öğeleri ve wiki sayfaları) bağlı olarak, yeniden dizin oluşturma işleminin tamamlanması biraz zaman alabilir
- Sistem veya sunucu yöneticisi, Sunucu JRE'sinin, yazılım sağlayıcısının önerilerine uygun olarak korunup güncelleştirildiğinden emin olmalıdır. Ayrıca aşağıdaki Java yükleme notlarını da görebilirsiniz
- Azul Zulu OpenJDK güncelleştirmeleri otomatik olarak yüklemez
- Güncelleştirmeleri düzenli olarak denetlediğinizden emin olun
Java yükleme notları
- Arama yapılandırma sihirbazı java çalışma zamanı ortamının (JRE) çalışan yüklemesini algılamazsa desteklenen en son sürümü indirme ve yükleme seçeneği sağlar. İndirmek için İnternet bağlantısı gereklidir. Hedef sunucunun İnternet bağlantısı yoksa, Arama'yı yüklemeyi denemeden önce el ile bir JRE indirip yüklemeniz gerekir.
- Azure DevOps Server önceki Arama sürümleri Oracle Server Java Çalışma Zamanı Ortamı'nı kullanıyordu. Azure DevOps Server'de varsayılan JRE, Azul Zulu OpenJDK'dır.
- Yükleme sırasında sihirbaz , JAVA_HOME ortam değişkenini JRE yükleme klasörüne işaret etmek üzere ayarlar. Yapılandırma sihirbazı, doğru yapılandırılmadıysa veya JAVA_HOME ayarı Arama'nın gerektirdiğinden daha eski bir sürüme işaret ederse var olan bir JRE yüklemesini algılamayabilir.
Not
Kaynakların paylaşıldığı bir makineye, özellikle birden çok uygulama katmanına sahip büyük bir kurumsal ortama Elasticsearch yüklemenizi önermeyiz. Bunun yerine Elasticsearch'i ayrı bir ayrılmış makinede ayarlamanızı öneririz. Bu şekilde JAVA ortamı başka amaçlarla makineler arasında paylaşılmamalıdır.
Bir JRE'nin Search için gereken minimumdan önceki bir sürümü varsa ve JAVA_HOME değişkeni bu sürüme ayarlandıysa, Arama'yı ayrı bir sunucuya yüklemenizi öneririz. JAVA_HOME değişkeninin değerini değiştirirseniz, yüklü diğer yazılımların başarısız olmasına neden olabilir.
Sunucu JRE'sinin Search için gereken en düşük sürüme eşit veya ondan sonraki bir sürümü varsa ve yapılandırma sihirbazı tarafından tanınmıyorsa , JAVA_HOME değişkeninin değerini bu sürüme ayarlayın. Bu eylem JRE yükleme kılavuzunda açıklanmıştır. Ardından yapılandırma sihirbazını yeniden çalıştırın.
Diğer bağımlılıklar nedeniyle Arama'nın gerektirdiği Java sürümünü yükleyemiyorsanız, aşağıdaki görevleri gerçekleştirebilirsiniz:
- Java yüklü olmayan bir sunucuya Search uzantısıyla Azure DevOps Server yükleyin. Bu eylemi 250'den fazla kullanıcı veya %50'den fazla CPU kullanımı veya birden çok AT için önermiyoruz)
- Arama ve JRE'yi Azure DevOps Server ayrı bir sunucuya yükleme
Not
TFS'de Arama için varsayılan olan Oracle Server JRE 8 kullanıyorsanız (Azure DevOps Server Oracle Server JRE 8 kullanmaz), aşağıdaki bilgileri unutmayın:
- Arama, Server JRE 8'in ticari özelliklerinin hiçbirini kullanmaz veya desteklemez. Bu nedenle, Arama yapılandırması sırasında, Sunucu JRE'nin ticari özellikleri ne etkinleştirilir ne de kilidi açılır
- Oracle JRE ile devam etmeyi seçerseniz, JRE güncelleştirmelerini almaya devam edebilmeniz için Java SE Aboneliği için Oracle ile iletişime geçin
Oracle Server JRE'den Zulu OpenJDK'ye geçiş
Azure DevOps Server'de arama, hem Azul Zulu OpenJDK hem de Oracle JRE'yi destekleyerek ihtiyaçlarınıza göre bunlar arasında seçim yapmanızı sağlar. Yükleme sırasında bir JRE seçerken, Azure DevOps Server varsayılan olarak Azul Zulu OpenJDK 8 olarak ayarlanır.
Azul Zulu OpenJDK olarak değiştirmek için şu adımları izleyin:
Daha fazla bilgi için bkz. GitHub Code-Search Java Geçişi.
Not
- Azul Zulu OpenJDK kullanmayı seçerseniz sürüm 8'i indirdiğinizden emin olun.
Özellik kullanılabilirliği
- İş Öğesi Arama, TFS 2017 Güncelleştirme 2 ve sonraki sürümlerde kullanılabilir.
- Wiki Araması, TFS 2018 Güncelleştirme 2 ve sonraki sürümlerde kullanılabilir.
- İş Öğesi ve Wiki araması, Arama yapılandırması sırasında varsayılan olarak yüklenen yerleşik uzantılardır.
- Kod Arama, TFS 2017 ve sonraki sürümlerde kullanılabilir ve bir kabul etme özelliğidir. Kod Arama'yı daha sonra Yerel Galeri'den yükleyebilirsiniz. Yönetici olarak Yerel Galeri'ye (
http://{server}/_gallery) gidin. Yönetici olmayan kullanıcılar da Azure DevOps Server için uzantı isteyebilir. Daha fazla bilgi için Yerel galeri belgelerindeki Uzantı yükleme bölümüne bakın.
Aramayı Yapılandır
Azure DevOps Server yüklerken Sunucu Yapılandırma Sihirbazı'ndaki ayrılmış sayfaları kullanarak Arama hizmeti yapılandırın. Daha sonra, Sunucu Yapılandırma Sihirbazı'nı yeniden çalıştırarak veya Arama Yapılandırma Sihirbazı'nı başlatarak Arama'yı yapılandırmayı kaldırabilirsiniz. Arama'yı yapılandırmak için yapılandırmayla ilgili dikkat edilmesi gereken noktalara dikkat edin.
Yapılandırmayla ilgili dikkat edilmesi gerekenler
Arama'yı yapılandırırken aşağıdaki bilgileri göz önünde bulundurun:
Arama yapılandırıldığında hem İş Öğesi hem de Wiki araması varsayılan olarak etkinleştirilir. Gerekirse bu uzantılar daha sonra Azure DevOps Server Uzantıları Yönet sayfasından kaldırılabilir
Kod Arama uzantısını kullanmak istediğiniz her Azure DevOps Server koleksiyonu için yüklenmelidir. Arama'yı ilk kez yapılandırırken, bu işlemi otomatikleştirmek için mevcut ve yeni Proje Koleksiyonları için Kod Arama uzantısını otomatik olarak yükle onay kutusunu ayarlayabilirsiniz
- Tüm proje koleksiyonlarınız için Kod Arama uzantısını yükleyecek onay kutusunu ayarlamazsanız, PCA'nız yerel galeriden yükleyebilir. Azure DevOps Server portalı sayfanızdan Yerel Galeriye (
http://{Server}/_gallery) gittiğinizden emin olun. Daha fazla bilgi için Yerel galeri belgelerinde Uzantı yükleme bölümüne bakın
- Tüm proje koleksiyonlarınız için Kod Arama uzantısını yükleyecek onay kutusunu ayarlamazsanız, PCA'nız yerel galeriden yükleyebilir. Azure DevOps Server portalı sayfanızdan Yerel Galeriye (
İkinci bir sabit sürücü ve uzak sunucu kullanma
En yüksek performans için, arama dizini klasörü ayrı bir hızlı sabit sürücüde olmalı ve katı hal sürücüsü (SSD) veya Depolama Alanı Ağı (SAN) gibi hızlı depolama ile yedeklenmelidir. Dizine eklenecek tüm depoların boyutunun %150'sine kadar ayırın. En kötü senaryo bu. Tüketilen gerçek alan, kod dosyalarının miktarına ve türüne ve bu koleksiyondaki iş öğelerinin ve wiki sayfalarının sayısına bağlıdır
- Belirtilmediği sürece, dizin oluşturma hizmeti ve Elasticsearch altyapısı, dizin dosyalarını oluşturmak ve erişmek için yükleme sırasında ağ hizmeti hesabını kullanır. Farklı bir hesap seçerseniz hizmet olarak oturum açma izni olmalıdır
- Dizini yanlışlıkla veya kötü amaçlı değişiklik veya silmeye karşı korumak için dizin diskinin ve klasörün izinlerini kısıtlayın. Hizmet için uygun güvenlik ayarlarını yapılandırma
Birden çok uygulama katmanına (AT) sahip bir sunucuyu ara'yı yapılandırırken, ayrı bir sunucuya yüklendiğinden emin olun. Uzak sunucuya Ara'yı yükledikten sonra, uzak Arama örneğini Azure DevOps Server örneğine bağlamak için AT sunucularından herhangi birinde Yapılandırma Sihirbazı'nı kullanın. Gelecekte Arama'yı yapılandırmayı kaldırdığınızda yapılandırmanın ilk gerçekleştirildiği AT sunucusunda Yapılandırma Sihirbazı'nı kullanmanız gerekir
Sunucunuzu yükseltme
Arama'nın zaten yapılandırılmış olduğu bir sunucuda üretim öncesi yükseltme yapıyorsanız, üretim örneğinizin bozulmasını önlemek için Arama'yı yeniden yeniden yapılandırmanız gerekir. Arama'yı üretim öncesi yükseltmenin bir parçası olarak yapılandırma seçeneği yoktur. Bunun yerine, üretim öncesi yükseltme tamamlandıktan sonra yapılandırın. Yapılandırma sırasında tüm mevcut ve yeni koleksiyonlar için Kod Arama'yı otomatik olarak yükle ve yapılandır seçeneğinin işaretini kaldırabilirsiniz. Bunun yerine, yapılandırma tamamlandıktan sonra koleksiyonlarınızdan yalnızca biri veya ikisi için Arama uzantısını yükleyin
Arama'nın yapılandırıldığı bir sunucuda üretim yükseltmesi yapıyorsanız ve bunu korumak istiyorsanız, Aramayı Yükle ve Yapılandır'ın yanındaki kutuyu işaretleyin. Sihirbaz mevcut Arama örneğinizi algılar ve Otomatik olarak Var olan Arama örneğini kullan'ı seçer ve geçerli Arama hizmeti URL'nizi önceden doldurur. Yeni Bir Arama örneği yükle seçeneğini yalnızca aynı sunucuda yeni bir Arama örneği ayarlamak istiyorsanız kullanın. Yeni bir örnek ayarlamak tüm kodunuzun, iş öğelerinizin ve wiki'nizin yeniden dizine alınmasına neden olur ve koleksiyonların boyutuna bağlı olarak biraz zaman alabilir. Dizin oluşturma sırasında kullanıcılar kısmi arama sonuçları görebilir
Sunucunuzu yeni donanıma yükseltiyorsanız, aşağıdaki iki seçeneğiniz vardır. Arama'nın daha önce nasıl yapılandırıldığına bağlı olarak bu seçeneklerden birini belirleyin:
- Arama, Azure DevOps Server ayrı bir sunucudaysa, Sunucu Yapılandırma Sihirbazı'nda Yükle ve Aramayı Yapılandır'ı seçip Var olan bir Arama örneğini kullan'ı seçmeniz ve Arama yapılandırmasını tamamlamak için mevcut Arama örneğinizin URL'sini sağlamanız gerekir
- Arama, eski sunucudaki Azure DevOps Server örneğinizle birlikte yapılandırıldıysa, Sunucu Yapılandırma Sihirbazı'nda Yüklemeyi ve Aramayı Yapılandır'ı seçmeniz gerekir. Ardından, Search'ü birlikte barındırmaya devam etmek ve Azure DevOps Server devam etmek istiyorsanız Yeni sunucuya yeni bir Arama örneği yükle'yi seçin. Tüm koleksiyonlar için tüm Arama dizinleri yeniden oluşturulur ve her koleksiyonun boyutuna bağlı olarak biraz zaman alabilir
Bir koleksiyonu başka bir örneğe eklemek için bir Azure DevOps Server örneğinden ayırıyorsanız aşağıdaki adımları uygulayın:
- Koleksiyonu kaynak Azure DevOps Server örneğinden ayırma
- Hedef Azure DevOps Server örneğinde Arama'yı yapılandırma (henüz yapmadıysanız)
- Koleksiyonu hedef Azure DevOps Server ekleme
- Koleksiyon için Kod, İş öğesi veya Wiki gibi Arama uzantılarınızı Azure DevOps Server yerel galeriden kaldırın
- Hedef Azure DevOps Server örneğinden göz atarak Yerel Galeri'den koleksiyon için Arama uzantısını yükleyin
Arama'yı ayrı bir sunucuya yükleme veya güncelleştirme
Genellikle 250'den fazla kullanıcı olduğunda Arama'yı ayrı veya uzak bir sunucuya yüklemek veya güncelleştirmek için aşağıdaki adımları uygulayın:
Azure DevOps Server birincil sunucuya yüklerken, Sunucu Yapılandırma Sihirbazı'nın Arama sayfasında Arama'yı yükle ve yapılandır onay kutusunu ayarlayın.
Var olan bir Arama hizmeti kullan seçeneğini belirleyin.
Yerel makinedeki arama yükleyicisi dosyaları kümesine erişmek için sihirbazda sağlanan Arama hizmeti paketi bağlantısını kullanın. Ardından bu dosyaları uzak sunucuya kopyalayın.
Arama hizmeti uzak sunucuya yüklemek veya güncelleştirmek için, yükleyici dosyaları kümesinde bulunanReadme.txtdosyasındaki yönergeleri izleyin.
Yükleme tamamlandıktan sonra, sonuçta elde edilen Arama sunucusu URL'sini Azure DevOps Server örneğinde çalışan yapılandırma sihirbazının Arama URL'si alanına kopyalayın.
Her iki yükleme de tamamlandığında, her iki sunucu için de uygun güvenlik ayarlarını yapılandırın.
Güvenli arama
Arama hizmeti Elasticsearch'in değiştirilmiş bir sürümünü kullanır (bu bölümün geri kalanında "Arama" ve "Elasticsearch" terimleri birbirinin yerine kullanılır). yöneticilerin, Arama hizmeti Azure DevOps Server ile aynı makinede veya ayrı bir makinede olması fark etmeksizin kimlik bilgilerini sağlaması gerekir. Bu eylem, Arama özelliğini sunucu veya Arama yapılandırma sihirbazı aracılığıyla yapılandırmanın bir parçasıdır. Bu kimlik bilgileri yenidir ve önceden var olan hesap veya sunucu kimlik bilgileriyle ilgili değildir. Arama hizmeti ayarlamak ve bağlanmak için kullanılırlar. Bu yeni kimlik bilgileri kümeleri, arama hizmetinde temel kimlik doğrulamasını etkinleştirir.
TFS 2018 Güncelleştirme 1.1'den TFS 2018 Güncelleştirme 3'e yükseltme veya arama yeniden yapılandırması için, yalnızca kullanıcı bilgilerinin otomatik doldurulması ve yöneticilerin parola kimlik bilgilerini sağlaması gerekir. Yöneticiler isterlerse farklı bir kullanıcı adı ve parola sağlama seçeneğine sahiptir. Arama hizmeti Azure DevOps Server ile aynı makinedeyse, yöneticiler gerekirse Arama hizmeti ayarlamak için Yapılandırma Sihirbazı'nda yeni bir kimlik bilgileri kümesi sağlayabilir. Ancak, Arama hizmeti uzak bir makinedeyse, yöneticilerin önce Arama hizmeti kurulum betiğine yeni kimlik bilgilerini sağlaması gerekir.
Not
- Kullanıcı adı ve parola değerlerinin her ikisi de 8 ile 64 karakter uzunluğunda olmalıdır. Parolaya herhangi bir değer atanabilir ancak kullanıcı adı yalnızca alfasayısal ve alt çizgi karakterleri içerebilir.
- Arama kimlik bilgileri yalnızca kullanıcıların kimliğini doğrular ve kimliği doğrulanmamış kullanıcıların Elasticsearch uç noktasına erişemediğinden emin olun. Ancak Elasticsearch HTTPS'yi desteklemediğinden bu kimlik bilgileri ağ üzerinden Base64 ile kodlanmış dizeler olarak gönderilir. İsteğe ara erişim olasılığı varsa, kurumsal güvenlik ve uyumluluk gereksinimlerinize göre uygun güvenlik ayarlarını yapılandırın.
- IpSec aracılığıyla şifreleme kullanarak, aşağıda açıklandığı gibi, hem arama hem de dizin oluşturma erişimini belirli kullanıcılar veya kullanıcı gruplarıyla sınırlamayı hedefleyin.
Bir Windows sunucusunda Elasticsearch'in güvenliğini sağlamak için IPSec kullanmak için aşağıdaki teknikleri göz önünde bulundurun:
Güvenliği yalnızca kimlik doğrulamasıyla yapılandırın:
- Elasticsearch bağlantı noktasına yalnızca yetkili kullanıcıların erişebilmesini sağlar. Yalnızca hizmet tarafı kuralları gerektirir (yalnızca Elasticsearch çalıştıran sunucuda güvenlik duvarı kuralları)
- Ön koşul: Azure DevOps Server bir etki alanı hesabıyla yapılandırılmalıdır
- IPsec korumalı Ağ Trafiğine İzin Veren Güvenlik Duvarı Kuralları Oluşturma'daki adımları izleyin
Kimlik doğrulaması, bütünlük koruması ve şifreleme ile güvenliği yapılandırın:
- Kimlik doğrulamasıyla birlikte şifreleme ve bütünlük korumasının uygulanmasını sağlar. Hem istemci tarafı hem de hizmet tarafı kuralları gerektirir (Elasticsearch çalıştıran sunucuda ve tüm Azure DevOps Server Uygulama Katmanı sunucularında güvenlik duvarı kuralları)
- Ön koşul: Azure DevOps Server bir etki alanı hesabıyla yapılandırılmalıdır
- Şifreleme ve Grup Üyeliği Gerektirerek Sunucuyu Yalıtma'daki adımları izleyin
Yükseltme araması
TFS 2017 Güncelleştirme 1 güncelleştirilmiş Arama bileşenlerini içerir.
- Arama hizmeti bir yükseltme sırasında TFS 2017 RTM'de yapılandırıldıysa, Arama hizmeti yükseltilen TFS'de yapılandırılmışsa Arama hizmeti bileşenleri otomatik olarak güncelleştirilir.
- Arama uzak bir sunucuda yapılandırılmışsa, güncelleştirmek için yönergeleri izleyin.
TFS 2017 Güncelleştirme 2 , İş öğeleri arama içerir. Kod Arama ile aynı Arama hizmeti kullanır.
- Arama hizmeti bir yükseltme sırasında TFS 2017 RTM/Update1'de yapılandırıldıysa, Arama hizmeti yükseltilmekte olan TFS'de yapılandırılmışsa Arama hizmeti bileşenleri otomatik olarak güncelleştirilir.
- Arama uzak bir sunucuda yapılandırılmışsa, güncelleştirmek için yönergeleri izleyin.
TFS 2018 Güncelleştirme 2 , güncelleştirilmiş Arama bileşenlerini ve Wiki Arama'yı içerir.
- Arama hizmeti yükseltme sırasında TFS 2017 RTM, Güncelleştirme1, Güncelleştirme2 veya TFS 2018 RTM'de yapılandırıldıysa, Arama hizmeti yükseltilmekte olan TFS'de yapılandırılmışsa Arama hizmeti bileşenleri otomatik olarak güncelleştirilir.
- Arama uzak bir sunucuda yapılandırılmışsa, güncelleştirmek için yönergeleri izleyin.
Her iki durumda da, yapılandırmadan sonra güncelleştirilmiş bileşenleri desteklemek için tüm mevcut içerik (kod dosyaları ve iş öğeleri) otomatik olarak yeniden dizinlenir. İçerik hacmine bağlı olarak, bu yükseltmenin tamamlanması biraz zaman alabilir.
TFS 2018 Güncelleştirme 1.1 ve TFS 2018 Güncelleştirme 3, daha güvenli hale getirmek için TFS ile Arama hizmeti arasındaki iletişim için temel kimlik doğrulamasını içerir. TFS 2018 Güncelleştirme 1.1 veya TFS 2018 Güncelleştirme 3'e yapılan tüm yüklemeler veya yükseltmeler, Sunucu veya Arama yapılandırma sihirbazı aracılığıyla Arama özelliğini yapılandırmanın bir parçası olarak kimlik bilgilerini sağlamalıdır.
TFS 2018 Güncelleştirme 2 (veya üzeri) ile sürüm Azure DevOps Server 2019 Güncelleştirme 1, arama ayrı bir sunucuda yapılandırıldığında, aramanın yeniden yüklenmesini gerektirir. Yükseltme yönergelerini izlerken, güncelleştirme
Configure-TFSSearch.ps1 – Operation updateyerine 4. adımda aramayı yeniden yüklemek için aşağıdaki komutu çalıştırın:
Configure-TFSSearch.ps1 -Operation remove Configure-TFSSearch.ps1 -Operation install -TFSSearchInstallPath <install location> -TFSSearchIndexPath $env:SEARCH_ES_INDEX_PATH
Aramayı Kaldır
Üretim öncesi yükseltme, üretim yükseltmesi, yeni donanım geçişi, kopyalama veya diğer bakım işlemleri için Sunucu Yapılandırma Sihirbazı Arama'yı yapılandırz. Ancak, sunucu bakım işlemi tamamlandıktan sonra yeniden yapılandırmak kolaydır.
Ancak, artık Arama'yı kullanmak istemediğiniz veya yeni ve temiz bir yükleme yapmak istediğiniz durumlar olabilir. Bu işlem, Arama'nın Azure DevOps Server ile aynı sunucuda mı yoksa ayrı bir sunucuda mı yapılandırıldığına bağlı olarak birden çok adım gerektirir.
Azure DevOps Server olarak yapılandırılan makinede Arama'yı yapılandırmayı kaldırma
Yüklü olduğu her koleksiyon için Search uzantısını kaldırın. Azure DevOps Server örneğinizdeki her koleksiyonun Uzantıları Yönet sayfasına gidin:
Arama özelliğini kaldırın:
- Azure DevOps Server Yönetim Konsolu'nu açma
- Sol bölmede sunucunun adını seçin
- Sağ bölmede Özelliği Kaldır'ı seçin
- Özelliği Kaldır iletişim kutusunda Arama hizmeti ve ardından Kaldır'ı seçin
Elasticsearch hizmetini kaldırın:
- Komut İstemi'ni yönetici olarak açma
- Dizini değiştirin:
- TFS 2017 RTM için,
cd "C:\Program Files\Microsoft Team Foundation Server 15.0\Search\ES\elasticsearch-1.7.1-SNAPSHOT\bin"
- TFS 2017 Güncelleştirme 1 için,
cd "C:\Program Files\Microsoft Team Foundation Server 15.0\Search\ES\elasticsearch-2.4.1\bin"
- TFS 2018 Güncelleştirme 2 ve devamı ile Azure DevOps Server için,
cd "C:\Program Files\Microsoft Team Foundation Server 15.0\Search\ES\elasticsearch-5.4.1\bin"
- TFS 2017 RTM için,
- Hizmeti kaldırın:
- TFS 2017 için,
"service.bat remove"
- TFS 2018 ve Azure DevOps Server için,
"elasticsearch-service.bat remove"
- TFS 2017 için,
Arama verilerini kaldır:
- Ortam değişkeni tarafından açıklanan konumun içeriğini silme
SEARCH_ES_INDEX_PATH
- Ortam değişkeni tarafından açıklanan konumun içeriğini silme
Ortam değişkenlerini kaldırın:
- Ortam değişkenini silme
"SEARCH_ES_INDEX_PATH"
- Ortam değişkenini
"ES_HEAP_SIZE"silin (bu ortam değişkeni TFS 2018 Güncelleştirme 2 ve üzeri için kullanımdan kaldırılmış ve Azure DevOps Server)
- Ortam değişkenini silme
Ayrı bir sunucuda yapılandırıldığında Arama'yı yapılandırmayı kaldırma
Yüklendiği her koleksiyon için Kod, İş öğesi veya Wiki gibi Arama uzantısını kaldırın. Azure DevOps Server örneğinizdeki her koleksiyonun Uzantıları Yönet sayfasına gidin.
Arama özelliğini kaldırın:
- Özellik Kaldır iletişim kutusunda Yönetim Konsolu'nu açın
- Sol bölmede Azure DevOps Server
- Sağ bölmede Özelliği Kaldır'ı seçin
- Özelliği Kaldır iletişim kutusunda Arama hizmeti ve ardından Kaldır'ı seçin
Elasticsearch hizmetini ve verilerini kaldırın:
- PowerShell'i yönetici olarak açma
- Search'ün uzaktan yüklenmesi için gereken diğer dosyaların yanı sıra Search.ps1yapılandır klasörünü açın
- Kaldır seçeneğiyle betiği yeniden çalıştırın:
- TFS 2017 RTM için,
"Configure Search.ps1 -RemoveTFSSearch"
- TFS 2017 Güncelleştirme1 ve devamı ile Azure DevOps Server için,
"ConfigureTFSSearch.ps1 -remove"
- TFS 2017 RTM için,
Arama sınırlamaları
Azure DevOps Server araması aşağıdaki sınırlamalara sahiptir:
- Olağanüstü durum kurtarma (DR) işlemi yaparsanız ve sunucunuzu SQL veritabanınızın önceki bir anlık görüntüsüne geri taşırsanız , tüm koleksiyonlarınızı yeniden dizine alırsınız.