Esta versão do GitHub Enterprise Server será descontinuada em 2026-03-17. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Recuperar configuração de alta disponibilidade

Após o failover para um appliance do GitHub Enterprise Server, você deve recuperar a redundância o quanto antes, em vez de usar somente um appliance.

Neste artigo

Sobre a recuperação de uma configuração de alta disponibilidade

Você pode usar o appliance primário anterior como novo appliance de réplica em caso de failover planejado ou não relacionado à integridade do appliance. Se o failover estiver relacionado a um problema no appliance primário, talvez você prefira criar outro appliance de réplica. Para saber mais, confira Criar réplica de alta disponibilidade.

Aviso

Você precisa habilitar o modo de manutenção antes de configurar um dispositivo primário anterior como uma nova réplica. Se você não habilitar o modo de manutenção, você causará uma interrupção na produção.

Configurar appliance primário anterior como nova réplica

  1. Conecte-se ao endereço IP do appliance primário anterior usando SSH.

    ssh -p 122 admin@ FORMER_PRIMARY_IP

  2. Habilite o modo de manutenção no dispositivo primário antigo. Para saber mais, confira Habilitar e programar o modo de manutenção.

  3. No dispositivo primário anterior, execute ghe-repl-setup com o endereço IP da réplica anterior. Talvez seja necessário usar a opção --force para substituir a configuração existente.

    ghe-repl-setup --force FORMER_REPLICA_IP

  4. Para adicionar a chave pública à lista de chaves autorizadas no dispositivo primário, procure https://PRIMARY-HOSTNAME/setup/settings e adicione a chave copiada da réplica à lista.

  5. Para verificar a conexão com o novo primário e habilitar o modo de réplica na nova réplica, execute ghe-repl-setup novamente.

    ghe-repl-setup FORMER_REPLICA_IP

  6. Para iniciar a replicação dos armazenamentos de dados, use o comando ghe-repl-start.

    ghe-repl-start

    Aviso

              `ghe-repl-start` causa uma breve interrupção no servidor primário, durante a qual os usuários podem receber erros internos do servidor. Para fornecer uma mensagem mais amigável, execute `ghe-maintenance -s` no nó primário antes de executar `ghe-repl-start` no nó de réplica a fim de colocar o dispositivo no modo de manutenção. Quando a replicação for iniciada, desabilite o modo de manutenção com `ghe-maintenance -u`. A replicação do Git não progredirá enquanto o nó primário estiver no modo de manutenção.

Se você estiver executando as versões 3.14.20, 3.15.15, 3.16.11, 3.17.8, 3.18.2 ou uma versão posterior, incluindo versões futuras como 3.19, você não precisará mais colocar o primário no modo de manutenção antes de executar ghe-repl-start. Esse comando não é mais esperado para causar uma interrupção no servidor primário. No entanto, ao configurar uma nova réplica, ghe-repl-start não causará uma interrupção desde que você execute ghe-config-apply entre ghe-repl-setup e ghe-repl-start. Pular ghe-config-apply e ir direto de ghe-repl-setup para ghe-repl-start ainda resultará em uma interrupção.