Gerenciar indexação de pesquisa

Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode gerenciar sua extensão de pesquisa e status de indexação, que incluem as seguintes ações:

• Verificar o estado da indexação
• Pausar a indexação
• Retomar a indexação
• Reindexar um repositório ou coleção

Pré-requisitos

• Instale e configure a Pesquisa.
• Ser atribuído à função de Administrador de Coleção de Projetos (PCA) para que a organização gerencie a Pesquisa e a indexação.

Gerir a indexação

A pesquisa é gerenciada executando scripts PowerShell e SQL. Todos esses scripts estão disponíveis para download no repositório GitHub de Pesquisa de Código. Você pode baixar todos os scripts em uma pasta local no servidor. Este servidor executa o banco de dados do Servidor de DevOps do Azure usando a opção Baixar ZIP .

Os scripts do PowerShell exigem os arquivos de script SQL, portanto, certifique-se de que a pasta SqlScripts e seu conteúdo estejam presentes, juntamente com os scripts do PowerShell.

Nota

Ao executar scripts, certifique-se de executar o script apropriado para sua versão:

• TFS 2018 RTM
• TFS 2018 Atualização 1
• TFS 2018 Atualização 2
• Azure DevOps Server e TFS 2018 Atualização 3

Verificar o estado da indexação

Para verificar o status da indexação depois que a Pesquisa for configurada ou depois que a extensão for instalada para uma coleção, execute as etapas a seguir.

1. Execute o ExtensionInstallIndexingStatus.ps1 script com privilégios administrativos e insira as seguintes informações:

   • O nome da instância do SQL Server onde o banco de dados de configuração do Servidor de DevOps do Azure está localizado.
   • O nome do banco de dados de coleção do Azure DevOps Server.
   • O nome do banco de dados de configuração do Azure DevOps Server.
   • O nome da coleção.
   • O número de dias anteriores para verificar o status da indexação.

2. Analise as seguintes saídas:

   • A indexação da coleção foi acionada com êxito: indica que a indexação está em andamento.
   • Indexação de repositórios concluída: lista repositórios cuja indexação foi concluída e pode ser pesquisada.
   • Status dos repositórios atualmente indexados: lista os nomes de todos os repositórios que ainda estão sendo indexados e são parcialmente pesquisáveis. A indexação demora algum tempo a ser concluída.

3. Execute o RecentIndexingActivity.ps1 script em intervalos para o progresso da indexação. Este script usa os mesmos parâmetros que o ExtensionInstallIndexingStatus.ps1 script:

   • Repositórios concluídos nova indexação: mostra o número de repositórios cuja indexação foi concluída dentro do intervalo de tempo especificado.
   • Contagem de repositórios com indexação nova em andamento: mostra o número de repositórios cuja indexação não está concluída. Esses repositórios ainda estão sendo indexados e são parcialmente pesquisáveis.
   • Repositórios concluídos indexação contínua: mostra o número de confirmações processadas no intervalo de tempo especificado. O número pode não corresponder exatamente ao número total de pushes para o repositório porque as mesclagens são confirmadas à medida que são indexadas.
   • Contagem de repositórios com indexação contínua em andamento: mostra o número de repositórios para os quais as confirmações ainda estão sendo processadas. Esses repositórios mostram resultados incompletos até que a indexação seja concluída.
   • Contagem de falhas de trabalho de indexação: mostra o número de trabalhos de indexação que falharam. Os repositórios associados a esses trabalhos de indexação podem potencialmente mostrar resultados incompletos até que trabalhos de indexação posteriores para os mesmos repositórios corrijam a indexação com falha.

Se você encontrar algum problema, obtenha suporte na Comunidade de desenvolvedores.

Pausar a indexação

Para pausar toda a indexação, execute: PauseSearchIndexing.ps1, o que é útil se você vir picos na utilização da CPU depois de configurar a Pesquisa. Você será solicitado a inserir as seguintes informações.

• O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
• O nome do banco de dados de configuração do Servidor de DevOps do Azure

Retomar a indexação

Se você pausou a indexação, execute: ResumeIndexing.ps1 para começar novamente. Você será solicitado a inserir as seguintes informações.

• O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
• O nome do banco de dados de configuração do Servidor de DevOps do Azure

Reindexar um repositório ou coleção

Para reindexar um repositório Git ou TFVC, execute a versão apropriada do script, Re-IndexingRepository.ps1, para sua versão do Azure DevOps Server. Você será solicitado a inserir as seguintes informações.

• O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
• O nome do banco de dados da coleção do Azure DevOps Server
• O nome do banco de dados de configuração do Servidor de DevOps do Azure
• O tipo de reindexação a ser executada, ou Git\_RepositoryTFVC\_Repository
• O nome da coleção
• O nome do repositório a ser reindexado

Para reindexar uma coleção, execute o script: TriggerCollectionIndexing.ps1. Você será solicitado a inserir as seguintes informações.

• O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
• O nome do banco de dados da coleção do Azure DevOps Server
• O nome do banco de dados de configuração do Servidor de DevOps do Azure
• O nome da coleção
• As entidades a reindexar, ou All, Code, WorkItem, ou Wiki

Limitações da pesquisa

Se você fizer uma operação de recuperação de desastres (DR) e mover o servidor de volta para um instantâneo anterior do banco de dados SQL, reindexe todas as suas coleções.

Artigos relacionados

• Instalar e configurar a Pesquisa