Esta versão do GitHub Enterprise foi descontinuada em 2021-09-23. 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.

Criar réplica de alta disponibilidade

Em uma configuração ativa/passiva, o appliance réplica é uma cópia redundante do appliance primário. Em caso de falha no appliance primário, o modo de alta disponibilidade permitirá que a réplica atue como appliance primário, mitigando as interrupções de serviço.

Observação: Há um máximo de 8 réplicas de disponibilidade alta (passiva e ativas/georreplicas) permitidos em GitHub Enterprise Server.

Criar réplica de alta disponibilidade

  1. Configure um novo appliance do GitHub Enterprise Server na plataforma desejada. O appliance réplica deve refletir as configurações de CPU, RAM e armazenamento do appliance primário. É recomendável instalar o appliance réplica em um ambiente independente. Hardware, software e componentes de rede subjacentes devem ser isolados dos do appliance primário. Se estiver em um provedor de nuvem, use uma região ou zona separada. Para obter mais informações, consulte Configurar uma instância do GitHub Enterprise Server.

  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 correspondente à senha no appliance primário e continue.

  4. Clique em Configure as Replica (Configurar como réplica). Opções de instalação com link para configurar a nova instância como réplica

  5. Em "Add new SSH key" (Adicionar nova chave SSH), digite a chave SSH. Adicionar chave SSH

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

  7. Conecte-se ao endereço IP do appliance réplica usando SSH.

    $ ssh -p 122 admin@REPLICA IP
  8. Para gerar um par de chaves para replicação, use o comando ghe-repl-setup com o endereço IP do appliance primário e copie a chave pública que ele retorna.

    $ ghe-repl-setup PRIMARY IP
  9. Para adicionar a chave pública à lista de chaves autorizadas no appliance primário, navegue para o https://PRIMARY-HOSTNAME/setup/settings e adicione a chave que você copiou da réplica à lista.

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

    $ ghe-repl-setup PRIMARY IP
  11. Para iniciar a replicação dos datastores, use o comando ghe-repl-start.

    $ ghe-repl-start

    Aviso: ghe-repl-start causa uma breve interrupção no servidor principal, durante o qual os usuários podem ver erros internos do servidor. Para fornecer uma mensagem mais amigável, execute ghe-maintenance -s no nó principal antes de executar ghe-repl-start no nó de réplica para colocar o appliance no modo de manutenção. Uma vez iniciada a réplica, desabilite o modo de manutenção com ghe-maintenance -u. Git replication will not progress while the primary node is in maintenance mode.

  12. Para verificar o status do canal de replicação de cada armazenamento de dados, use o comando ghe-repl-status.

    $ ghe-repl-status

Criar réplicas com replicação geográfica

Este exemplo de configuração usa um primário e duas réplicas, localizados em três regiões geográficas diferentes. Mesmo que os três nós estejam em redes diferentes, todos os nós precisam estar acessíveis entre si. No mínimo, as portas administrativas necessárias devem ficar abertas para todos os outros nós. Para obter mais informações sobre os requisitos de portas, consulte "Portas de rede".

  1. Crie a primeira réplica da mesma forma que você faria em uma configuração padrão de dois nós executando ghe-repl-setup na primeira réplica.

    (replica1)$ ghe-repl-setup PRIMARY IP
    (replica1)$ ghe-repl-start
  2. Crie a segunda réplica e use o comando ghe-repl-setup --add. O sinalizador --add impede a substituição da configuração de replicação atual e adiciona a nova réplica à configuração.

    (replica2)$ ghe-repl-setup --add PRIMARY IP
    (replica2)$ ghe-repl-start
  3. Por padrão, as réplicas são configuradas no mesmo centro de dados e agora tentarão propagar a partir de um nó existente no mesmo centro de dados. Configure as réplicas para datacenters diferentes definindo outros valores na opção do datacenter. Você pode especificar os valores que preferir, desde que sejam diferentes uns dos outros. Execute o comando ghe-repl-node em cada nó e especifique o datacenter.

    No primário:

    (primary)$ ghe-repl-node --datacenter [PRIMARY DC NAME]

    Na primeira réplica:

    (replica1)$ ghe-repl-node --datacenter [FIRST REPLICA DC NAME]

    Na segunda réplica:

    (replica2)$ ghe-repl-node --datacenter [SECOND REPLICA DC NAME]

    Dica: você pode definir as opções --datacenter e --active simultaneamente.

  4. Um nó de réplica ativo armazenará cópias dos dados do appliance e solicitações do usuário final do serviço. Um nó inativo armazenará cópias dos dados do appliance, mas não as solicitações do usuário final do serviço. Habilite o modo ativo usando o sinalizador --active ou use o sinalizador --inactive para o modo inativo.

    Na primeira réplica:

    (replica1)$ ghe-repl-node --active

    Na segunda réplica:

    (replica2)$ ghe-repl-node --active
  5. Para aplicar a configuração, use o comando ghe-config-apply no primário.

    (primary)$ ghe-config-apply

Configurar DNS de localização geográfica

Configure o Geo DNS usando os endereços IP dos nós primário e das réplicas. Você também pode criar um DNS CNAME para o nó primário (por exemplo, primary.github.example.com) para acessar o nó primário via SSH ou fazer backup usando backup-utils.

Para fins de teste, é possível adicionar entradas ao arquivo hosts da estação de trabalho local (por exemplo, /etc/hosts). Essas entradas de exemplo resolverão as solicitações de HOSTNAME para replica2. É possível segmentar hosts específicos comentando linhas diferentes.

# <primary IP>     <em>HOSTNAME</em>
# <replica1 IP>    <em>HOSTNAME</em>
<replica2 IP>    <em>HOSTNAME</em>

Leia mais