Skip to main content

Использование меток с самостоятельно размещенными средствами выполнения

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

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

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

Локальное средство выполнения может находиться в репозитории, организации или корпоративных параметров на GitHub Enterprise Server. Для управления локальным средством выполнения необходимо иметь следующие разрешения в зависимости от того, куда было добавлено это локальное средство выполнения:

  • Пользовательский репозиторий: необходимо быть владельцем репозитория.

  • Организация: необходимо быть владельцем организации.

  • Репозиторий организации: необходимо быть владельцем организации или иметь доступ к репозиторию с правами администратора.

  • Предприятие: необходимо быть администратором сайта GitHub Enterprise.

Note

Контроллер runner действий не поддерживает несколько меток, чтобы узнать больше, ознакомьтесь с документацией по контроллеру runner actions Runner

Создание пользовательской метки

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

Note

Метки не учитывает регистр.

Создание настраиваемой метки для запуска репозитория

  1. Перейдите на главную страницу репозитория, где зарегистрирована локальная группа runner.
  2. Щелкните Параметры.
  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку " Runners".
  4. В списке средств выполнения щелкните имя бегуна, который вы хотите настроить.
  5. В разделе "Метки" щелкните .
  6. В поле "Найти или создать метку" введите имя новой метки и нажмите кнопку Создать метку. Пользовательская метка будет создана и назначена локальному средству выполнения. Пользовательские метки можно удалять из локальных средств выполнения, однако в настоящее время их нельзя удалять вручную. Все неиспользуемые метки, которые не были назначены средству выполнения, будут автоматически удалены в течение 24 часов.

Создание настраиваемой метки для запуска организации

  1. Перейдите на главную страницу организации, где зарегистрирована локальная группа runner.
  2. Щелкните Параметры.
  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку " Runners".
  4. В списке средств выполнения щелкните имя бегуна, который вы хотите настроить.
  5. В разделе "Метки" щелкните .
  6. В поле "Найти или создать метку" введите имя новой метки и нажмите кнопку Создать метку. Пользовательская метка будет создана и назначена локальному средству выполнения. Пользовательские метки можно удалять из локальных средств выполнения, однако в настоящее время их нельзя удалять вручную. Все неиспользуемые метки, которые не были назначены средству выполнения, будут автоматически удалены в течение 24 часов.

Создание настраиваемой метки для корпоративного запуска

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

    Снимок экрана: раскрывающееся меню, которое отображается при щелчке фото профиля на GitHub Enterprise Server. Параметр "Параметры предприятия" выделен в темно-оранжевый контур.

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

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

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

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

  6. В разделе "Метки" щелкните .

  7. В поле "Найти или создать метку" введите имя новой метки и нажмите кнопку Создать метку. Пользовательская метка будет создана и назначена локальному средству выполнения. Пользовательские метки можно удалять из локальных средств выполнения, однако в настоящее время их нельзя удалять вручную. Все неиспользуемые метки, которые не были назначены средству выполнения, будут автоматически удалены в течение 24 часов.

Назначение метки локальному средству выполнения

Вы можете назначить метки для локальных модулей выполнения в репозитории.

Назначение метки в средство выполнения репозитория

  1. Перейдите на главную страницу репозитория, где зарегистрирована локальная группа runner.
  2. Щелкните Параметры.
  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку " Runners".
  4. В разделе "Метки" щелкните .
  5. Чтобы назначить метку локальному средству выполнения, щелкните метку в поле "Найти или создать метку".

Назначение метки в средство запуска организации

  1. Перейдите на главную страницу организации, где зарегистрирована локальная группа runner.
  2. Щелкните Параметры.
  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку " Runners".
  4. В разделе "Метки" щелкните .
  5. Чтобы назначить метку локальному средству выполнения, щелкните метку в поле "Найти или создать метку".

Назначение метки для запуска предприятия

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

    Снимок экрана: раскрывающееся меню, которое отображается при щелчке фото профиля на GitHub Enterprise Server. Параметр "Параметры предприятия" выделен в темно-оранжевый контур.

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

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

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

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

  6. В разделе "Метки" щелкните .

  7. Чтобы назначить метку локальному средству выполнения, щелкните метку в поле "Найти или создать метку".

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

Вы можете удалить пользовательские метки из локальных модулей выполнения в репозитории.

Удаление пользовательской метки из средства выполнения репозитория

  1. Перейдите на главную страницу репозитория, где зарегистрирована локальная группа runner.
  2. Щелкните Параметры.
  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку " Runners".
  4. В разделе "Метки" щелкните .
  5. В поле "Найти или создать метку" назначенные метки помечаются значком . Щелкните отмеченную метку, чтобы отменить ее назначение локальному средству выполнения.

Удаление пользовательской метки из средства запуска организации

  1. Перейдите на главную страницу организации, где зарегистрирована локальная группа runner.
  2. Щелкните Параметры.
  3. На левой боковой панели щелкните Actions, а затем нажмите кнопку " Runners".
  4. В разделе "Метки" щелкните .
  5. В поле "Найти или создать метку" назначенные метки помечаются значком . Щелкните отмеченную метку, чтобы отменить ее назначение локальному средству выполнения.

Удаление настраиваемой метки из корпоративного runner

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

    Снимок экрана: раскрывающееся меню, которое отображается при щелчке фото профиля на GitHub Enterprise Server. Параметр "Параметры предприятия" выделен в темно-оранжевый контур.

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

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

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

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

  6. В разделе "Метки" щелкните .

  7. В поле "Найти или создать метку" назначенные метки помечаются значком . Щелкните отмеченную метку, чтобы отменить ее назначение локальному средству выполнения.

Программное назначение меток

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

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

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

    Note

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

    Например, эта команда назначает метку с именем gpu при настройке нового локального runner:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu
    

    Метка создается, если она еще не существует. Таким же образом можно назначать метки по умолчанию средствам выполнения, таким как x64 или linux. Если метки по умолчанию назначаются с помощью скрипта конфигурации, GitHub Actions принимает их как заданные и не проверяет, использует ли средство выполнения эту операционную систему или архитектуру.

    Чтобы назначить несколько меток, разделите их запятыми. Например:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux
    

    Note

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