Adding self-hosted runners

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

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

Сведения о поддерживаемых операционных системах для локальных средств выполнения тестов или использовании локальных средств выполнения с прокси-сервером см. в разделе О самостоятельно размещенных средствах выполнения.

Вы можете настроить автоматизацию для масштабирования количества локальных средств выполнения. Дополнительные сведения см. в разделе Autoscaling with self-hosted runners.

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

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

• Дополнительные сведения см. в разделе О самостоятельно размещенных средствах выполнения.

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

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

1. На GitHub.com перейдите на главную страницу репозитория. 1. Нажмите Параметры под именем репозитория. 1. На левой боковой панели щелкните Действия, а затем нажмите кнопку Средства выполнения.

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

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

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

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

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

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

   • Скачивание и извлечение локального приложения средства выполнения тестов.
   • Запуск скрипта config для настройки локального приложения средства выполнения тестов и его регистрации с помощью GitHub Actions. Скрипту config требуется URL-адрес назначения и автоматически созданный маркер с ограничением по временем для проверки подлинности запроса.
     • В Windows скрипт config также спрашивает, необходимо ли установить локальное приложение средства выполнения тестов в качестве службы. В Linux и macOS установить службу можно после завершения добавления средства выполнения тестов. Дополнительные сведения см. в разделе Configuring the self-hosted runner application as a service.
   • Запуск локального приложения средства выполнения тестов для подключения компьютера к GitHub Actions. ### Проверка успешного добавления локального средства выполнения

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

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

√ Connected to GitHub

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

Дополнительные сведения см. в разделе Monitoring and troubleshooting self-hosted runners.

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

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

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

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

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

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

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

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

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

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

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

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

   • Скачивание и извлечение локального приложения средства выполнения тестов.
   • Запуск скрипта config для настройки локального приложения средства выполнения тестов и его регистрации с помощью GitHub Actions. Скрипту config требуется URL-адрес назначения и автоматически созданный маркер с ограничением по временем для проверки подлинности запроса.
     • В Windows скрипт config также спрашивает, необходимо ли установить локальное приложение средства выполнения тестов в качестве службы. В Linux и macOS установить службу можно после завершения добавления средства выполнения тестов. Дополнительные сведения см. в разделе Configuring the self-hosted runner application as a service.
   • Запуск локального приложения средства выполнения тестов для подключения компьютера к GitHub Actions. ### Проверка успешного добавления локального средства выполнения

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

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

√ Connected to GitHub

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

Дополнительные сведения см. в разделе Monitoring and troubleshooting self-hosted runners.

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

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