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

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

В этой статье

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

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

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

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

Перед добавлением локального runner необходимо понять, что они и как они работают. См . раздел AUTOTITLE.

Кроме того, необходимо выполнить следующие требования:

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

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

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

Сведения о добавлении локального runner с помощью REST API см. в разделе Конечные точки REST API для локальных runners.

Примечание.

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

Дополнительные сведения см. в разделе [AUTOTITLE и Применение политик для GitHub Actions в вашем предприятии](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#limiting-the-use-of-self-hosted-runners).

  1. На GitHubперейдите на главную страницу репозитория.

  2. Под именем репозитория щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

    Снимок экрана: заголовок репозитория с вкладками. Вкладка "Параметры" выделена темно-оранжевым контуром.

  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку "Runners".

  4. Щелкните Создать локальное средство выполнения.

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

    Снимок экрана: выбор операционной системы и архитектуры. Эти параметры выделены темно-оранжевым контуром.

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

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

    Примечание.

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

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

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

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

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

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

√ Connected to GitHub

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

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

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

Вы можете добавлять локальные средства выполнения на уровне организации, где их можно использовать для обработки заданий для нескольких репозиториев в организации. Чтобы добавить локального бегуна в организацию, необходимо быть владелец организации. Сведения о добавлении локального runner с помощью REST API см. в разделе Конечные точки REST API для локальных runners.

  1. На GitHubперейдите на главную страницу организации.

  2. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

    Снимок экрана: вкладки в профиле организации. Вкладка "Параметры" выделена темно-оранжевым цветом.

  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку "Runners".

  4. Нажмите кнопку Создать средство выполнения, а затем выберите Создать локальное средство выполнения. 1. Выберите образ операционной системы и архитектуру компьютера, на который будет установлено локальное средство выполнения тестов.

    Снимок экрана: выбор операционной системы и архитектуры. Эти параметры выделены темно-оранжевым контуром.

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

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

    Примечание.

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

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

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

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

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

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

√ Connected to GitHub

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

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

Примечание.

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

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

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

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

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

  1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.

  2. В левой части страницы на боковой панели учетной записи предприятия щелкните Policies.

  3. В разделе " Policies", нажмите кнопку "Действия".

  4. Перейдите на вкладку Средства выполнения тестов.

  5. Нажмите кнопку Создать средство выполнения, а затем выберите Создать локальное средство выполнения. 1. Выберите образ операционной системы и архитектуру компьютера, на который будет установлено локальное средство выполнения тестов.

    Снимок экрана: выбор операционной системы и архитектуры. Эти параметры выделены темно-оранжевым контуром.

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

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

    Примечание.

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

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

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

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

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

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

√ Connected to GitHub

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

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

Примечание.

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

Обеспечение доступности корпоративных средств выполнения для репозиториев

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

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

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

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

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