Skip to main content

Iniciar failover no seu cluster de réplica

Se o cluster do GitHub Enterprise Server falhar, você poderá fazer failover na réplica.

Sobre o failover para o cluster de réplica

Se o datacenter do cluster ativo apresentar uma falha e você tiver configurado a alta disponibilidade, faça o failover para o cluster de réplica.

O failover para o cluster de réplica promove que ele seja o novo cluster ativo e desacopla o novo cluster ativo do cluster ativo antigo. Os nós no cluster ativo antigo serão colocados no modo de manutenção se estiverem em um estado íntegro o bastante para que essa operação seja executada.

Após o failover, você terá dois clusters autônomos sem alta disponibilidade configurados. Você poderá reconfigurar a replicação a partir do novo cluster ativo. Para saber mais, confira Configurar alta disponibilidade de replicação de um cluster.

Pré-requisitos

Para fazer failover para nós de réplica, você deve ter configurado a replicação de alta disponibilidade para o cluster. Para saber mais, confira Configurar alta disponibilidade de replicação de um cluster.

Iniciar failover no seu cluster de réplica

Note

Em uma instância em uma configuração de cluster, nós primários anteriores podíam acessar os nós recém-promovidos após o failover. Isso foi corrigido na versão de patch 3.12.2 . Para obter mais informações, consulte "Notas de versão."

Como resultado dessa correção, ghe-cluster-failover identifica IPs a serem bloqueados do cluster primário antigo e os grava no /data/user/common/cluster-ip-blocklist. Após a conclusão do failover, o comando executa o ghe-cluster-block-ips para bloquear os IPs no novo cluster ativo.

Além disso, os comandos ghe-cluster-block-ips, ghe-cluster-block-ip, ghe-cluster-unblock-ips e ghe-cluster-unblock-ip também foram introduzidos nessas versões de patch. Com esses comandos, você pode controlar manualmente quais IPs podem acessar o cluster recém-promovido e evitar a execução de uma configuração potencialmente longa associada à execução de todo o comando ghe-cluster-failover. Para saber mais, confira Utilitários de linha de comando.

  1. SSH no nó MySQL primário no cluster de réplica. Para saber mais, confira Acesar o shell administrativo (SSH).

  2. Para iniciar o failover no cluster secundário e configurar os nós para responder a solicitações, execute o comando a seguir.

    ghe-cluster-failover
    
  3. Após a conclusão da configuração executada, GitHub Enterprise Server exibe a mensagem a seguir.

    Finished cluster configuration
    
  4. Atualize o registro DNS para apontar para o endereço IP do balanceador de carga do seu cluster de réplica. Depois que o período de TTL expirar, as solicitações serão direcionadas para o cluster de réplica.

Depois que o GitHub Enterprise Server retornar você ao prompt, e suas atualizações de DNS se propagarem, você terá concluído o failover. Os usuários podem acessar o GitHub Enterprise Server usando o nome de host usual do seu cluster.