Настройка промежуточного экземпляра

Вы можете настроить экземпляр GitHub Enterprise Server в отдельной изолированной среде и использовать экземпляр для проверки и тестирования изменений.

В этой статье

Сведения о промежуточных экземплярах

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

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

Совет

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

Рекомендации для промежуточной среды

Чтобы тщательно протестировать GitHub Enterprise Server и повторно создать среду, аналогичную рабочей среде, рассмотрите внешние системы, взаимодействующие с вашим экземпляром. Например, может потребоваться протестировать в промежуточной среде следующее.

  • Проверка подлинности, особенно при использовании внешнего поставщика проверки подлинности, например, SAML
  • Интеграция с внешней системой запросов
  • Интеграция с сервером непрерывной интеграции
  • Внешние скрипты или программное обеспечение, использующие GitHub Enterprise Server APIs
  • Внешний SMTP-сервер для уведомлений по электронной почте

Настройка промежуточного экземпляра

Вы можете настроить промежуточный экземпляр с нуля и настроить экземпляр. Дополнительные сведения см. в разделе [AUTOTITLE и Настройка экземпляра GitHub Enterprise Server](/admin/configuration/configuring-your-enterprise).

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

  1. Резервное копирование рабочего экземпляра.
  2. Настройте промежуточный экземпляр.
  3. Настройте GitHub Actions.
  4. Настройте GitHub Packages.
  5. Восстановите рабочую резервную копию.
  6. Просмотрите конфигурацию экземпляра.
  7. Примените конфигурацию экземпляра.

1. Резервное копирование рабочего экземпляра

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

Предупреждение

При использовании GitHub Actions или GitHub Packages в рабочей среде резервная копия будет включать рабочую конфигурацию для внешнего хранилища. Чтобы избежать потенциальной потери данных путем записи в рабочее хранилище из промежуточный экземпляр, необходимо настроить каждую функцию в шагах 3 и 4 перед восстановлением резервной копии.

2. Настройка промежуточный экземпляр

Настройте новый экземпляр для использования в качестве промежуточной среды. При выполнении процесса установки обязательно выберите параметр "Создать установку****". Это обеспечит правильную инициализацию промежуточной среды и готова к восстановлению резервной копии при необходимости.

Вы можете использовать для подготовки и установки промежуточного экземпляра те же инструкции, что и в случае с рабочим экземпляром. Дополнительные сведения см. в разделе Настройка экземпляра GitHub Enterprise Server.

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

Предупреждение

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

3. Настройка GitHub Actions

При необходимости, если вы используете GitHub Actions в рабочем экземпляре, настройте функцию в промежуточный экземпляр перед восстановлением рабочей резервной копии. Если вы не используете GitHub Actions, перейдите к разделу "Настройка GitHub Packages".

Чтобы настроить GitHub Actions в промежуточный экземпляр, используйте Консоль управления.

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

Предупреждение

Если вы не настроите GitHub Actions на промежуточный экземпляр перед восстановлением рабочей резервной копии, промежуточный экземпляр будет использовать внешнее хранилище экземпляра рабочей среды, что может привести к потере данных. Настоятельно рекомендуется использовать другое внешнее хранилище для промежуточный экземпляр. Дополнительные сведения см. в разделе Использование промежуточной среды.

  1. Доступ к данным Консоль управления. См . раздел AUTOTITLE.

  2. На боковой панели откройте вкладку "Действия ".

  3. Включите GitHub Actions путем включения GitHub Actions.

  4. Выберите внешний поставщик хранилища для артефактов и хранилища журналов.

  5. Введите необходимые сведения о хранилище и проверке подлинности для выбранного поставщика.

  6. Проверьте конфигурацию, нажав кнопку "Тестировать параметры хранилища", а затем нажмите кнопку "Сохранить параметры".

После настройки и включения GitHub Actionsперейдите к следующему шагу.

4. Настройка GitHub Packages

Если вы используете GitHub Packages в рабочем экземпляре, настройте функцию на промежуточный экземпляр перед восстановлением рабочей резервной копии. Если вы не используете GitHub Packages, перейдите к разделу "Восстановить рабочую резервную копию".

Предупреждение

Если вы не настроите GitHub Packages на промежуточный экземпляр перед восстановлением рабочей резервной копии, промежуточный экземпляр будет использовать внешнее хранилище экземпляра рабочей среды, что может привести к потере данных. Настоятельно рекомендуется использовать другое внешнее хранилище для промежуточный экземпляр. Дополнительные сведения см. в разделе Использование промежуточной среды.

Чтобы настроить GitHub Packages для промежуточный экземпляр:

  1. Доступ к данным Консоль управления. Ознакомьтесь с доступом к консоли управления.
  2. На боковой панели откройте вкладку "Пакеты ".
  3. Включите пакеты GitHub, установив флажок "Включить пакеты GitHub".
  4. В разделе "Параметры хранилища пакетов" выберите внешний поставщик хранилища.
  5. Проверьте конфигурацию хранилища, щелкнув параметры тестового хранилища.
  6. Нажмите кнопку " Сохранить параметры" , чтобы применить конфигурацию.

Примечание.

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

5. Восстановление рабочей резервной копии

ghe-restore Используйте команду для восстановления остальных данных из резервной копии. Дополнительные сведения см. в разделе Настройка резервных копий в экземпляре с помощью служебных программ резервного копирования.

Если промежуточный экземпляр уже настроен и вы хотите перезаписать параметры, сертификаты и данные лицензии, добавьте -c этот параметр в команду. Дополнительные сведения о параметре см. в разделе "Использование команд резервного копирования и восстановления" в документации по GitHub Enterprise Server Backup Utilities.

6. Проверка конфигурации экземпляра

Чтобы получить доступ к промежуточный экземпляр с тем же именем узла, обновите файл локальных узлов, чтобы разрешить имя узла промежуточный экземпляр по IP-адресу, изменив /etc/hosts файл в macOS или Linux или C:\Windows\system32\drivers\etc файл в Windows.

Примечание.

Ваш промежуточный экземпляр должен быть доступен из того же имени узла, что и рабочий экземпляр. Изменение имени узла для ваш экземпляр GitHub Enterprise Server не поддерживается. Дополнительные сведения см. в разделе Настройка имени узла для экземпляра.

Затем просмотрите конфигурацию промежуточный экземпляр в Консоль управления. Дополнительные сведения см. в разделе Администрирование экземпляра из веб-интерфейса.

Предупреждение

Если вы настроили GitHub Actions или GitHub Packages для промежуточный экземпляр, чтобы избежать перезаписи рабочих данных, убедитесь, что конфигурация внешнего хранилища в Консоль управления не соответствует рабочему экземпляру.

7. Применение конфигурации экземпляра

Чтобы применить конфигурацию из Консоль управления, нажмите кнопку "Сохранить параметры".

Возвращение промежуточный экземпляр обратно в интернет

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

Экземпляр может оставаться в автономном режиме в течение 60 дней.

При возврате экземпляра в режиме автономного времени GitHub Enterprise Server успешно создает экземпляр. Если экземпляр находится в автономном режиме дольше допустимого периода, GitHub Enterprise Server не удалось создать экземпляр, а сообщение об ошибке с текстом server has been offline for more than the configured server_rejoin_age_max может появиться в системных журналах. См . раздел AUTOTITLE.

Если экземпляр завис в состоянии ошибки, можно выполнить эти команды для восстановления.

sudo mv /data/user/consul/server_metadata.json /data/user/consul/server_metadata.json.bak
ghe-config-apply

Дополнительные материалы