Gérer l’indexation de recherche
Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018
Vous pouvez gérer votre extension de recherche et vos status d’indexation, qui incluent les actions suivantes :
- Vérifier les status d’indexation
- Suspendre l’indexation
- Reprendre l’indexation
- Réindexer un dépôt ou une collection
Prérequis
- Installer et configurer la recherche
- Pour gérer la recherche et l’indexation, vous devez être administrateur de collection de projets (PCA) pour le organization
Gérer l’indexation
La recherche est gérée en exécutant des scripts PowerShell et SQL. Tous ces scripts peuvent être téléchargés à partir du dépôt GitHub Code-Search. Vous pouvez télécharger tous les scripts dans un dossier local sur le serveur. Ce serveur exécute la base de données pour Azure DevOps Server à l’aide de l’option Télécharger le fichier ZIP.
Les scripts PowerShell nécessitent les fichiers de script SQL. Vérifiez donc que le dossier SqlScripts et son contenu sont présents, ainsi que les scripts PowerShell.
Notes
Lorsque vous exécutez des scripts, assurez-vous d’exécuter le script approprié pour votre version Azure DevOps Server ou TFS :
Vérifier les status d’indexation
Pour TFS 2018 et Azure DevOps Server, consultez la section suivante.
Pour case activée le status d’indexation après la configuration de la recherche ou après l’installation de l’extension pour un regroupement, procédez comme suit :
Exécutez le
CheckIndexingStatus.ps1
script avec des privilèges d’administration. Vous êtes invité à entrer les informations suivantes :- Le serveur SQL instance nom où se trouve la base de données de configuration TFS.
- Nom de la base de données de la collection TFS.
- Nom de la base de données de configuration TFS.
- Nom de la collection.
- Nombre de jours précédents pour case activée status d’indexation.
Vérifiez les sorties suivantes :
Output | Description |
---|---|
L’indexation de collection a été déclenchée avec succès | Indique que l’indexation est en cours. S’il s’affiche, case activée les sorties suivantes. Si elle n’est pas affichée, passez à l’étape 3. |
Indexation des dépôts terminée | Les dépôts dont l’indexation a été terminée et qui peuvent désormais faire l’objet d’une recherche. |
Dépôts dans la phase de découverte de fichiers | Dépôts où les fichiers doivent encore être découverts. Les fichiers sont indexés après cette étape. Les dépôts dans cet état ne peuvent pas encore faire l’objet d’une recherche. Le nombre de fichiers déjà découverts pour l’indexation dans chaque dépôt s’affiche. Ce nombre augmente à mesure que d’autres fichiers sont découverts. |
Indexation des dépôts en cours | Ces dépôts sont partiellement indexés et doivent faire l’objet d’une recherche, même si les résultats ne sont que partiels. |
- L’indexation prend un certain temps. Exécutez le
CheckIndexingStatus.ps1
script à intervalles réguliers pour case activée progression de l’indexation. - Si l’indexation ne fonctionne pas ou est en cours, mais que le nombre de fichiers en attente n’a pas changé depuis un certain temps, ou si vous n’obtenez aucun résultat pour une recherche, exécutez le
TriggerCollectionIndexing.ps1
script dans une fenêtre PowerShell avec l’autorisation d’administration. - Si le problème persiste, accédez au Developer Community pour obtenir de l’aide.
Vérifier les status d’indexation pour TFS 2018 et versions ultérieures
Pour case activée le status d’indexation après la configuration de la recherche ou après l’installation de l’extension pour un regroupement, procédez comme suit :
Exécutez le
ExtensionInstallIndexingStatus.ps1
script avec des privilèges d’administration. Vous êtes invité à entrer :- Nom du instance SQL Server où se trouve la base de données de configuration Azure DevOps Server.
- Nom de la base de données de collection Azure DevOps Server.
- Nom de la base de données de configuration Azure DevOps Server.
- Nom de la collection.
- Nombre de jours précédents pour case activée status d’indexation.
Vérifiez les sorties suivantes.
Outputs | Description |
---|---|
L’indexation de collection a été déclenchée avec succès | Indique que l’indexation est en cours. S’il s’affiche, case activée les sorties suivantes. S’il n’est pas affiché, passez à l’étape suivante. |
Indexation terminée des référentiels | Nombre de dépôts pour lesquels l’indexation a été effectuée et qui peuvent faire l’objet d’une recherche. |
État des dépôts en cours d’indexation | Liste des noms de tous les dépôts qui sont toujours indexés et qui peuvent faire l’objet d’une recherche partielle. |
- L’indexation prend un certain temps. Exécutez le
RecentIndexingActivity.ps1
script à intervalles réguliers pour case activée progression de l’indexation. Ce script prend les mêmes paramètres que leExtensionInstallIndexingStatus.ps1
script.
Outputs | Description |
---|---|
Nouvelle indexation des référentiels terminée | Nombre de dépôts pour lesquels l’indexation s’est terminée dans l’intervalle de temps spécifié. |
Nombre de dépôts avec une nouvelle indexation en cours | Nombre de dépôts pour lesquels l’indexation n’est pas encore terminée. Ces dépôts sont toujours indexés et peuvent faire l’objet d’une recherche partielle. |
Référentiels terminés l’indexation continue | Nombre de validations traitées dans l’intervalle de temps spécifié. Le nombre peut ne pas correspondre exactement au nombre total d’envois (push) vers le dépôt, car les fusions sont validées au fur et à mesure qu’elles sont indexées. |
Nombre de dépôts avec indexation continue en cours | Nombre de dépôts pour lesquels les validations sont toujours en cours de traitement. Ces dépôts affichent des résultats incomplets jusqu’à ce que l’indexation soit terminée. |
Nombre d’échecs de travail d’indexation | Nombre de travaux d’indexation ayant échoué. Les dépôts associés à ces travaux d’indexation peuvent potentiellement afficher des résultats incomplets jusqu’à ce que les travaux d’indexation ultérieurs pour les mêmes dépôts aient corrigé l’échec de l’indexation. |
Suspendre l’indexation
Pour suspendre toute l’indexation, exécutez PauseSearchIndexing.ps1
, ce qui est utile si vous constatez des pics d’utilisation du processeur après la configuration de la recherche. Vous êtes invité à entrer les informations suivantes :
- Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
- Nom de la base de données de configuration Azure DevOps Server
Reprendre l’indexation
Si vous avez suspendu l’indexation, exécutez ResumeIndexing.ps1
pour recommencer. Vous êtes invité à entrer les informations suivantes :
- Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
- Nom de la base de données de configuration Azure DevOps Server
Réindexer un dépôt ou une collection
Pour réindexer un référentiel Git ou TFVC, exécutez la version appropriée du script Re-IndexingRepository.ps1
pour votre version Azure DevOps Server.
Vous êtes invité à entrer les informations suivantes :
- Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
- Nom de la base de données de collection Azure DevOps Server
- Nom de la base de données de configuration Azure DevOps Server
- Type de réindexation à exécuter, ou
Git\_Repository
TFVC\_Repository
- Nom de la collection
- Nom du dépôt à réindexer
Pour réindexer une collection, exécutez le script TriggerCollectionIndexing.ps1
Vous êtes invité à entrer les informations suivantes :
- Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
- Nom de la base de données de collection Azure DevOps Server
- Nom de la base de données de configuration Azure DevOps Server
- Nom de la collection
- Entités à réindexer,
All
,Code
,WorkItem
ouWiki
Limitations de recherche
Si vous effectuez une opération de récupération d’urgence et que vous replacez votre serveur vers une instantané antérieure de votre base de données SQL, réindexez toutes vos collections.