Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise será descontinuada em Esta versão do GitHub Enterprise foi descontinuada em 2020-01-22. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Migrar índices do Elasticsearch para o GitHub Enterprise Server 2.14 ou mais recente

Ao se preparar para atualizar para o GitHub Enterprise Server 2.14, você terá que migrar seus índices para o Elasticsearch 5.6 com nosso script de migração.

Neste artigo

O GitHub Enterprise Server 2.14 inclui a atualização para o Elasticsearch 5.6. Antes de atualizar para o GitHub Enterprise Server 2.14 ou mais recente partindo da versão 2.12 ou 2.13, é recomendável baixar, instalar e executar as ferramentas de migração do Elasticsearch para que os maiores índices sejam migrados online enquanto o appliance ainda tem acesso online.

Índices de pesquisa

O script de migração verifica qualquer índice search enquanto o appliance está online. A migração dos índices search pode levar de minutos a dias, dependendo do tamanho dos índices. Para ver um exemplo de índices grandes, a migração desses índices levou alguns dias em nosso ambiente de teste.

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

Os índices search começam por:

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

Índices de webhook

Depois que o script de migração recriar online os índices search necessários, o script verificará se algum índice webhook precisa ser recompilado. Se executou seu appliance com o GitHub Enterprise Server 2.12 ou 2.13 por 14 dias ou mais, provavelmente você não precisará dos índices webhook recompilados, já que os índices webhook têm uma política de retenção padrão de sete dias. Se você estiver atualizando seu appliance a partir do GitHub Enterprise 2.11 ou anterior, talvez seja necessário recompilar os índices webhook.

Se algum índice webhook tiver que ser recompilado, você receberá uma solicitação para habilitar o modo de manutenção antes que o script possa recompilar os índices webhook. Embora a migração dos índices webhook cause algum tempo de inatividade, não é necessário programar longos períodos de manutenção ou inatividade.

Os índices webhook começam por hookshot-logs-.

Índices disponíveis

Veja os índices disponíveis no seu appliance usando 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 um appliance do GitHub Enterprise Server 2.12 ou 2.13

Se você atualizar para o GitHub Enterprise Server 2.14 ou mais recente sem executar as ferramentas de migração, os índices do Elasticsearch podem ficar inválidos e não funcionar corretamente. Para executar o scripts de migração do Elasticsearch, seu appliance do GitHub Enterprise Server deve estar executando o GitHub Enterprise 2.12 ou o 2.13.

Aviso:

  • Usar o GitHub Enterprise Server Backup Utilities destruirá índices antigos do Elasticsearch não compatíveis com as versões 5.X após a restauração. Nesse caso, talvez seja necessário fazer a reindexação manual.
  • Se o GitHub Enterprise Server estiver configurado para alta disponibilidade, o script de migração deve ser executado ainda durante a execução da replicação. Antes de iniciar a atualização, é necessário permitir que as alterações sejam replicadas totalmente no outro appliance. Se a replicação não estiver em execução enquanto o script de migração for executado, os índices do Elasticsearch poderão ficar inválidos.
  1. Autentique para o appliance primário com a Alta Disponibilidade habilitada usando SSH.

  2. Baixe e instale o script de migração para o appliance:

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

    Se você gerenciar um cluster do GitHub Enterprise Server, autentique em um dos nós do servidor Elasticsearch usando SSH e instale as ferramentas de migração nele. Localize usando o seguinte:

    $ ghe-cluster-each -r elasticsearch -p
     ghe-test-data-0
     ghe-test-data-1
     ghe-test-data-2
  3. Execute o script de migração:

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

    Observação: se tiver índices webhook para migrar, você receberá uma solicitação para ativar o modo de manutenção após executar as migrações online.

  4. Se você estiver executando um cluster do GitHub Enterprise Server, siga a documentação oficial da atualização para ambientes únicos de VMs ou alta disponibilidade, ou consulte o guia de atualização do cluster. Para obter mais informações, consulte "Atualizar o GitHub Enterprise Server" ou "Atualizar um cluster".

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato