Пулы агентов

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | Team Foundation Server 2018 — Team Foundation Server 2015

Примечание

В Microsoft Team Foundation Server (TFS) 2018 и предыдущих версий конвейеры сборки и выпуска называются определениями, выполнения называются сборками, подключения к службам называются конечными точками служб, этапы называются средами, а задания называются этапами.

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

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

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

Архитектура системы сборки TFS 2017 и TFS 2018

Пулы агентов ограничены коллекциями проектов.

Архитектура системы сборки TFS 2015

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

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

Примечание

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

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

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

  1. выберите Azure DevOps, параметры организации.

    Выберите параметры Организации.

  2. Выберите Пулы агентов.

    Выберите вкладку Пулы агентов.

  1. выберите Azure DevOps, параметры коллекции.

    Выберите параметры коллекции.

  2. Выберите Пулы агентов.

    Выберите Пулы агентов.

  1. выберите Azure DevOps, параметры коллекции.

    Параметры коллекции, 2019.

  2. Выберите Пулы агентов.

    Выберите Пулы агентов, 2019.

  1. перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

    выберите Параметры, очереди агентов, 2018.

  2. Выберите Управление пулами.

    Выберите Управление пулами, 2018.

  1. перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

    Выберите параметры, очереди агентов, 2017.

  2. Выберите Управление пулами.

    Выберите Управление пулами, 2017.

  1. Перейдите к своему проекту и выберите Управление проектом (значок шестеренки).

    Управление проектом, 2015.

  2. Выберите Панель управления.

    Выберите панель управления, 2015.

  3. Выберите Пулы агентов.

    Выберите Пулы агентов, 2015.

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

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

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к проекту и выберите параметры Project, пулы агентов (2020).

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к проекту и выберите параметры Project, пулы агентов (2019).

перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

Выберите параметры, очереди агентов, TFS 2018.

перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

Выберите параметры, очереди агентов, TFS 2017.

  1. Перейдите к своему проекту и выберите Управление проектом (значок шестеренки).

    Перейдите к своему проекту и выберите Управление проектом, TFS 2015.

  2. Выберите Панель управления.

    Выберите панель управления в TFS 2015.

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

    Project администрирования коллекций, TFS 2015.

    1. Выберите очереди агента (для TFS 2015, выберите Сборка , а затем очереди).

      Выберите сборка, а затем — очереди.

Пулы агентов по умолчанию

По умолчанию предоставляются следующие пулы агентов:

  • Azure Pipelines размещенному пулу с различными образами Windows, Linux и macOS. Полный список доступных образов и их установленных программ см. в разделе агенты, размещенные в Майкрософт.

    Примечание

    размещенный пул Azure Pipelines заменяет предыдущие размещенные пулы, имена которых сопоставлены с соответствующими изображениями. все задания, которые вы находились в предыдущих размещенных пулах, автоматически перенаправляются на правильный образ в новом размещенном пуле Azure Pipelines. в некоторых случаях старые имена пулов по-прежнему могут отображаться, но в фоновом режиме размещенные задания выполняются с помощью пула Azure Pipelines. Дополнительные сведения см. в заметках о выпуске одного размещенного пула из заметок о выпуске 154 1 2019 июля.

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

Выбор пула и агента в конвейере

чтобы выбрать агент, размещенный в майкрософт, из пула Azure Pipelines в конвейере Azure DevOps Services YAML, укажите имя образа, используя метку образа виртуальной машины YAML из этой таблицы.

pool:
  vmImage: ubuntu-latest

Использование частного пула без запросов:

pool: MyPool

Дополнительные сведения см. в схеме YAML для пулов.

Управление пулами и очередями

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

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

  1. выберите Azure DevOps, параметры организации.

    Выберите параметры Организации.

  2. Выберите Пулы агентов.

    Выберите вкладку Пулы агентов.

  1. выберите Azure DevOps, параметры коллекции.

    Выберите параметры коллекции.

  2. Выберите Пулы агентов.

    Выберите Пулы агентов.

  1. выберите Azure DevOps, параметры коллекции.

    Параметры коллекции, 2019.

  2. Выберите Пулы агентов.

    Выберите Пулы агентов, 2019.

  1. перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

    выберите Параметры, очереди агентов, 2018.

  2. Выберите Управление пулами.

    Выберите Управление пулами, 2018.

  1. перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

    Выберите параметры, очереди агентов, 2017.

  2. Выберите Управление пулами.

    Выберите Управление пулами, 2017.

  1. Перейдите к своему проекту и выберите Управление проектом (значок шестеренки).

    Управление проектом, 2015.

  2. Выберите Панель управления.

    Выберите панель управления, 2015.

  3. Выберите Пулы агентов.

    Выберите Пулы агентов, 2015.

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

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

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к проекту и выберите параметры Project, пулы агентов (2020).

перейдите к своему проекту и выберите параметры Project, пулы агентов.

перейдите к проекту и выберите параметры Project, пулы агентов (2019).

перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

Выберите параметры, очереди агентов, TFS 2018.

перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

Выберите параметры, очереди агентов, TFS 2017.

  1. Перейдите к своему проекту и выберите Управление проектом (значок шестеренки).

    Перейдите к своему проекту и выберите Управление проектом, TFS 2015.

  2. Выберите Панель управления.

    Выберите панель управления в TFS 2015.

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

    Project администрирования коллекций, TFS 2015.

    1. Выберите очереди агента (для TFS 2015, выберите Сборка , а затем очереди).

      Выберите сборка, а затем — очереди.

Пулы используются для запуска заданий. Сведения об указании пулов для заданий.

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

Создание пулов агентов

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

  • Вы являетесь членом проекта и хотите использовать набор машин, принадлежащих вашей команде для выполнения заданий сборки и развертывания. Во-первых, убедитесь, что у вас есть разрешения на создание пулов в проекте, выбрав Безопасность на странице Пулы агентов в параметрах проекта. Необходимо иметь роль администратора , чтобы иметь возможность создавать новые пулы. Затем выберите Добавить пул и выберите вариант создания нового пула на уровне Организации. Наконец, установите и настройте агенты, которые будут входить в этот пул агентов.

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

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

  • Вы являетесь членом проекта и хотите использовать набор машин, принадлежащих вашей команде для выполнения заданий сборки и развертывания. Во-первых, убедитесь, что вы являетесь членом группы во всех пулах с ролью администратора . Затем создайте новый пул агентов проекта в параметрах проекта и выберите этот параметр, чтобы создать новый пул агентов Организации. В результате будет создан пул агентов на уровне Организации и проекта. Наконец, установите и настройте агенты, которые будут входить в этот пул агентов.

  • Вы являетесь членом группы инфраструктуры и хотите настроить пул агентов для использования во всех проектах. Сначала убедитесь, что вы являетесь членом группы во всех пулах с ролью администратора . Затем создайте новый пул агентов Организации в параметрах администратора и выберите параметр для автоматической подготовки соответствующих пулов агентов проекта во всех проектах при создании пула. Этот параметр гарантирует, что все проекты имеют пул, указывающий на пул агентов Организации. Система создает пул для существующих проектов, и в будущем это будет сделано при создании нового проекта. Наконец, установите и настройте агенты, которые будут входить в этот пул агентов.

  • Вы хотите предоставить общий доступ к набору компьютеров агентов с несколькими проектами, но не со всеми. Сначала создайте пул агентов проекта в одном из проектов и выберите параметр, чтобы создать новый пул агентов Организации при создании этого пула. Затем перейдите к каждому из других проектов и создайте пул в каждом из них, выбрав вариант использования существующего пула агентов Организации. Наконец, установите и настройте агенты, которые будут входить в состав общего пула агентов.

Безопасность пулов агентов

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

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

