Observação: há, no máximo, oito réplicas de alta disponibilidade (réplicas passivas e ativas/geográficas) permitidas para o GitHub Enterprise Server.
Criar réplica de alta disponibilidade
-
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, confira "Como configurar uma instância do GitHub Enterprise Server".
-
Certifique-se de que o dispositivo primário e o novo dispositivo da réplica possam se comunicar entre si por meio das portas 122/TCP e 1194/UDP. Para obter mais informações, confira "Portas de rede".
-
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 correspondente � senha no appliance primário e continue.
-
Clique em Configurar como Réplica.
-
Em "Add new SSH key" (Adicionar nova chave SSH), digite a chave SSH.
-
Clique em Adicionar chave.
-
Conecte-se ao endereço IP do appliance réplica usando SSH.
$ ssh -p 122 admin@REPLICA IP
-
Para gerar um par de chaves para replicação, use o comando
ghe-repl-setup
com o endereço IP do dispositivo primário e copie a chave pública retornada.
1. 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.$ ghe-repl-setup PRIMARY IP
-
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
-
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 o qual os usuários podem receber erros internos do servidor. Para fornecer uma mensagem mais amigável, executeghe-maintenance -s
no nó primário antes de executarghe-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 comghe-maintenance -u
. A replicação do Git não progredirá enquanto o nó primário estiver no modo de manutenção.$ 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 porta, confira "Portas de rede".
-
Crie a primeira réplica da mesma forma que você faria para 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
-
Crie uma segunda réplica e use o comando
ghe-repl-setup --add
. O sinalizador--add
impede que ele substitua a configuração de replicação existente e adiciona a nova réplica � configuração.(replica2)$ ghe-repl-setup --add PRIMARY IP (replica2)$ ghe-repl-start
-
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
ao mesmo tempo. -
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 o modo inativo usando o sinalizador--inactive
.Na primeira réplica:
(replica1)$ ghe-repl-node --active
Na segunda réplica:
(replica2)$ ghe-repl-node --active
-
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. Crie também um DNS CNAME para o nó primário (por exemplo, primary.github.example.com
) para acessar o nó primário por meio do SSH ou para fazer backup por meio de backup-utils
.
Para teste, você pode adicionar entradas ao arquivo hosts
da estação de trabalho local (por exemplo, /etc/hosts
). Esses exemplos de entradas 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>