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-11-12. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Migrar do GitHub Enterprise 11.10.x para o 2.1.23

Para migrar do GitHub Enterprise 11.10.x para o 2.1.23, você precisará configurar uma nova instância do appliance e migrar os dados da instância anterior.

Neste artigo

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Ou, learn how to contribute.

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).

    Escolher o tipo de instalação

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

    Autorizar o backup

  6. Clique em Adicionar chave e, em seguida, clique em Continuar.

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

    Iniciar a migração

  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.

    Tela de restauração concluída

  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.

    Revisar configurações importadas

  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 enterprise-server@2.19. Para obter mais informações, consulte "Atualizar o GitHub Enterprise Server".

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Ou, learn how to contribute.