Alterando o nome do host da sua instância

Se quiser alterar o nome do host de uma instância existente do GitHub Enterprise Server, você deverá restaurar as configurações e os dados em uma nova instância.

Neste artigo

Sobre alterações no nome do host para o GitHub Enterprise Server

Se você precisar usar um novo nome de host para o sua instância do GitHub Enterprise Server, deverá fazer backup das configurações e dos dados da instância existente, configurar uma nova instância, restaurar o backup para a nova instância e, em seguida, ajustar a configuração de DNS para enviar o tráfego à nova instância.

A migração para uma nova instância requer tempo de inatividade. A quantidade de tempo de inatividade necessária depende da quantidade de dados que você precisa copiar para backup, bem como da velocidade da conexão de rede entre o host de backup e as instâncias.

Neste artigo, o termo "instância de origem" refere-se à instância com o nome de host antigo, e "instância de destino" refere-se à instância com o novo nome de host.

Warning

Não altere o nome do host do GitHub Enterprise Server após a configuração inicial. Alterar o nome do host causará comportamento inesperado, até e incluindo falhas de instância e invalidação das chaves de segurança dos usuários. Se você alterou o nome do host da instância e está enfrentando problemas, entre em contato com Suporte do GitHub Enterprise ou Suporte do GitHub Premium.

Migração para uma instância com um novo nome de host

  1. Configure uma instância de destino do GitHub Enterprise Server com o novo nome de host que você deseja usar. Para saber mais, confira a seguinte documentação.

  2. Informe os usuários da instância sobre o tempo de inatividade programado. Opcionalmente, você pode criar uma mensagem obrigatória que será exibida para todos os usuários que fizerem login. Para saber mais, confira Como personalizar mensagens de usuário para sua empresa.

  3. Na instância de origem, habilite o modo de manutenção. Para saber mais, confira Habilitar e programar o modo de manutenção.

  4. Faça backup dos dados e das configurações da instância de origem usando o GitHub Enterprise Server Backup Utilities. Para saber mais, confira Como configurar backups em sua instância.

  5. Restaure o backup na instância de destino com o nome de host desejado. Quando executar o utilitário ghe-restore, use a opção -c para substituir a configuração da instância de destino. Para saber mais, confira Como configurar backups em sua instância.

  6. Finalize a configuração da instância de destino. Para saber mais, confira Configurar o GitHub Enterprise.

  7. Na instância de destino, habilite o modo de manutenção.

  8. Opcionalmente, enquanto a instância de destino estiver no modo de manutenção, valide sua configuração e verifique se os dados do usuário estão intactos. Para saber mais, confira Habilitar e programar o modo de manutenção.

  9. Para direcionar o tráfego à instância de destino, atualize o registro DNS CNAME com o nome de host da instância de origem para resolver o endereço IP da instância de destino.

    Note

    O conteúdo restaurado gerado pelo usuário no aplicativo Web da instância provavelmente conterá URLs que referenciam o nome do host antigo da instância de origem. Opcionalmente, para garantir que esses links continuem a ser resolvidos para a instância de destino, você pode configurar um redirecionamento usando o DNS. Além do registro CNAME que é resolvido para o nome de host da nova instância, configure um segundo registro DNS CNAME que direcione o tráfego do nome de host original ao novo nome de host. Para obter mais informações, consulte a documentação do seu provedor de DNS.

  10. Na instância de destino, desabilite o modo de manutenção.