Información general
Elasticsearch (ES) impulsa la funcionalidad de búsqueda en la instancia de GitHub Enterprise Server. Para aportar las ventajas de mejorar el rendimiento y la posición de seguridad, al actualizar la instancia a la versión 3.13 o posterior, la versión de Elasticsearch del dispositivo se actualizará de la versión 5.6.16 a la 8.7.0.
Las secciones siguientes ayudan a los administradores a prepararse y supervisar la actualización de Elasticsearch. Los puntos clave son los siguientes:
- La actualización degradará temporalmente la experiencia de las características de registro de búsqueda y auditoría.
- Si vas a actualizar una instancia en una configuración de clúster, debes ejecutar un script para preparar el clúster para la actualización de ES. Consulta Actualizar una agrupación.
- En el caso de las copias de seguridad, todos los clientes deben tomar una instantánea de su instancia cuando se complete la actualización.
Impacto en los registros de búsqueda y auditoría
Todos los índices de búsqueda se volverán a generar después de la actualización a ES8. Los usuarios experimentarán una experiencia de búsqueda degradada durante la recompilación, pero se espera que la instancia sea funcional y esté disponible. El proceso de recompilación del índice depende del tamaño del conjunto de datos y puede tardar desde unas horas a varios días.
Los registros de auditoría no estarán disponibles inmediatamente después de la actualización y pueden tardar varias horas en migrarse.
Se recomienda encarecidamente realizar una copia de seguridad (mediante backup-utils) inmediatamente después de la finalización de la recompilación del índice y usar esa instantánea para todas las restauraciones futuras. Consulta Configuración de copias de seguridad en la instancia. Si restauras una copia de seguridad desde una instancia que ejecuta la versión 3.11 o 3.12 de GitHub Enterprise Server, cualquier contenido que se base en ES solo estará disponible después de que los índices de ES se hayan migrado y recompilado en la instancia de la versión 3.13.
Supervisión de la actualización de Elasticsearch
Puedes supervisar el progreso de la actualización de ES en el panel de administración del sitio.
- En la esquina superior derecha de cualquier página, haz clic en .
- En la barra lateral de la izquierda, haz clic en Índices de búsqueda.
Una vez completada la recompilación del índice, todos los índices de búsqueda deben mostrarse en verde y como «100 %».
Cambio del número de trabajos de reparación
De forma predeterminada, el número de trabajos de reparación de índices se establece en el número de núcleos de CPU divididos por 8 (con un límite superior de 8). Para acelerar la recompilación del índice, puedes ajustar el recuento de trabajos. Sin embargo, antes de hacerlo, debes tener en cuenta el posible impacto en la carga.
-
SSH en tu instancia de GitHub Enterprise Server Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para obtener más información, vea «Acceder al shell administrativo (SSH)».
Shell ssh -p 122 admin@HOSTNAME
ssh -p 122 admin@HOSTNAME -
Para cambiar el número de trabajos, escribe el siguiente comando.
Shell ghe-config app.github.es-workers NUMBER-OF-WORKERS
ghe-config app.github.es-workers NUMBER-OF-WORKERS -
Ejecute
ghe-config-apply.
También puedes ajustar el número de trabajos para las recompilaciones de índices individuales en la sección «Índices de búsqueda» del panel de administración del sitio. Consulta la sección Supervisión de la actualización de Elasticsearch.