ShellScript@2 - Задача скрипта оболочки v2

2025-06-24

Используйте эту задачу для запуска сценария оболочки с помощью bash.

Синтаксис

# Shell script v2
# Run a shell script using Bash.
- task: ShellScript@2
  inputs:
    scriptPath: # string. Required. Script Path. 
    #args: # string. Arguments. 
  # Advanced
    #disableAutoCwd: false # boolean. Specify Working Directory. Default: false.
    #cwd: # string. Optional. Use when disableAutoCwd = true. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

Входные данные

Путьк скрипту scriptPath -
string. Обязательное.

Указывает относительный путь от корня репозитория к файлу скрипта оболочки, который требуется запустить.

args - аргументы
string.

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

disableAutoCwd - Укажите рабочий каталог
boolean. Значение по умолчанию: false.

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

cwd - рабочий каталог
string. Необязательно. Используется при disableAutoCwd = true.

Указывает рабочий каталог, в котором выполняется скрипт. Если значение оставлено пустым, задача использует корень репозитория (build) или artifacts (release), то есть $(System.DefaultWorkingDirectory).

failOnStandardError - сбой стандартной ошибки
boolean. Значение по умолчанию: false.

Если значение равно true, задача завершится ошибкой, если ошибки будут записаны в поток StandardError.

Параметры управления задачами

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

Выходные переменные

Нет.

Замечания

Где я могу узнать о скриптах Bash?

Новички/BashScripting для начала.
Awesome Bash для более глубокого погружения.

Как задать переменную, чтобы она могла быть прочитана последующими скриптами и задачами?

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

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

Примеры

Создайте test.sh в корне вашего репозитория. Мы рекомендуем создавать этот файл в среде Linux (например, на реальном компьютере Linux или в подсистеме Windows для Linux), чтобы окончания строк были правильными. Кроме того, не забудьте сделать это chmod +x test.sh перед тем, как совершить покупку.

#!/bin/bash
echo "Hello World"
echo "AGENT_WORKFOLDER is $AGENT_WORKFOLDER"
echo "AGENT_WORKFOLDER contents:"
ls -1 $AGENT_WORKFOLDER
echo "AGENT_BUILDDIRECTORY is $AGENT_BUILDDIRECTORY"
echo "AGENT_BUILDDIRECTORY contents:"
ls -1 $AGENT_BUILDDIRECTORY
echo "SYSTEM_HOSTTYPE is $SYSTEM_HOSTTYPE"
echo "Over and out."

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

- task: ShellScript@2
  inputs:
    scriptPath: 'test.sh'

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Для выполнения заданий, использующих эту задачу, локальные агенты должны обладать возможностями , соответствующими следующим требованиям : sh
Возможности	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	Все поддерживаемые версии агента.
Категория задач	Полезность