Группы задач для сборок и выпусков (классическая модель)

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Примечание.

Группы задач не поддерживаются в конвейерах YAML. Вместо этого в этом случае можно использовать шаблоны. См. справочник по схеме YAML.

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

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

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

Перед созданием группы задач...

• Убедитесь, что все задачи, которые необходимо включить в группу задач, имеют свои параметры, определенные как переменные, такие как $(MyVariable), где вы хотите настроить эти параметры при использовании группы задач. Переменные, используемые в задачах, автоматически извлекаются и преобразуются в параметры для группы задач. Значения этих переменных конфигурации будут преобразованы в значения по умолчанию для группы задач.

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

• Параметры инкапсулированных задач, для которых вы указали значение (вместо переменной) или не предоставили значение, не настраиваются в группе задач при добавлении в конвейер сборки или выпуска.

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

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

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

• Изменения, внесенные в группу задач, отражаются в каждом экземпляре группы задач.

Создание группы задач

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

   

2. Выберите последовательность задач в конвейере сборки или выпуска, откройте контекстное меню и выберите команду "Создать группу задач".

   

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

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

5. Все "$(vars)" из базовых задач, за исключением предопределенных переменных, будут отображаться в качестве обязательных параметров для только что созданной группы задач.

   Например, предположим, что у вас есть входные данные задачи $(foobar), которые не планируется параметризировать. Однако при создании группы задач входные данные задачи преобразуются в параметр группы задач foobar. Теперь можно указать значение по умолчанию для параметра группы задач foobar как $(foobar). Это гарантирует, что во время выполнения развернутая задача получает те же входные данные, которые он предназначен.

6. Сохраните обновленный конвейер.

Управление группами задач

Все группы задач, создаваемые в текущем проекте, перечислены на странице групп задач Azure Pipelines.

Используйте команду "Экспорт" для сохранения копии группы задач в виде конвейера JSON и значка импорта для импорта ранее сохраненных определений групп задач. Используйте эту функцию для передачи групп задач между проектами и предприятиями или реплика te и сохранения копий групп задач.

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

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

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

• На вкладке "Журнал" можно просмотреть журнал изменений в группе.

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

Создание предварительных версий и обновленных версий групп задач

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

1. После завершения редактирования группы задач нажмите кнопку "Сохранить как черновик " вместо "Сохранить".

   

2. Строка -test добавляется к номеру версии группы задач. Когда вы удовлетворены изменениями, выберите "Опубликовать черновик". Вы можете выбрать, следует ли публиковать его как предварительную версию или как готовую к работе версию.

   

3. Теперь можно использовать обновленную группу задач в процессах сборки и выпуска; либо изменив номер версии группы задач в существующем конвейере, либо добавив его из панели "Добавить задачи ".

   

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

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

   

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

   

Работа с версиями группы задач

Любое обновление группы задач может быть дополнительным или основным обновлением версии.

Дополнительный номер версии

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

Эффект: номер версии не изменяется. Предположим, у вас есть группа задач версии 1.0. У вас может быть любое количество дополнительных обновлений версий, например 1.1, 1.2и 1.3 т. д. В конвейере версия группы задач отображается, как 1.* последние изменения будут отображаться в определении конвейера автоматически.

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

Основной номер версии

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

Эффект: группа задач ударяется до новой версии. Предположим, у вас есть группа задач версии 1.*. Новая версия публикуется как 2.*, 3.*4.* и т. д. А уведомление о доступности новой версии отображается во всех определениях конвейера, где используется эта группа задач. Пользователь должен явно обновить новую версию группы задач в конвейерах.

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

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

1. Обновите группу задач с нужными изменениями и сохраните ее в виде черновика. Будет создана новая группа задач "<Taskgroupname-Draft>", содержащая внесенные изменения. Эта группа задач черновика доступна для использования в конвейерах.
2. Теперь вместо публикации в качестве предварительной версии вы можете напрямую использовать эту группу задач черновика в тестовом конвейере.
3. Проверьте эту новую группу задач черновика в тестовом конвейере и после того, как вы уверены, вернитесь в основную группу задач и выполните те же изменения и сохраните его напрямую. Это будет принято в качестве дополнительного обновления версии.
4. Теперь новые изменения будут отображаться во всех конвейерах, где используется эта группа задач.
5. Теперь вы можете удалить черновую группу задач.

См. также

• Задачи
• Задания задач

Справка и поддержка

• Ознакомьтесь с советами по устранению неполадок.
• Получите советы по Stack Overflow.
• Опубликуйте свои вопросы, найдите ответы или предложите функцию в Сообщество разработчиков Azure DevOps.
• Получите поддержку Azure DevOps.