Usar o GitHub Enterprise Server com balanceador de carga

Sobre balanceadores de carga

Um design de balanceador de carga usa um dispositivo de rede para direcionar o Git e o tráfego HTTP para appliances individuais GitHub Enterprise Server. Você pode usar um balanceador de carga para restringir o tráfego direto para o appliance para fins de segurança, ou redirecionar o tráfego se necessário sem alterações no registro de DNS. Recomendamos fortemente usar um balanceador de carga baseado em TCP que suporte o protocolo PROXY.

Buscas de DNS para o nome de host GitHub Enterprise Server devem se resolver para o balanceador de carga. Recomendamos que você ative o isolamento de subdomínio. Se o isolamento do subdomínio estiver ativado, um registro de curinga adicional (*.HOSTNAME) também será resolvido para o balanceador de carga. Para obter mais informações, confira "Habilitar isolamento de subdomínio".

Informações de conexão do cliente

Como as conexões do cliente com o GitHub Enterprise Server vêm do balanceador de carga, pode ocorrer a perda do endereço IP do cliente.

Se o seu balanceador de carga puder apoiá-lo, recomendamos fortemente a implementação do protocolo PROXY. Quando não há suporte a PROXY disponível, também é possível balancear a carga das portas HTTP e HTTPS usando o cabeçalho X-Forwarded-For.

Habilitar o suporte ao protocolo PROXY no sua instância do GitHub Enterprise Server

É altamente recomendável ativar o suporte ao protocolo PROXY para sua instância e o balanceador de carga. Use as instruções do fornecedor para habilitar o protocolo PROXY no balanceador de carga. Para obter mais informações, confira a documentação do protocolo PROXY.

1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

4. Na barra lateral "Configurações", clique em Privacidade e desmarque modo de privacidade.

5. Em "Balanceadores de carga externos", selecione Habilitar suporte para o protocolo PROXY.

6. Na barra lateral "Configurações", clique em Salvar configurações.

   Observação: se você salvar as configurações no Console de Gerenciamento, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

7. Aguarde a conclusão da execução de suas configurações.

Mapeamentos das portas TCP PROXY

Porta de origem	Porta de destino	Descrição do serviço
22	23	Git em SSH
80	81	HTTP
443	444	HTTPS
8080	8081	HTTP de console de gerenciamento
8443	8444	HTTPS de console de gerenciamento
9418	9419	Git

Habilitar o suporte ao X-Forwarded-For no sua instância do GitHub Enterprise Server

Use o protocolo X-Forwarded-For somente quando o protocolo PROXY não estiver disponível. O cabeçalho X-Forwarded-For é compatível somente com HTTP e HTTPS. Para conexões Git via SSH, o endereço IP informado será o do balanceador de carga. Em alguns ambientes, os endereços IP do cliente no log de auditoria da instância podem aparecer incorretamente como 127.0.0.1.

1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

4. Na barra lateral "Configurações", clique em Privacidade e desmarque modo de privacidade.

5. Em Balanceadores de carga externos, selecione Permitir cabeçalho HTTP X-Forwarded-For.

6. Na barra lateral "Configurações", clique em Salvar configurações.

   Observação: se você salvar as configurações no Console de Gerenciamento, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

7. Aguarde a conclusão da execução de suas configurações.

Mapeamentos de portas TCP para uso sem suporte PROXY

Porta de origem	Porta de destino	Descrição do serviço
22	22	Git em SSH
25	25	SMTP
80	80	HTTP
443	443	HTTPS
8080	8080	HTTP de console de gerenciamento
8443	8443	HTTPS de console de gerenciamento

Configurar verificações de integridade

As verificações de integridade permitem que um balanceador de carga pare de enviar tráfego para um nó que não responde em caso de falha na verificação pré-configurada do nó em questão. Se a instância estiver offline devido a manutenção ou falha inesperada, o balanceador de carga poderá exibir uma página de status. Em configurações de alta disponibilidade (HA), é possível usar balanceadores de carga como parte da estratégia de failover. No entanto, não há suporte para failover automático de pares de HA. Você deve promover manualmente a instância de réplica antes que ela comece a atender às solicitações. Para obter mais informações, confira "Como configurar a alta disponibilidade".

Configure o balanceador de carga para verificar a URL a seguir.

http(s)://HOSTNAME/status

O ponto de extremidade retornará o código de status 200 (OK) se o nó estiver íntegro e disponível para solicitações do usuário final do serviço. Para obter mais informações, confira "Monitorar uma configuração de alta disponibilidade".

Solução de problemas de conectividade por meio de um balanceador de carga

Se não for possível se conectar aos serviços no sua instância do GitHub Enterprise Server por meio de um balanceador de carga, revise as informações a seguir para solucionar o problema.

Erro: "Sua sessão expirou" para conexões com Console de Gerenciamento

Se você habilitar o suporte para o cabeçalho X-Forwarded-For em sua instância e balanceador de carga, talvez não consiga acessar o Console de Gerenciamento de sua instância. Para sabe rmais sobre o Console de Gerenciamento e as portas exigidas nas conexões, confira "Administrar sua instância por meio da interface do usuário da Web" e "Portas de rede".

Se o sua instância do GitHub Enterprise Server indicar que sua sessão expirou quando você se conectar ao Console de Gerenciamento por meio de um balanceador de carga, teste uma das configurações a seguir no balanceador de carga.

• Desabilite os cabeçalhos de X-Forwarded-For para conexões com sua instância nas portas 8080 e 8443.
• Configure o balanceador de carga para operar na Camada 4 e use o protocolo PROXY em vez de X-Forwarded-For para passagem de endereços IP do cliente. Para saber mais, confira "Habilitar o suporte ao protocolo PROXY no sua instância do GitHub Enterprise Server".

Para ver mais informações, confira a documentação do balanceador de carga.

Atualizações dinâmicas de problemas e verificações que não funcionam

Quando o sua instância do GitHub Enterprise Server for acessado por meio de um balanceador de carga ou proxy reverso, as atualizações dinâmicas esperadas, como novos comentários sobre problemas e alterações em notificações ou a saída da execução da verificação, podem não ser exibidas até que a página seja atualizada. Isso é mais comum quando o proxy reverso ou o balanceador de carga está sendo executado em um modo de camada 7 ou não oferece suporte ao protocolo websocket necessário.

Para habilitar atualizações dinâmicas, talvez seja necessário reconfigurar o balanceador de carga ou o proxy. Para ver mais informações, confira a documentação do balanceador de carga.