Migrar índices de ElasticSearch al servidor de GitHub Enterprise 2.14 o superior

Servidor de GitHub Enterprise 2.14 incluye una mejora a Elasticsearch 5.6. Antes de actualizar a Servidor de GitHub Enterprise 2.14 o superior desde la versión 2.12 o 2.13, te recomendamos descargar, instalar y ejecutar las herramientas de migración de Elasticsearch para que tus índices más grandes se migren en línea mientras tu aplicativo aún tiene acceso en línea.

Índices buscar

El script de migración busca un índice buscar primero mientras el aparato está en línea. Migrar los índices buscar puede tomar desde unos minutos hasta unos días, según su tamaño. Para ejemplificar índices grandes, estos índices demoraron un par de días para migrar a nuestro entorno de prueba.

admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6
green  open   blog-1                     1   0          0            0       144b           144b
green  open   projects-1                 1   0          0            0       144b           144b
green  open   registry-packages-1        1   0          0            0       144b           144b
green  open   showcases-1                1   0          0            0       144b           144b
health status index                    pri rep docs.count docs.deleted store.size pri.store.size
green  open   pull-requests-1            1   0          1            0      9.3kb          9.3kb
green  open   wikis-1                    1   0          2            0        5kb            5kb
green  open   hookshot-logs-2018-05-29   5   0         25            0    124.2kb        124.2kb
green  open   repos-1                    1   0       1638            1      1.4mb          1.4mb
green  open   gists-1                    1   0       3531           64    291.9kb        291.9kb
green  open   audit_log-1-2018-06-1      1   0      11108            0        3mb            3mb
green  open   users-1                    1   0      19866           56      2.7mb          2.7mb
green  open   hookshot-logs-2018-05-31   5   0      20000            0     33.4mb         33.4mb
green  open   hookshot-logs-2018-06-04   5   0      20000            0     32.6mb         32.6mb
green  open   issues-1                   1   0      26405            6     82.8mb         82.8mb
green  open   hookshot-logs-2018-05-30   5   0     119744            0    196.8mb        196.8mb
green  open   audit_log-1-2018-05-1      1   0     191664            0       50mb           50mb
green  open   code-search-1              1   0    6932626           44     42.9gb         42.9gb
green  open   commits-1                  1   0   63753587         1485     45.4gb         45.4gb

Los índices buscar comienzan con:

• blog-
• code-search-
• commits-
• gists-
• issues-
• labels-
• marketplace-listings-
• non-marketplace-listings-
• projects-
• pull-requests-
• registry-packages-
• repos-
• showcases-
• topics-
• users-

Índices Webhooks

Después de que el script de migración reconstruye los índices buscar necesarios en línea, el script verificará si algún índice webhook debe ser reconstruido. Si ejecutas tu aparato con el Servidor de GitHub Enterprise 2.12 o 2.13 durante 14 días o más, entonces probablemente no necesitarás que tu índice webhook se reconstruya ya que los índices webhook tienen una política de retención predeterminada de siete días. Si estás actualizando tu aparato desde el GitHub Enterprise 2.11 o inferior, entonces es posible que debas reconstruir los índices webhook.

Si algún índice webhook debe ser reconstruido, entonces se te pedirá habilitar el modo mantenimiento antes de que el script pueda reconstruir los índices webhook. A pesar de que migrar los índices webhook requiere algo de tiempo de inactividad, no se necesitan grandes ventanas de mantenimiento o tiempo de inactividad.

Los índices webhook comienzan con hookshot-logs-.

Índices disponibles

Puedes ver los índices disponibles en tu aparato utilizando cURL.

admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6
green  open   blog-1                     1   0          0            0       144b           144b
green  open   projects-1                 1   0          0            0       144b           144b
green  open   registry-packages-1        1   0          0            0       144b           144b
green  open   showcases-1                1   0          0            0       144b           144b
health status index                    pri rep docs.count docs.deleted store.size pri.store.size
green  open   pull-requests-1            1   0          1            0      9.3kb          9.3kb
green  open   wikis-1                    1   0          2            0        5kb            5kb
green  open   hookshot-logs-2018-05-29   5   0         25            0    124.2kb        124.2kb
green  open   repos-1                    1   0       1638            1      1.4mb          1.4mb
green  open   gists-1                    1   0       3531           64    291.9kb        291.9kb
green  open   audit_log-1-2018-06-1      1   0      11108            0        3mb            3mb
green  open   users-1                    1   0      19866           56      2.7mb          2.7mb
green  open   hookshot-logs-2018-05-31   5   0      20000            0     33.4mb         33.4mb
green  open   hookshot-logs-2018-06-04   5   0      20000            0     32.6mb         32.6mb
green  open   issues-1                   1   0      26405            6     82.8mb         82.8mb
green  open   hookshot-logs-2018-05-30   5   0     119744            0    196.8mb        196.8mb
green  open   audit_log-1-2018-05-1      1   0     191664            0       50mb           50mb
green  open   code-search-1              1   0    6932626           44     42.9gb         42.9gb
green  open   commits-1                  1   0   63753587         1485     45.4gb         45.4gb

Preparar un aparato del Servidor de GitHub Enterprise 2.12 o 2.13

Si actualizas a Servidor de GitHub Enterprise 2.14 o superior sin ejecutar las herramientas de migración, los índices Elasticsearch existentes pueden ser inválidos y no funcionarán correctamente. Para ejecutar el script de migración de Elasticsearch, tu aparato del Servidor de GitHub Enterprise debe estar ejecutando GitHub Enterprise 2.12 o 2.13.

1. Autentícate en el aparato principal con alta disponibilidad habilitado utilizando SSH.

2. Descarga e instala el script de migración en el aparato:

   $ wget https://github-enterprise.s3.amazonaws.com/util/es-5x-transition-tools.tar.gz
   $ sudo tar -C / -xvf es-5x-transition-tools.tar.gz

   Si administras una Agrupación del Servidor de GitHub Enterprise, autentica a uno de los nodos de servidores de Elasticsearch utilizando SSH e instala las herramientas de migración allí. Búscalos utilizando:

   $ ghe-cluster-each -r elasticsearch -p
    ghe-test-data-0
    ghe-test-data-1
    ghe-test-data-2

3. Ejecuta el script de migración:

   $ /usr/local/share/enterprise/ghe-es-5x-migration -r

   Nota: Si tiene índices webhook para migrar, después de ejecutar las migraciones en línea, se te pedirá que habilites el modo mantenimiento.

4. Si estás ejecutando una Agrupación Servidor de GitHub Enterprise, sigue la documentación oficial de actualización para VM únicos o entornos de alta disponibilidad o la guía de actualización de agrupación. Para obtener más información, consulta "Actualizar Servidor de GitHub Enterprise" o "Actualizar una agrupación".