Configurando o nome do host para sua instância

Sobre o nome do host para GitHub Enterprise Server

Para fornecer acesso confiável por sua instância do GitHub Enterprise Server 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 executado sua instância do GitHub Enterprise Server sem afetar os usuários ou o software cliente.

A configuração de nome de host em Console de Gerenciamento deve ser definida como um nome de domínio totalmente qualificado (FQDN) apropriado, que possa ser resolvido na internet ou em sua rede interna. Por exemplo, sua configuração de nome de host pode ser github.companyname.com. Web e solicitações de API serão redirecionadas 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 de host, você pode habilitar o isolamento de subdomínio para aumentar ainda mais a segurança de sua instância do GitHub Enterprise Server. Para saber mais, confira Habilitar isolamento de subdomínio.

GitHub recomenda fortemente que você não altere o nome do host para uma instância existente 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 " Site admin", 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 para o qual você gostaria de definir 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 não aparecer uma marca de verificação verde ao lado de todos os itens, revise a configuração da opção que falhou. Para saber mais, 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 mitigar várias vulnerabilidades de cross-site scripting, recomendamos que você habilite o isolamento de subdomínio para sua instância do GitHub Enterprise Server após configurar um nome de host. Para saber mais, confira Habilitar isolamento de subdomínio.

Alternado o nome do host

Se você precisar alterar o nome do host, sua instância do GitHub Enterprise Serverserá necessário restaurar um backup da instância existente para uma nova instância com o nome do host desejado. Para saber mais, confira Alterando o nome do host da sua instância.