Migrar do GitHub Enterprise 11.10.x para o 2.1.23

Há suporte para migrações do GitHub Enterprise 11.10.348 e mais recentes. Não há suporte para migrações do GitHub Enterprise 11.10.348 e versões anteriores. Você deve atualizar o 11.10.348 em várias etapas de atualização. Para obter mais informações, consulte o procedimento de atualização do 11.10.348, "Atualizar para a versão mais recente".

Para atualizar para a versão mais recente do GitHub Enterprise, você deve migrar para a versão GitHub Enterprise Server 2.1 e só então poderá seguir o processo regular. Para obter mais informações, consulte "Atualizar o GitHub Enterprise".

Preparar para a migração

1. Revise o guia de provisionamento e instalação e verifique se foram atendidos todos os pré-requisitos necessários para provisionar e configurar o GitHub Enterprise 2.1.23 no seu ambiente. Para obter mais informações, consulte "Provisionar e instalar".

2. Verifique se a instância atual está sendo executada em uma versão de atualização compatível.

3. Configure a versão mais recente do GitHub Enterprise Server Backup Utilities. Para obter mais informações, consulte GitHub Enterprise Server Backup Utilities.

   • Se você já configurou backups programados usando o GitHub Enterprise Server Backup Utilities, certifique-se de atualizar para a versão mais recente.
   • Se você não estiver executando backups programados no momento, configure o GitHub Enterprise Server Backup Utilities.

4. Faça um instantâneo inicial de backup completo da instância atual usando o comando ghe-backup. Se você já configurou backups programados na instância atual, não será necessário obter o instantâneo.

   Dica: durante a obtenção do instantâneo, você pode deixar a instância online e em uso. Você fará outro instantâneo durante a parte de manutenção da migração. Como os backups são incrementais, o instantâneo inicial reduz a quantidade de dados transferidos no instantâneo final, o que pode reduzir o período de manutenção.

5. Determine o método para alternar o tráfego de rede do usuário para a nova instância. Após a migração, todo o tráfego de rede HTTP e Git será direcionado para a nova instância.

   • DNS - Esse método é recomendável para todos os ambientes porque é simples e funciona bem, mesmo ao migrar de um datacenter para outro. Antes de iniciar a migração, reduza o TTL do registro DNS para cinco minutos ou menos e permita a propagação da alteração. Quando a migração for concluída, atualize o(s) registro(s) DNS de modo a apontar para o endereço IP da nova instância.
   • Atribuição de endereço IP - Este método só está disponível na migração de VMware para VMware e é recomendado apenas se o método DNS não estiver disponível. Antes de iniciar a migração, você terá que desligar a instância antiga e atribuir seu endereço IP à nova instância.

6. Programe um período de manutenção. O período de manutenção deve abranger tempo suficiente para transferir os dados do host de backup para a nova instância. Esse período varia com base no tamanho do instantâneo de backup e na largura de banda de rede disponível. Durante esse período, sua instância atual ficará indisponível e em modo de manutenção enquanto você migra para a nova instância.

Fazer a migração

1. Provisione uma nova instância do GitHub Enterprise 2.1. Para obter mais informações, consulte o guia "Provisionar e instalar" da plataforma de destino.

2. Em um navegador, vá até o novo endereço IP do appliance réplica e faça o upload da sua licença do GitHub Enterprise.

3. Defina uma senha de administrador.

4. Clique em Migrate (Migrar).

   

5. Cole a chave SSH de acesso ao host de backup em "Add new SSH key" (Adicionar nova chave SSH).

   

6. Clique em Add key (Adicionar chave) e em Continue (Continuar).

7. Copie o comando ghe-restore a ser executado no host do backup para migrar os dados para a nova instância.

   

8. Habilite o modo de manutenção na instância antiga e aguarde a conclusão de todos os processos ativos. Para obter mais informações, consulte "Habilitar e programar o modo de manutenção".

   Observação: a partir deste momento, a instância ficará indisponível para uso regular.

9. No host do backup, execute o comando ghe-backup para fazer o último instantâneo de backup. Essa ação garante a obtenção de todos os dados da instância antiga.

10. No host de backup, execute o comando ghe-restore que você copiou na tela de status de restauração da nova instância para restaurar o instantâneo mais recente.

    $ ghe-restore 169.254.1.1
    The authenticity of host '169.254.1.1:122' can't be established.
    A impressão digital da chave RSA é fe:96:9e:ac:d0:22:7c:cf:22:68:f2:c3:c9:81:53:d1.
    Tem certeza de que deseja continuar com a conexão (sim/não)? yes
    Connect 169.254.1.1:122 OK (v2.0.0)
    Starting restore of 169.254.1.1:122 from snapshot 20141014T141425
    Restoring Git repositories ...
    Restaurando o GitHub Pages...
    Restaurando anexos de ativos...
    Restaurando entregas de hooks...
    Restaurando o database MySQL...
    Restaurando o database Redis...
    Restaurando chaves SSH autorizadas...
    Restaurando índices do Elasticsearch...
    Restaurando chaves SSH de host...
    Completed restore of 169.254.1.1:122 from snapshot 20141014T141425
    Visit https://169.254.1.1/setup/settings to review appliance configuration.

11. Volte à tela de status de restauração da nova instância para confirmar a conclusão da restauração.

    

12. Clique em Continue to settings (Continuar em configurações) para revisar e ajustar as informações de configuração importadas da instância anterior.

    

13. Clique em Save settings (Salvar configurações).

    Observação: você pode usar a nova instância depois de aplicar as definições de configuração e reiniciar o servidor.

14. Alterne o tráfego de rede do usuário da instância antiga para a nova instância usando a atribuição de endereço DNS ou IP.

15. Atualize para a versão de patch mais recente da versão 2.17. Para obter mais informações, consulte "Atualizar o GitHub Enterprise Server".