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
-
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".
-
Verifique se a instância atual está sendo executada em uma versão de atualização compatível.
-
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.
-
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.
-
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.
-
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
-
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.
-
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.
-
Defina uma senha de administrador.
-
Clique em Migrate (Migrar).
-
Cole a chave SSH de acesso ao host de backup em "Add new SSH key" (Adicionar nova chave SSH).
-
Clique em Adicionar chave e, em seguida, clique em Continuar.
-
Copie o comando
ghe-restore
a ser executado no host do backup para migrar os dados para a nova instância. -
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.
-
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. -
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.
-
Volte à tela de status de restauração da nova instância para confirmar a conclusão da restauração.
-
Clique em Continue to settings (Continuar em configurações) para revisar e ajustar as informações de configuração importadas da instância anterior.
-
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.
-
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.
-
Atualize para a versão de patch mais recente da versão enterprise-server@2.19. Para obter mais informações, consulte "Atualizar o GitHub Enterprise Server".