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

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

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

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

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

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

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

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

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

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

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

1. На экземпляр GitHub Enterprise Server перейдите на главную страницу репозитория. 1. Под именем репозитория щелкните Параметры. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку Параметры.

   1. На левой боковой панели щелкните Действия, а затем щелкните Средства выполнения.

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

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

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

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

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

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

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

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

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

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

1. На экземпляр GitHub Enterprise Server перейдите на главную страницу организации. 1. Под названием организации щелкните Параметры. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и щелкните Параметры.

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

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

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

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

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

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

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

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

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

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

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

1. В правом верхнем углу GitHub Enterprise Server щелкните фотографию профиля и выберите Параметры предприятия.

   

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

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

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

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

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

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

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

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

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

√ Connected to GitHub

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

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

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

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

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

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

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

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