Administración de índices de búsqueda para la instancia

GitHub Enterprise Server usa Elasticsearch para potenciar las características de búsqueda y proporciona herramientas para administrar el comportamiento de la búsqueda y del índice.

¿Quién puede utilizar esta característica?

Enterprise owners can manage search indices for a GitHub Enterprise Server instance.

En este artículo

Acerca de la búsqueda de GitHub Enterprise Server

Los usuarios pueden buscar en la instancia para encontrar, navegar y comprender problemas, solicitudes de cambios, código y otro contenido en GitHub Enterprise Server. Elasticsearch permite la funcionalidad de búsqueda en la instancia. Puede ver el estado actual de Elasticsearch y puede controlar el comportamiento de búsqueda e índice.

Para más información sobre la búsqueda de GitHub Enterprise Server, consulta Búsqueda en la documentación de GitHub. Para más información sobre Elasticsearch, consulta el sitio web de Elasticsearch.

Acerca de la administración de índices

GitHub Enterprise Server reconcilia el estado del índice de búsqueda con los datos de la instancia de forma automática y periódica, incluyendo:

  • Propuestas, solicitudes de incorporación de cambios, repositorios y usuarios en la base de datos
  • Repositorios de Git (código fuente) en disco

En uso normal, los propietarios de empresas no necesitan crear nuevos índices ni programar trabajos de reparación. Para solucionar problemas u otros fines de soporte técnico, Soporte de GitHub puede indicarte que ejecutes un trabajo de reparación.

Visualización de índices de búsqueda

  1. En la esquina superior derecha de cualquier página, haz clic en .
  2. En la barra lateral de la izquierda, haz clic en Índices de búsqueda.
  3. En "Administración de índices", haz clic en el índice de búsqueda que desea ver.

Creación de un nuevo índice de búsqueda

  1. En la esquina superior derecha de cualquier página, haz clic en .

  2. En la barra lateral de la izquierda, haz clic en Índices de búsqueda.

  3. Junto a "Administración de índices", haz clic en Crear nuevo índice.

  4. Selecciona la lista desplegable Seleccionar el índice para crear y, a continuación, haz clic en el índice de búsqueda que desea crear.

  5. Si deseas que se pueda buscar en el índice, selecciona la casilla Hacer que este índice se pueda buscar.

  6. Si deseas que se pueda buscar en el índice, selecciona la casilla Hacer que este índice se pueda escribir.

  7. Haz clic en Crear índice.

  8. Si la instancia usa una configuración de clúster o alta disponibilidad, deberá ejecutar un script para asegurarse de que el número de índices de búsqueda está configurado correctamente en toda la instancia.

    Acceda al shell administrativo del dispositivo principal a través de SSH y ejecute uno de los siguientes comandos.

    Para configuraciones de alta disponibilidad:

    Shell
    /usr/local/share/enterprise/ghe-es-auto-expand -v 0-all

    Para configuraciones en clúster:

    Shell
    /usr/local/share/enterprise/ghe-es-auto-expand -v 0-1

    Consulta Acceder al shell administrativo (SSH).

Administración de índices de búsqueda

Al visualizar un índice de búsqueda existente en el panel de administración del sitio, puedes realizar las siguientes acciones:

  • Hacer que el índice se pueda buscar.
  • Hacer que el índice se pueda escribir.
  • Actualizar el índice.
  • Eliminar el índice.
  • Restablecer el estado de reparación del índice.
  • Comenzar una nueva tarea de reparación de índice.
  • Habilitar o inhabilitar tareas de reparación de índices.

Puedes habilitar o deshabilitar tanto las operaciones de búsqueda como de indexación en el código fuente. Para obtener más información sobre la búsqueda de código, consulta Búsqueda de código.

  1. En la esquina superior derecha de cualquier página, haz clic en .
  2. En la barra lateral de la izquierda, haz clic en Índices de búsqueda.
  3. En la sección "Búsqueda de código", junto a "Búsqueda" o "Indexación", haz clic en Habilitar o Deshabilitar.

Reparación de índices de búsqueda

La instancia usa trabajos de reparación para conciliar los datos y programa un trabajo de reparación en segundo plano cuando se producen los siguientes eventos:

  • Se crea un nuevo índice de búsqueda;
  • faltan datos que se deben reponer; o
  • los datos de búsqueda antiguos deben ser actualizados.

En la sección “Reparación” del índice de búsqueda, una barra de progreso muestra el estado actual de la tarea de reparación a través de todos sus trabajadores en segundo plano. Puedes omitir el valor que se muestra en la barra de progreso después de que se haya completado un trabajo de reparación. La barra de progreso muestra la diferencia entre la compensación de reparación y el identificador de registro más alto de la base de datos. Además, este valor disminuirá a medida que se agreguen más repositorios a la tu instancia de GitHub Enterprise Server, incluso aunque esos repositorios estén indexados.

Para minimizar los efectos que esto tendrá en el desempeño de E/S y reducir las posibilidades de que las operaciones queden inactivas, trata de ejecutar una tarea de reparación durante las horas de poca actividad. A medida que el trabajo reconcilia el índice de búsqueda con la base de datos de Git y los datos del repositorio, se usará una CPU. Supervisa los promedios de carga del sistema y el uso de CPU con una utilidad como top. Si no observas ningún aumento significativo en el consumo de recursos, también debe ser seguro ejecutar un trabajo de reparación de índices durante las horas de más actividad.

Las tareas de reparación utilizan una "compensación de reparación" para la paralelización. Esto es una compensación dentro de la tabla de base de datos para el registro que se está compaginando. Múltiples tareas en segundo plano pueden sincronizar el trabajo en base a esta compensación.