Установка GitHub Enterprise Server на Hyper-V

Необходимые компоненты

• Необходим файл лицензии GitHub Enterprise. Дополнительные сведения см. в разделе [AUTOTITLE и Настройка пробной версии GitHub Enterprise Server](/billing/concepts/enterprise-billing/ghes-license-files).
• У вас должен быть Windows Server 2008 — Windows Server 2022, который поддерживает Hyper-V.
• Большинство действий, необходимых для создания виртуальной машины (VM), также могут выполняться с помощью Hyper-V Manager. Однако мы рекомендуем использовать командную строку Windows PowerShell для начальной настройки. Примеры использования PowerShell приведены ниже. Для получения дополнительной информации смотрите руководство Microsoft Начало работы с Windows PowerShell.

Рекомендации по оборудованию

• Минимальные рекомендуемые требования
• Память
• ЦП и память

Минимальные рекомендуемые требования

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

Лицензии пользователей	Виртуальные ЦП x86-64	Память	Корневое хранилище	Подключенное хранилище (данные)	ОПЕРАЦИЙ ВВОДА-ВЫВОДА
Пробная версия, демонстрационная версия или 10 облегченных пользователей	4	32 Гб	400 ГБ	500 ГБ	600
До 1000	8	48 ГБ	400 ГБ	500 ГБ	3000
1000 до 3000	16	64 ГБ	400 ГБ	1000 ГБ	6000
От 3000 до 5000	32	128 ГБ	400 ГБ	1500 ГБ	9000
5 000 до 8 000	48	256 ГБ	400 ГБ	3000 ГБ	12 000
от 8000 до 10000 и выше	64	512 ГБ	400 ГБ	5000 ГБ	15000

Если вы планируете включить GitHub Actions или GitHub Advanced Security для пользователей экземпляра, требуются дополнительные ресурсы.

• GitHub Actions — увеличьте объем ЦП и памяти по крайней мере на 25 %
• GitHub Advanced Security — увеличьте объем ЦП и памяти по крайней мере на 25 %

Эти корректировки должны применяться к базовым требованиям для каждого уровня пользователей. Рекомендуется отслеживать все изменения ресурсов, так как может потребоваться дальнейшее увеличение.

Дополнительные сведения об этих требованиях см. в разделе Начало работы с GitHub Actions for GitHub Enterprise Server.

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

Дополнительные сведения о настройке ресурсов для существующего экземпляра см. в разделе [AUTOTITLE и Увеличение емкости хранилища](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources).

Хранилище

Рекомендуется использовать высокопроизводительный SSD с высокой скоростью операций ввода-вывода в секунду (IOPS) и низкой задержкой для GitHub Enterprise Server. Рабочие нагрузки интенсивно используют ввод-вывод. Если используется гипервизор без операционной системы, рекомендуется напрямую подключить диск или использовать диск из сети хранения данных (SAN).

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

Чтобы настроить GitHub Actions, необходимо предоставить внешнее хранилище BLOB-объектов. Дополнительные сведения см. в разделе Начало работы с GitHub Actions for GitHub Enterprise Server.

Доступное пространство в корневой файловой системе будет составлять 50 % от общего размера диска. Можно изменить размер корневого диска экземпляра, создав новый экземпляр или используя существующий. Дополнительные сведения см. в разделе [AUTOTITLE и Обзор системы](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity).

ЦП и память

Ресурсы ЦП и памяти, необходимые GitHub Enterprise Server, зависят от уровней действий пользователей, автоматизации и интеграции.

Все виртуальные машины, подготовленные для ваш экземпляр GitHub Enterprise Server, должны использовать архитектуру ЦП x86-64. Другие архитектуры не поддерживаются, например AArch64 или arm64.

Если планируется включить GitHub Actions для пользователей экземпляра GitHub Enterprise Server, может потребоваться подготовка дополнительных ресурсов ЦП и памяти для экземпляра. Дополнительные сведения см. в разделе Начало работы с GitHub Actions for GitHub Enterprise Server.

