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

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

В этой статье

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

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

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

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

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

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

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

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

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

Примечание.

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

Дополнительные сведения см. в разделе Применение политик для 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. Дополнительные сведения см. в разделе Управление доступом к самостоятельно размещенным средствам выполнения с помощью групп.

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

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

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

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