Начало работы со средствами выполнения тестов локального размещения для вашего предприятия

Сведения о локальных бегунах для GitHub Actions

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

С помощью GitHub Actionsразработчиков можно создавать и объединять отдельные задачи, называемые действиями для создания пользовательских рабочих процессов. Чтобы включить GitHub Actionsваш экземпляр GitHub Enterprise Server, необходимо разместить по крайней мере один компьютер для выполнения заданий. компьютер называется локальным runner. Компьютер runner подключается к GitHub с помощью приложения локального runner GitHub Actions. локальные модули запуска могут запускать Linux, Windows или macOS. Дополнительные сведения см. в разделе Локальные средства выполнения тестов.

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

Настройка ограниченной политики для ограничения действий процессов, которые могут выполняться в пределах предприятия.
Развертывание средства выполнения тестов локального размещения для вашего предприятия
Создание группы для управления доступом к средствам выполнения тестов, доступным для вашего предприятия
При необходимости дополнительно ограничьте репозитории, которые могут использовать средство выполнения
При необходимости для автоматического создания и масштабирования локальных модулей выполнения используйте Actions Runner Controller (ARC). Дополнительные сведения см. в разделе Контроллер runner действий.

Кроме того, вы найдете дополнительные сведения о том, как отслеживать и защищать локальные средства выполнения, как получить доступ к действиям из GitHub.comи как настроить программное обеспечение на компьютерах runner.

После завершения руководства пользователейваш экземпляр GitHub Enterprise Serverсмогут выполнять задания рабочего процесса с GitHub Actions локального компьютера runner.

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

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

Подключение между локальными запусками и GitHub через HTTP (порт 80) или HTTPS (порт 443). Чтобы обеспечить подключение по протоколу HTTPS, настройте TLS для GitHub Enterprise Server. Для получения дополнительной информации см. Настройка TLS.

Ваше предприятие должно быть членом по крайней мере одной организации. Дополнительные сведения см. в разделе [AUTOTITLE и Сведения об организациях](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch).

1. Настройка политик для GitHub Actions

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

В правом верхнем углу GitHub Enterprise Serverщелкните рисунок профиля, а затем выберите параметры Enterprise.
В верхней части страницы нажмите «Политики».
В разделе " Policies", нажмите кнопку "Действия".
В разделе «Политики» выберите Включить для всех организаций.
Чтобы включить локальные действия созданные с помощью GitHub, выберите Allow select actionsпункт "Разрешить действия", созданные GitHub.
Нажмите кнопку Сохранить.

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

2. Развертывание средства выполнения тестов локального размещения для вашего предприятия

Затем добавьте локальное средство выполнения тестов в свое предприятие. GitHub поможет вам установить необходимое программное обеспечение на компьютере runner. После развертывания средства выполнения можно проверить подключение между компьютером runner и ваш экземпляр GitHub Enterprise Server.

Добавление средства выполнения тестов локального размещения

В правом верхнем углу GitHub Enterprise Serverщелкните рисунок профиля, а затем выберите параметры Enterprise.
В верхней части страницы нажмите «Политики».
В разделе " Policies", нажмите кнопку "Действия".
Перейдите на вкладку Средства выполнения тестов.
Нажмите кнопку "Создать бегун". 1. Выберите образ операционной системы и архитектуру компьютера, на который будет установлено локальное средство выполнения тестов.
Отобразятся инструкции по скачиванию средства выполнения тестов и его установке на локальный компьютер.

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

Примечание.

В Windows, если вы хотите установить локальное приложение runner в качестве службы, необходимо открыть оболочку с правами администратора. Мы также рекомендуем использовать C:\actions-runner в качестве каталога для локального приложения средства выполнения тестов, чтобы системные учетные записи Windows могли получить доступ к каталогу средства выполнения тестов.

В инструкциях указан порядок выполнения следующих задач:
- Скачивание и извлечение локального приложения средства выполнения тестов.
- Запуск скрипта config , чтобы настроить локальное приложение runner и зарегистрировать его в GitHub Actions. Скрипту config требуется URL-адрес назначения и автоматически созданный маркер с ограничением по временем для проверки подлинности запроса. Срок действия маркера истекает через один час.
  - В Windows скрипт config также спрашивает, необходимо ли установить локальное приложение средства выполнения тестов в качестве службы. В Linux и macOS установить службу можно после завершения добавления средства выполнения тестов. Дополнительные сведения см. в разделе Настройка приложения локального средства выполнения как службы.
- Запуск локального приложения runner для подключения компьютера к GitHub Actionsнему.