При увеличении ресурсов ЦП GitHub рекомендует добавлять не менее 6,5 ГБ памяти для каждого виртуального ЦП (до 16 виртуальных ЦП), которые вы подготавливаете для экземпляра. Если используется более 16 виртуальных ЦП, вам не нужно добавлять 6,5 ГБ памяти для каждого виртуального ЦП, но необходимо отслеживать экземпляр, чтобы обеспечить достаточный объем памяти.

Дополнительные сведения о мониторинге емкости и производительности GitHub Enterprise Serverсм. в разделе Мониторинг экземпляра.

Ресурсы ЦП или памяти экземпляра можно увеличить. Дополнительные сведения см. в разделе Увеличение ресурсов ЦП или памяти.

Следует ли использовать VMotion?

VMotion может быть исключительно полезным для общего управления ресурсами, однако влияние на гостевой экземпляр может быть значительным. При использовании более крупных экземпляров данных GitHub Enterprise Server (8 ЦП/64 ГБ ОЗУ и выше) событие VMotion может привести к полному сбою GitHub Enterprise Server для конечных пользователей в результате резкого сокращения ЦП, ОЗУ и операций ввода-вывода в секунду хранилища. Учитывая это, GitHub Enterprise Server следует считать приложением с высокой задержкой.

Для крупных развертываний (r) в VMWare с включенным планировщиком распределенных ресурсов (DRS) рекомендуется настроить правило сходства между виртуальными машинами для GitHub Enterprise Server для попытки и сохранения виртуального устройства на одном узле. Если требуется миграция с помощью VMotion, рекомендуется рассмотреть эту "плановую сбой" и поместить GitHub Enterprise Server в режим обслуживания до завершения миграции.

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

Скачивание образа GitHub Enterprise Server

1. Скачайте лицензию. Дополнительные сведения см. в разделе Скачивание лицензии для GitHub Enterprise.

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

   • Перейдите к заметкам о выпуске.
   • На правой боковой панели щелкните версию, которую вы хотите скачать.
   • Щелкните Скачать GitHub Enterprise Server X.X.X.

3. В разделе «GitHub On-premises» выберите выпадающее меню «Выбрать гипервизор» и нажмите Hyper-V (VHD).

4. Нажмите Скачать для Hyper-V (VHD).

Создание экземпляра GitHub Enterprise Server

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

1. В PowerShell создайте новую виртуальную машину поколения 1, настройте размер на основе количества лицензий пользователя и подключите скачанный образ GitHub Enterprise Server. Дополнительные сведения см . в документации Майкрософт по новой виртуальной машине .

   PS C:\> New-VM -Generation 1 -Name VM_NAME -MemoryStartupBytes MEMORY_SIZE -BootDevice VHD -VHDPath PATH_TO_VHD  
   

2. Создайте новый виртуальный диск для использования в качестве подключенного тома хранилища для данных экземпляра и настройте размер в соответствии с количеством лицензий пользователей. Если повторно используется существующий диск, убедитесь, что диск пуст и нет секций. Замените PATH_TO_DATA_DISK на путь к расположению, в котором создается диск. Дополнительные сведения см. в документации Майкрософт по New-VHD .

   PS C:\> New-VHD -Path PATH_TO_DATA_DISK -SizeBytes DISK_SIZE
   

3. Подключите диск данных к вашему экземпляру. Дополнительные сведения см. в документации Майкрософт по add-VMHardDiskDrive .

   PS C:\> Add-VMHardDiskDrive -VMName VM_NAME -Path PATH_TO_DATA_DISK
   

4. Запустите виртуальную машину. Дополнительные сведения см. в документации майкрософт по начальной виртуальной машине .

   PS C:\> Start-VM -Name VM_NAME
   

5. Получите IP-адрес вашей виртуальной машины. Дополнительные сведения см. в документации Майкрософт по Get-VMNetworkAdapter .

   PS C:\> (Get-VMNetworkAdapter -VMName VM_NAME).IpAddresses
   

6. Скопируйте IP-адрес виртуальной машины и вставьте его в веб-браузер.

Настройка экземпляра GitHub Enterprise Server

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

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

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

• Обзор системы
• Сведения об обновлении до новых выпусков