Skip to main content

Начало работы с GitHub Actions for GitHub Enterprise Server

Узнайте о включении и настройке GitHub ActionsGitHub Enterprise Server в первый раз.

Кто может использовать эту функцию?

Site administrators can enable GitHub Actions and configure enterprise settings.

Примечание.

GitHub Enterprise Serverразмещенные в данный момент средства выполнения не поддерживаются в GitHub.

О том GitHub Actions , что дальше GitHub Enterprise Server

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

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

Прежде чем приступить к работе, необходимо сделать план по GitHub Actions внедрению в вашей организации. Дополнительные сведения см. в разделе Знакомство с GitHub Actions для вашего предприятия.

Если вы переносите предприятие GitHub Actions с другого поставщика, есть дополнительные рекомендации. Дополнительные сведения см. в разделе Миграция вашего предприятия на GitHub Actions.

Ознакомиться с требованиями к оборудованию

Ресурсы ЦП и памяти, доступные для ваш экземпляр GitHub Enterprise Server определения количества модулей выполнения, которые можно настроить без потери производительности. Для запуска GitHub требуется не менее 8 виртуальных ЦП и 64 ГБ памяти для запуска GitHub Actions.

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

Число виртуальных ЦППамятьМаксимальное количество подключенных средств выполнения тестов
864 ГБСредств выполнения тестов: 740
32160 ГБСредств выполнения тестов: 2700
96384 ГБСредств выполнения тестов: 7000

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

Примечание.

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

Если вы планируете включить GitHub Actions для пользователей существующего экземпляра, просмотрите уровни активности пользователей и автоматизации в экземпляре и убедитесь, что вы подготовили достаточный объем ЦП и памяти для пользователей. Для получения дополнительной информации о мониторинге ёмкости и производительности GitHub Enterprise Serverсм. Мониторинг экземпляра.

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

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

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

Требования к внешнему хранилищу

Для включения GitHub ActionsGitHub Enterprise Serverнеобходимо иметь доступ к внешнему хранилищу BLOB-объектов.

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

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

GitHub Actions поддерживает следующие поставщики хранилища:

  • Хранилище блочных объектов Azure
  • Amazon S3
    
  • Google Cloud Storage
  • Кластер MinIO, совместимый с S3

Примечание.

Это единственные поставщики хранилища, которые GitHub поддерживают и могут оказывать помощь.

Существуют другие продукты хранения, совместимые с API S3, которые партнеры GitHub самостоятельно проверяются как работа с GitHub Actions на GitHub Enterprise Server. Дополнительные сведения см. в репозитории партнеров службы хранилища GHES.

Для продуктов хранения, проверенных с помощью программы партнерства по технологии GitHub , поставщик хранилища отвечает за поддержку и документацию по использованию продукта хранилища с GitHub Actions.

Рекомендации по работе с сетями

Если для организации включено GitHub Actions, поддерживаются только прокси-серверы HTTP. Прокси-серверы SOCKS5 и HTTPS не поддерживаются. Дополнительные сведения об использовании прокси-сервера см GitHub Enterprise Server. в разделе Настройка сервера веб-прокси исходящего трафика.

Включение GitHub Actions с помощью поставщика хранилища

Выполните одну из приведенных ниже процедур, чтобы включить GitHub Actions выбранный поставщик хранилища:

Управление разрешениями доступа для GitHub Actions вашей организации

Политики можно использовать для управления доступом GitHub Actions. Дополнительные сведения см. в разделе Применение политик для GitHub Actions в вашем предприятии.

Добавление локальных средств выполнения

Примечание.

GitHub Enterprise Serverразмещенные в данный момент средства выполнения не поддерживаются в GitHub.

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

Управление действиями, которые можно использовать в предприятии

Вы можете управлять действиями, которые пользователи могут использовать в вашем предприятии. Это включает настройку GitHub Connect автоматического доступа к действиям из GitHub.comили ручной синхронизации действий.GitHub.com

Дополнительные сведения см. в разделе Сведения об использовании действий в организации.

Общая защита безопасности для GitHub Actions

Дополнительные сведения о методах GitHub Actionsбезопасности см. в разделе Справочник по безопасному использованию.

Зарезервированные имена

При включении GitHub Actions для предприятия создаются две организации: github и actions. Если ваше предприятие уже использует имя организации github, то вместо него будет использоваться github-org (или github-github-org, если github-org тоже используется). Если ваше предприятие уже использует имя организации actions, то вместо него будет использоваться github-actions (или github-actions-org, если github-actions тоже используется). После включения действий вы больше не сможете где-либо использовать эти имена.