ShellScript@2 - Shell script v2 task

Article
02/27/2024

Use this task to run a shell script using bash.

Inputs

scriptPath - Script Path
string. Required.

Specifies the relative path from the repo root to the shell script file that you want to run.

args - Arguments
string.

Specifies the arguments that you want to pass to the script.

disableAutoCwd - Specify Working Directory
boolean. Default value: false.

Specifies the working directory where the task runs the script. If the value is left empty, the task defaults to the folder where the script is located.

cwd - Working Directory
string. Optional. Use when disableAutoCwd = true.

Specifies the working directory where the script is run. If the value is left empty, the task uses the root of the repo (build) or artifacts (release), which is $(System.DefaultWorkingDirectory).

failOnStandardError - Fail on Standard Error
boolean. Default value: false.

If the value is true, the task will fail if errors are written to the StandardError stream.

Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

None.

Remarks

Where can I learn about Bash scripts?

Beginners/BashScripting to get started.
Awesome Bash to go deeper.

How do I set a variable so that it can be read by subsequent scripts and tasks?

To learn more about defining build variables in a script, see Define and modify your build variables in a script.

To learn more about defining release variables in a script, see Define and modify your release variables in a script

Examples

Create test.sh at the root of your repo. We recommend creating this file from a Linux environment (such as a real Linux machine or Windows Subsystem for Linux) so that line endings are correct. Also, don't forget to chmod +x test.sh before you commit it.

#!/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."

Add the following task to your pipeline to run the previous script.

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

Requirements

Requirement	Description
Pipeline types	YAML, Classic build, Classic release
Runs on	Agent, DeploymentGroup
Demands	Self-hosted agents must have capabilities that match the following demands to run jobs that use this task: sh
Capabilities	This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions	Any
Settable variables	Any
Agent version	All supported agent versions.
Task category	Utility

Share via