Configurando o nome do host para sua instância

Sobre o nome do host para o GitHub Enterprise Server

Para fornecer acesso confiável ao sua instância do GitHub Enterprise Server por meio de um nome conhecido na rede, você pode configurar um nome de host. Se você configurar um nome de host em vez de usar um endereço IP codificado, poderá alterar o hardware físico em que o sua instância do GitHub Enterprise Server é executado sem afetar os usuários ou o software cliente.

A configuração do nome de host no Console de Gerenciamento deve ser definida como um nome de domínio totalmente qualificado (FQDN) que seja resolvido na internet ou dentro da sua rede interna. Por exemplo, sua configuração de nome do host pode ser github.companyname.com. na Web, e as solicitações de API redirecionarão automaticamente para o nome do host configurado no Console de Gerenciamento. Observe que localhost não é uma configuração de nome de host válida.

Os nomes de host devem ter menos de 63 caracteres de comprimento por Seção 2.3.4 da RFC de Especificação de Nomes de Domínio.

Depois de configurar um nome do host, você pode habilitar o isolamento de subdomínio para aumentar ainda mais a segurança do sua instância do GitHub Enterprise Server. Para obter mais informações, confira "Habilitar isolamento de subdomínio".

A GitHub recomenda que você não altere o nome do host de uma instância existente do GitHub Enterprise Server. Alterar o nome do host causará comportamento inesperado, até e incluindo falhas de instância. Em vez disso, configure uma nova instância com o nome de host desejado e, em seguida, restaure as configurações e os dados da instância original para a nova instância.

Para obter mais informações sobre os tipos de nomes do host compatíveis, confira a Seção 2.1 do RFC HTTP.

Configurando o nome do host

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 Nome de host.

5. Em "Nome do host", digite o nome do host que deseja definir para o sua instância do GitHub Enterprise Server.

6. Para testar as configurações de DNS e SSL para o novo nome do host, clique em Testar configurações de domínio.

7. Se você não receber uma marca de seleção verde ao lado de todas as entradas, reveja a sua configuração para a configuração que falhou. Para obter mais informações, confira "Configurar servidores de nomes DNS".

8. 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.

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

Para ajudar a atenuar várias vulnerabilidades de cross-site scripting, recomendamos que você habilite o isolamento de subdomínio para o sua instância do GitHub Enterprise Server depois de configurar um nome do host. Para obter mais informações, confira "Habilitar isolamento de subdomínio".

Alternado o nome do host

Se você precisar alterar o nome do host do sua instância do GitHub Enterprise Server, deverá restaurar um backup da instância existente para uma nova instância com o nome de host desejado. Para obter mais informações, confira "Alterando o nome do host da sua instância".