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

Сведения о средствах выполнения тестов локального размещения для GitHub Actions

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

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

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

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

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

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

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

У вас должен быть доступ к компьютеру, который будет использоваться в качестве локального средства выполнения в вашей среде.
Подключение между локальными средствами выполнения и GitHub AE осуществляется по протоколу HTTPS (порт 443). Дополнительные сведения см. в разделе О самостоятельно размещенных средствах выполнения.
Ваше предприятие должно быть членом по крайней мере одной организации. Дополнительные сведения см. в разделах Сведения об организациях и Создание новой организации с нуля.

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

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

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

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

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

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

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

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

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

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

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

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

После добавления локального средства выполнения само средство выполнения и сведения о его состояния можно просмотреть в разделе "Локальные средства выполнения".

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

√ Connected to GitHub

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

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

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

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

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

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

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

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

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

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

При необходимости можно создать пользовательские средства для автоматического масштабирования локальных средств выполнения для вашего предприятия. Например, ваши инструменты могут реагировать на события веб-перехватчика из ваше предприятие для автоматического масштабирования кластера компьютеров средства выполнения. Дополнительные сведения см. в разделе Автомасштабирование с помощью локальных средств выполнения.

Дальнейшие действия

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