Проверка успешного добавления локального средства выполнения

После выполнения действий по добавлению локального runner средство выполнения и его состояние теперь перечислены в разделе "Self-hosted runners".

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

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

3. Управление доступом к средству выполнения тестов локального размещения с помощью группы

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

GitHub добавляет всех новых бегунов в группу. Средства выполнения тестов не могут находиться одновременно в нескольких группах. По умолчанию GitHub добавляет в группу "Default" новые средства выполнения.

В правом верхнем углу GitHub Enterprise Serverщелкните рисунок профиля, а затем выберите параметры Enterprise.
В верхней части страницы нажмите «Политики».
В разделе " Policies", нажмите кнопку "Действия".
Перейдите на вкладку Группы средств выполнения тестов.
Нажмите кнопку Создать группу средств выполнения тестов.
В поле "Имя группы" введите имя группы средств выполнения тестов.
Чтобы выбрать политику для доступа организации, в разделе «Доступ к организации» щелкните раскрывающийся список Доступ к организации и выберите Выбранные организации.
Справа от раскрывающегося списка с политикой доступа организации щелкните .
Выберите организации, которым требуется предоставить доступ к группе средств выполнения.
При необходимости, чтобы разрешить общедоступным репозиториям в выбранных организациях использовать средства выполнения тестов в группе, выберите Разрешить общедоступные репозитории.

Предупреждение

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

Дополнительные сведения см. в разделе Справочник по безопасному использованию.
Нажмите кнопку "Создать группу", чтобы создать группу и применить политику.
Перейдите на вкладку «Средства выполнения тестов».
В списке средств выполнения тестов щелкните средство выполнения тестов, развернутое в предыдущем разделе.
Выберите Изменить.
Щелкните группы Runner.
В списке групп средств выполнения тестов щелкните имя ранее созданной группы.
Нажмите кнопку Сохранить, чтобы переместить средство выполнения тестов в группу.

Теперь вы развернули автономный модуль выполнения, который может выполнять задания из GitHub Actions указанных организаций.

4. Дополнительное ограничение доступа к средству выполнения тестов локального размещения

При необходимости владельцы и пользователи организации с разрешением "Управление группами запуска организации и группы runner" могут дополнительно ограничить политику доступа созданной группы runner. Например, владелец организации может разрешить использовать группу средств выполнения тестов только определенным репозиториям в организации.

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

Дополнительные сведения о пользовательских ролях организации см. в разделе Разрешения на кастомные организационные роли.

5. Автоматическое масштабирование средств выполнения тестов локального размещения

При необходимости можно использовать Actions Runner Controller (ARC) для автоматического масштабирования локальных модулей выполнения. Actions Runner Controller (ARC) — это оператор Kubernetes, который управляет и масштабирует локальные модули выполнения для GitHub Actions. Дополнительные сведения см . в разделе "Шаблон оператора" в документации по Kubernetes.

С помощью ARC можно создавать масштабируемые наборы runner, которые автоматически масштабируются на основе количества рабочих процессов, выполняемых в репозитории, организации или организации. Так как управляемые средства выполнения могут быть временными и основаны на контейнерах, новые экземпляры бегунов могут быстро увеличивать или уменьшать масштаб. Дополнительные сведения об автомасштабировании см. в разделе Справочник по локальным запускам.

Следующие шаги

Вы можете отслеживать локальные средства выполнения тестов и устранять распространенные проблемы. Дополнительные сведения см. в разделе Мониторинг и устранение неполадок в самостоятельно размещенных средствах выполнения.
GitHub Рекомендуется просмотреть рекомендации по обеспечению безопасности для локальных компьютеров runner. Дополнительные сведения см. в разделе Справочник по безопасному использованию.
можете вручную синхронизировать репозитории, содержащие действия с GitHub.com вашим предприятиемGitHub Enterprise Server. Кроме того, можно разрешить членам предприятия автоматически получать доступ к действиям с GitHub.com помощью GitHub Connect. Дополнительные сведения см. в следующих разделах.
Ручная синхронизация действий из GitHub.com
Включение автоматического доступа к GitHub.com действиям с помощью GitHub Connect
Вы можете настроить программное обеспечение, доступное на локальных компьютерах runner, или настроить для запуска программного обеспечения, аналогичного GitHubразмещенным запускам, доступным для клиентовGitHub.com. Программное обеспечение, которое обеспечивает запуск компьютеров для GitHub Actions открытый код. Дополнительные сведения см. в репозиториях actions/runner и actions/runner-images.