Роль в пуле агентов в параметрах Организации Назначение
Читатель Члены этой роли могут просматривать Пул агентов и агенты. Обычно это используется для добавления операторов, которые отвечают за мониторинг агентов и их работоспособность.
Учетная запись службы Члены этой роли могут использовать пул агентов Организации для создания пула агентов проекта в проекте. Если следовать приведенным выше рекомендациям по созданию пулов агентов проекта, вам обычно не нужно добавлять элементы.
Администратор Помимо всех перечисленных выше разрешений, члены этой роли могут регистрировать или отменять регистрацию агентов в пуле агентов Организации. Они также могут ссылаться на пул агентов Организации при создании пула агентов проекта в проекте. Наконец, они также могут управлять членством для всех ролей пула агентов Организации. Пользователь, создавший Пул агентов Организации, автоматически добавляется к роли администратора для этого пула.

Узел все пулы агентов на вкладке Пулы агентов используется для управления безопасностью всех пулов агентов Организации. Членство в ролях для отдельных пулов агентов организации автоматически наследуется от элементов узла "все пулы агентов". при использовании tfs или Azure DevOps Server администраторы tfs и Azure DevOps Server также являются администраторами узла "все пулы агентов".

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

Роль в пуле агентов в параметрах проекта Назначение
Читатель Члены этой роли могут просматривать Пул агентов проекта. Обычно это используется для добавления операторов, ответственных за мониторинг заданий сборки и развертывания в пуле агентов проекта.
Пользователь Члены этой роли могут использовать пул агентов проекта при создании конвейеров.
Администратор Помимо всех перечисленных выше операций, члены этой роли могут управлять членством для всех ролей пула агентов проекта. Пользователь, создавший пул, автоматически добавляется к роли администратора для этого пула.

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

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

TFS 2015

В TFS 2015 специальные группы определяются в пулах агентов, а членство в этих группах определяет, какие операции можно выполнять.

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

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

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

ВОПРОСЫ И ОТВЕТЫ

Если я не планирую период обслуживания, когда агенты будут запускать обслуживание?

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

Что такое задание обслуживания?

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

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

  1. выберите Azure DevOps, параметры организации.

    Выберите параметры Организации.

  2. Выберите Пулы агентов.

    Выберите вкладку Пулы агентов.

  1. выберите Azure DevOps, параметры коллекции.

    Выберите параметры коллекции.

  2. Выберите Пулы агентов.

    Выберите Пулы агентов.

  1. выберите Azure DevOps, параметры коллекции.

    Параметры коллекции, 2019.

  2. Выберите Пулы агентов.

    Выберите Пулы агентов, 2019.

  1. перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

    выберите Параметры, очереди агентов, 2018.

  2. Выберите Управление пулами.

    Выберите Управление пулами, 2018.

  1. перейдите к своему проекту и выберите Параметры (значок шестеренки) > очереди агентов.

    Выберите параметры, очереди агентов, 2017.

  2. Выберите Управление пулами.

    Выберите Управление пулами, 2017.

  1. Перейдите к своему проекту и выберите Управление проектом (значок шестеренки).

    Управление проектом, 2015.

  2. Выберите Панель управления.

    Выберите панель управления, 2015.

  3. Выберите Пулы агентов.

    Выберите Пулы агентов, 2015.

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

Важно!

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

Параметры задания обслуживания

Параметры задания обслуживания для TFS

Настройте нужные параметры и нажмите кнопку сохранить.

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

Журнал заданий обслуживания

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

Я пытаюсь создать пул агентов проекта, использующий существующий пул агентов Организации, но элементы управления неактивны. Важно?

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

Не удается выбрать пул, размещенный в Майкрософт, и я не могу поставить в очередь свою сборку. Как устранить эту проблему?

попросите владельца организации Azure DevOps предоставить вам разрешение на использование пула. См. раздел Безопасность пулов агентов.

Мне требуется больше размещенных ресурсов сборки. Что я могу сделать?

ответ. пул Azure Pipelines предоставляет все Azure DevOpsные организации с агентами сборки, размещенными в облаке, а также бесплатные минуты сборки каждый месяц. Если требуется больше ресурсов сборки, размещенных корпорацией Майкрософт, или требуется параллельное выполнение нескольких заданий, можно выполнить одно из следующих действий.