Установка сервера GitHub Enterprise на OpenStack KVM

Предварительные требования

• Необходим файл лицензии GitHub Enterprise. Дополнительные сведения см. в разделах Настройка пробной версии GitHub Enterprise Server и Сведения о лицензиях для GitHub Enterprise.
• У вас должен быть доступ к установке OpenStack Horizon, пользовательского веб-интерфейса к службам OpenStack. Дополнительные сведения см. в статье Документация по Horizon.

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

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

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

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

Пользовательские лицензии	Число виртуальных ЦП	Память	Корневое хранилище	Подключенное хранилище (данные)
Пробная версия, демонстрационная версия или 10 облегченных пользователей	4	32 ГБ	200 ГБ	150 ГБ
от 10 до 3000	8	48 ГБ	200 Мб	300 ГБ
от 3000 до 5000	12	64 ГБ	200 ГБ	500 ГБ
от 5000 до 8000	16	96 ГБ	200 ГБ	750 ГБ
от 8000 до 10000 и выше	20	160 ГБ	200 ГБ	1000 ГБ

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

Число виртуальных ЦП	Память	Максимальный параллелизм
8	64 ГБ	300 заданий
16	128 ГБ	700 заданий
32	160 ГБ	1300 заданий
64	256 ГБ	2000 заданий
96	384 ГБ	4000 заданий

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

Дополнительные сведения о настройке ресурсов для существующего экземпляра см. в разделах Увеличение емкости хранилища и Увеличение ресурсов ЦП или памяти.

Память

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

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

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

Доступное пространство в корневой файловой системе будет составлять 50 % от общего размера диска. Можно изменить размер корневого диска экземпляра, создав новый экземпляр или используя существующий. Дополнительные сведения см. в разделе Обзор системы и Увеличение емкости хранилища.

ЦП и память

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

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

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

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

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

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

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

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

2. В локальной среде "GitHub" выберите раскрывающееся меню "Выберите свой гипервизор" и нажмите кнопку OpenStack KVM (QCOW2) .

3. Нажмите Скачать OpenStack KVM (QCOW2) .

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

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

1. В OpenStack Horizon отправьте скаченный вами образ GitHub Enterprise Server. Инструкции см. в разделе "Отправка образа" руководства OpenStack "Отправка образов и управление ими".

2. Создайте новый виртуальный диск для использования в качестве подключенного тома хранилища для данных экземпляра и настройте размер в соответствии с количеством лицензий пользователей. Инструкции см. в руководстве OpenStack "Создание томов и управление ими".

3. Создайте группу безопасности и добавьте новое правило группы безопасности для каждого порта в таблице ниже. Инструкции см. в руководстве OpenStack "Настройка доступа и безопасности для экземпляров".

   Порт	Служба	Описание
   22	SSH	Доступ к Git по протоколу SSH. Клонирование, получение и отправка операций в поддерживаемые общедоступные и частные репозитории.
   25	SMTP	Поддержка SMTP с шифрованием (STARTTLS).
   80	HTTP	Доступ к веб-приложениям. Все запросы перенаправляются на HTTPS-порт при включении SSL.
   122	SSH	Доступ к оболочке экземпляра. Порт SSH по умолчанию (22) предназначен для сетевого трафика Git+SSH приложения.
   161/UDP	SNMP	Требуется для работы протокола мониторинга сети.
   443	HTTPS	Доступ к веб-приложению и Git по протоколу HTTPS.
   1194/UDP	VPN	Безопасный туннель сети репликации в конфигурации высокого уровня доступности.
   8080	HTTP	Веб-сайт на основе обычного текста Консоль управления. Не требуется, если только SSL не отключен вручную.
   8443	HTTPS	Безопасный веб-доступ Консоль управления. Требуется для базовой установки и настройки.
   9418	Git	Простой порт протокола Git. Клонирование и получение операций только в общедоступные репозитории. Взаимодействие по сети без шифрования Если в вашем экземпляре включен частный режим, то открытие этого порта требуется только в том случае, если вы также включили анонимный доступ для чтения Git. Дополнительные сведения см. в разделе Применение политик управления репозиториями в организации.

4. При необходимости свяжите плавающий IP-адрес с экземпляром. В зависимости от настройки OpenStack может потребоваться выделить плавающий IP-адрес для проекта и связать его с экземпляром. Чтобы определить, подходит ли это для вас, обратитесь к системному администратору. Дополнительные сведения см. в разделе "Выделение плавающего IP-адреса экземпляру" в документации OpenStack.

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

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

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

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

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