Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Поддержка этой версии GitHub Enterprise будет прекращена 2023-03-15. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, укрепления безопасности и новых функций установите последнюю версию GitHub Enterprise. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

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

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

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

Enterprise owners can configure policies for GitHub Actions and add self-hosted runners to the enterprise.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. В разделе «Политики» выберите Включить для всех организаций.

    Снимок экрана: политика «Включить для всех организаций» для GitHub Actions

  3. Выберите Разрешить некоторые действия и Разрешить действия, созданные GitHub, чтобы разрешить локальные действия, а также действия, созданные GitHub.

    Снимок экрана: "Разрешить действия выбора" и "Разрешить действия, созданные GitHub" для GitHub Actions

  4. Нажмите Сохранить.

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

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

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

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

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

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

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

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

    В инструкциях указан порядок выполнения следующих задач:

    • Скачивание и извлечение локального приложения средства выполнения тестов.
    • Запуск скрипта config для настройки локального приложения средства выполнения тестов и его регистрации с помощью GitHub Actions. Скрипту config требуется URL-адрес назначения и автоматически созданный маркер с ограничением по временем для проверки подлинности запроса.
    • Запуск локального приложения средства выполнения тестов для подключения компьютера к GitHub Actions.

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

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

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

√ Connected to GitHub

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

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

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

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

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

  2. Нажмите кнопку Создать группу средств выполнения тестов.

  3. В поле "Имя группы" введите имя группы средств выполнения тестов.

  4. Чтобы выбрать политику для доступа организации, в разделе «Доступ к организации» щелкните раскрывающийся список Доступ к организации и выберите Выбранные организации.

  5. Справа от раскрывающегося списка, где приведена политика доступа организации, щелкните .

  6. Выберите организации, которым требуется предоставить доступ к группе средств выполнения.

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

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

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

    Дополнительные сведения см. в разделе «Локальные средства выполнения тестов».

    1. Щелкните **Создать группу** , чтобы создать группу и применить политику.
  8. Перейдите на вкладку «Средства выполнения тестов».

  9. В списке средств выполнения тестов щелкните средство выполнения тестов, развернутое в предыдущем разделе.

  10. Нажмите кнопку Изменить.

  11. Щелкните Группы средств выполнения тестов .

  12. В списке групп средств выполнения тестов щелкните имя ранее созданной группы.

  13. Нажмите кнопку Сохранить, чтобы переместить средство выполнения тестов в группу.

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

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

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

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

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

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

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

  • Вы можете отслеживать локальные средства выполнения тестов и устранять распространенные проблемы. Дополнительные сведения см. в разделе Мониторинг и устранение неполадок в работе средств выполнения тестов локального размещения.

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

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

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

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