Изменение имени узла для экземпляра

Если вы хотите изменить имя узла для существующего экземпляра GitHub Enterprise Server, необходимо восстановить параметры и данные в новом экземпляре.

В этой статье

Сведения об изменениях имени узла для GitHub Enterprise Server

Если необходимо использовать новое имя узла для ваш экземпляр GitHub Enterprise Server, необходимо создать резервную копию параметров и данных существующего экземпляра, настроить новый экземпляр, восстановить резервную копию в новом экземпляре, а затем настроить конфигурацию DNS для отправки трафика в новый экземпляр.

Для миграции на новый экземпляр требуется простой. Время простоя зависит от объема данных, необходимых для резервного копирования, а также скорости сетевого подключения между узлом резервного копирования и экземплярами.

В этой статье термин "исходный экземпляр" относится к экземпляру со старым именем узла и "конечным экземпляром" относится к экземпляру с новым именем узла.

Warning

Не изменяйте имя узла для GitHub Enterprise Server после начальной настройки. Изменение имени узла приведет к непредвиденному поведению, вплоть до сбоя экземпляров и недопустимости ключей безопасности пользователей. Если вы изменили имя узла для экземпляра и столкнулись с проблемами, обратитесь к Поддержка GitHub Enterprise или Сведения о поддержке уровня "Премиум" GitHub.

Миграция на экземпляр с новым именем узла

  1. Настройте целевой экземпляр GitHub Enterprise Server с новым именем узла, который вы хотите использовать. Дополнительные сведения см. в следующей документации.

  2. Сообщите пользователям экземпляра о запланированном простое. При необходимости можно создать обязательное сообщение, которое будет отображаться для всех пользователей, которые войдут в систему. Дополнительные сведения см. в разделе "Настройка пользовательских сообщений для вашей организации".

  3. В исходном экземпляре включите режим обслуживания, чтобы предотвратить возникновение разностных изменений. Дополнительные сведения см. в разделе Включение и планирование режима обслуживания.

  4. Резервное копирование данных и параметров исходного экземпляра с помощью GitHub Enterprise Server Backup Utilities. Дополнительные сведения см. в разделе Настройка резервных копий в экземпляре. (Для завершения этого шага может потребоваться до нескольких часов.)

  5. Если в исходном экземпляре включен GitHub Actions, необходимо настроить внешний поставщик хранилища для GitHub Actions в целевом экземпляре. См . раздел AUTOTITLE.

  6. В целевом экземпляре включите режим обслуживания, чтобы разрешить восстановление резервной копии, взятой из исходного экземпляра.

  7. Восстановите резервную копию в целевом экземпляре с требуемым именем узла. ghe-restore Запустите программу без -c параметра, чтобы предотвратить перезапись конфигурации конечного экземпляра. См . раздел AUTOTITLE.

  8. Завершите настройку конечного экземпляра. Дополнительные сведения см. в разделе Настройка GitHub Enterprise.

  9. При необходимости, пока целевой экземпляр находится в режиме обслуживания, проверьте конфигурацию и журнал выполнения конфигурации экземпляра (/data/user/common/ghe-config.log) и убедитесь, что пользовательские данные не сохраняются. Дополнительные сведения см. в разделе Включение и планирование режима обслуживания.

  10. Чтобы направить трафик к целевому экземпляру, обновите запись DNS CNAME с именем узла исходного экземпляра, чтобы разрешить IP-адрес целевого экземпляра.

    Note

    Восстановленное содержимое, созданное пользователем в веб-приложении экземпляра, скорее всего, будет содержать URL-адреса, ссылающиеся на старое имя узла исходного экземпляра. При необходимости, чтобы эти ссылки продолжали разрешаться в целевом экземпляре, можно настроить перенаправление с помощью DNS. Помимо CNAME записи, разрешающей имя узла нового экземпляра, настройте вторую запись DNS CNAME , которая направляет трафик из исходного имени узла в новое имя узла. Дополнительные сведения см. в документации для поставщика DNS.

  11. В целевом экземпляре отключите режим обслуживания.