Сведения о промежуточных экземплярах
GitHub рекомендует настроить отдельную среду для тестирования резервных копий, обновлений или изменений конфигурации для экземпляр GitHub Enterprise Server. Эта среда, которую следует изолировать от рабочих систем, называется промежуточной.
Например, для защиты от потери данных можно регулярно проверять резервную копию рабочего экземпляра. Резервную копию рабочих данных можно регулярно восстанавливать в отдельном экземпляре GitHub Enterprise Server в промежуточной среде. На этом промежуточном экземпляре можно также протестировать обновление до последнего выпуска компонента GitHub Enterprise Server.
Совет. Можно повторно использовать существующий файл лицензии GitHub Enterprise, если промежуточный экземпляр не используется для рабочей среды.
Рекомендации для промежуточной среды
Чтобы тщательно протестировать GitHub Enterprise Server и воссоздать среду, аналогичную рабочей среде, рассмотрите внешние системы, взаимодействующие с вашим экземпляром. Например, может потребоваться протестировать в промежуточной среде следующее.
- Проверка подлинности, особенно при использовании внешнего поставщика проверки подлинности, например, SAML
- Интеграция с внешней системой запросов
- Интеграция с сервером непрерывной интеграции
- Внешние скрипты или программное обеспечение, использующие GitHub Enterprise Server APIs
- Внешний SMTP-сервер для уведомлений по электронной почте
Настройка промежуточного экземпляра
Вы можете настроить промежуточный экземпляр с нуля и настроить экземпляр, как вам нравится. Дополнительные сведения см. в разделах Настройка экземпляра GitHub Enterprise Server и Настройка предприятия.
Кроме того, можно создать промежуточный экземпляр, который отражает вашу рабочую конфигурацию, восстановив резервную копию рабочего экземпляра в промежуточный экземпляр.
- Создайте резервную копию рабочего экземпляра.
- Настройка промежуточного экземпляра.
- Настройка GitHub Actions.
- Настройка GitHub Packages.
- Восстановите рабочую резервную копию.
- Проверьте конфигурацию экземпляра.
- Примените конфигурацию экземпляра.
1. Резервное копирование рабочего экземпляра
Если вы хотите протестировать изменения в экземпляре, который содержит те же данные и конфигурацию, что и рабочий экземпляр, создайте резервную копию данных и конфигурации из рабочего экземпляра с помощью GitHub Enterprise Server Backup Utilities. Дополнительные сведения см. в разделе Настройка резервных копий на устройстве.
Предупреждение. Если вы используете GitHub Actions или GitHub Packages в рабочей среде, резервная копия будет включать рабочую конфигурацию для внешнего хранилища. Чтобы избежать возможной потери данных при записи в рабочее хранилище из промежуточного экземпляра, перед восстановлением резервной копии необходимо настроить каждую функцию на шагах 3 и 4.
2. Настройка промежуточного экземпляра
Настройте новый экземпляр для использования в качестве промежуточной среды. Вы можете использовать для подготовки и установки промежуточного экземпляра те же инструкции, что и в случае с рабочим экземпляром. Дополнительные сведения см. в разделе Настройка экземпляра GitHub Enterprise Server.
Если вы планируете восстановить резервную копию рабочего экземпляра, перейдите к следующему шагу. Кроме того, можно настроить экземпляр вручную и пропустить следующие действия.
3. Настройка GitHub Actions
При необходимости, если вы используете GitHub Actions в рабочем экземпляре, настройте функцию в промежуточном экземпляре перед восстановлением рабочей резервной копии. Если вы не используете GitHub Actions, перейдите к разделу "4. Настройка GitHub Packages".
Предупреждение. Если вы не настроите GitHub Actions на промежуточном экземпляре перед восстановлением рабочей резервной копии, промежуточный экземпляр будет использовать внешнее хранилище рабочего экземпляра, что может привести к потере данных. Мы настоятельно рекомендуем использовать другое внешнее хранилище для промежуточного экземпляра. Дополнительные сведения см. в разделе Использование промежуточной среды.
-
Подключение по протоколу SSH к промежуточному экземпляру. Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).
Shell $ ssh -p 122 admin@HOSTNAME
-
Чтобы настроить промежуточный экземпляр для использования внешнего поставщика хранилища для GitHub Actions, введите одну из следующих команд.
-
Хранилище BLOB-объектов Azure:
Shell ghe-config secrets.actions.storage.blob-provider "azure"
-
Amazon S3:
Shell ghe-config secrets.actions.storage.blob-provider "s3" ``` 1. Настройте подключение к внешнему хранилищу, введя следующие команды, заменив значения заполнителей фактическими значениями для подключения.
-
Хранилище BLOB-объектов Azure:
Shell ghe-config secrets.actions.storage.azure.connection-string "CONNECTION STRING"
-
Amazon S3:
Shell ghe-config secrets.actions.storage.s3.bucket-name "S3 BUCKET NAME" ghe-config secrets.actions.storage.s3.service-url "S3 SERVICE URL" ghe-config secrets.actions.storage.s3.access-key-id "S3 ACCESS KEY ID" ghe-config secrets.actions.storage.s3.access-secret "S3 ACCESS SECRET"
При необходимости, чтобы принудительно применить адресацию в стиле пути для S3, также введите следующую команду.
Shell ghe-config secrets.actions.storage.s3.force-path-style true
-
-
Чтобы подготовиться к включению GitHub Actions на промежуточном экземпляре, введите следующую команду.
Shell ghe-config app.actions.enabled true
4. Настройка GitHub Packages
При необходимости, если вы используете GitHub Packages в рабочем экземпляре, настройте функцию в промежуточном экземпляре перед восстановлением рабочей резервной копии. Если вы не используете GitHub Packages, перейдите к разделу "5. Восстановите рабочую резервную копию".
Предупреждение. Если вы не настроите GitHub Packages на промежуточном экземпляре перед восстановлением рабочей резервной копии, промежуточный экземпляр будет использовать внешнее хранилище рабочего экземпляра, что может привести к потере данных. Мы настоятельно рекомендуем использовать другое внешнее хранилище для промежуточного экземпляра.
-
Просмотрите резервную копию, восстановленную в промежуточном экземпляре.
- Если вы сделали резервную копию с GitHub Enterprise Server Backup Utilities 3.5 или более поздней версии, она включает конфигурацию для GitHub Packages. Перейдите к следующему шагу.
- Если вы сделали резервную копию с GitHub Enterprise Server Backup Utilities 3.4 или более ранней версии, настройте GitHub Packages в промежуточном экземпляре. Дополнительные сведения см. в разделе Начало работы с GitHub Packages для вашего предприятия.
-
Подключение по протоколу SSH к промежуточному экземпляру. Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).
Shell $ ssh -p 122 admin@HOSTNAME
-
Настройте подключение к внешнему хранилищу, введя следующие команды, заменив значения заполнителей фактическими значениями для подключения.
-
Хранилище BLOB-объектов Azure:
Shell ghe-config secrets.packages.blob-storage-type "azure" ghe-config secrets.packages.azure-container-name "AZURE CONTAINER NAME" ghe-config secrets.packages.azure-connection-string "CONNECTION STRING"
-
Amazon S3:
Shell ghe-config secrets.packages.blob-storage-type "s3" ghe-config secrets.packages.service-url "S3 SERVICE URL" ghe-config secrets.packages.s3-bucket "S3 BUCKET NAME" ghe-config secrets.packages.aws-access-key "S3 ACCESS KEY ID" ghe-config secrets.packages.aws-secret-key "S3 ACCESS SECRET"
-
-
Чтобы подготовиться к включению GitHub Packages в промежуточном экземпляре, введите следующую команду.
Shell ghe-config app.packages.enabled true
5. Восстановление рабочей резервной копии
Используйте команду , ghe-restore
чтобы восстановить остальные данные из резервной копии. Дополнительные сведения см. в разделе Настройка резервных копий на устройстве.
Если промежуточный экземпляр уже настроен и вы хотите перезаписать параметры, данные сертификата и лицензии, добавьте -c
параметр в команду . Дополнительные сведения о параметре см. в разделе Использование команд резервного копирования и восстановления документации по GitHub Enterprise Server Backup Utilities.
6. Проверка конфигурации экземпляра
Чтобы получить доступ к промежуточному экземпляру с тем же именем узла, обновите локальный файл hosts, чтобы разрешить имя узла промежуточного экземпляра по IP-адресу, изменив /etc/hosts
файл в macOS или Linux или C:\Windows\system32\drivers\etc
файл в Windows.
Примечание. Промежуточный экземпляр должен быть доступен из того же имени узла, что и рабочий экземпляр. Изменение имени узла для экземпляр GitHub Enterprise Server не поддерживается. Дополнительные сведения см. в разделе Настройка имени узла.
Затем проверьте конфигурацию промежуточного экземпляра в Консоль управления. Дополнительные сведения см. в разделе Администрирование экземпляра из консоли управления.
Предупреждение. Если вы настроили GitHub Actions или GitHub Packages для промежуточного экземпляра, во избежание перезаписи рабочих данных убедитесь, что конфигурация внешнего хранилища в Консоль управления не соответствует рабочему экземпляру.
7. Применение конфигурации экземпляра
Чтобы применить конфигурацию из Консоль управления, нажмите кнопку Сохранить параметры.