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

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

В этой статье

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

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

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

Note

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Примечание. Вы не можете использовать 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

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