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

Вы можете настроить экземпляр в отдельной 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/configuring-settings).

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

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

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

Если вы хотите протестировать изменения в экземпляре, содержающем те же данные и конфигурацию, что и рабочий экземпляр, создайте резервную копию данных и конфигурации из рабочего экземпляра.GitHub Enterprise Server Backup Utilities Дополнительные сведения см. в разделе Настройка резервных копий на вашем экземпляре с помощью 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 пакеты, отметив галочку Enable GitHub Packages.
  4. В разделе "Параметры хранилища пакетов" выберите внешний поставщик хранилища.
  5. Проверьте конфигурацию хранилища, щелкнув параметры тестового хранилища.
  6. Нажмите кнопку " Сохранить параметры" , чтобы применить конфигурацию.

Примечание.

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

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

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

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

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

Чтобы получить доступ к staging экземпляру с тем же именем хоста, обновите файл локальных хостов, чтобы разрешить имя хоста staging по 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

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