Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

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

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

Примечание. В GitHub Enterprise Server в настоящее время не поддерживаются средства выполнения тестов, размещенные в GitHub. Дополнительные сведения о планируемой поддержке в будущем см. в GitHub public roadmap.

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

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

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

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

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

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

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

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

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

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

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

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

  1. На your GitHub Enterprise Server instance перейдите на главную страницу репозитория. 1. Нажмите Параметры под именем репозитория. Кнопка параметров репозитория 1. На левой боковой панели щелкните Actions (Средства выполнения).

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

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

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

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

    Примечание. В 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

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

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

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

  1. На your GitHub Enterprise Server instance перейдите на главную страницу организации. 1. Под названием организации щелкните Параметры.  Кнопка "Параметры организации" 1. На левой боковой панели щелкните Actions (Средства выполнения). 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

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

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

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

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

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

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

  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

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

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

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

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

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

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

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