ShellScript@2 - Shell 脚本 v2 任务

使用此任务可以使用 运行外壳 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。 必填。

指定从存储库根目录到要运行的 shell 脚本文件的相对路径。


args - 参数
string

指定要传递给脚本的参数。


disableAutoCwd - 指定工作目录
boolean。 默认值:false

指定任务运行脚本的工作目录。 如果该值留空,则任务默认为脚本所在的文件夹。


cwd - 工作目录
string。 可选。 当 disableAutoCwd = true时使用。

指定运行脚本的工作目录。 如果该值留空,则任务使用存储库 (build) 或工件 (release) 的根目录,即 $(System.DefaultWorkingDirectory).


标准错误failOnStandardError - 失败
boolean。 默认值:false

如果值为 true,则如果将错误写入 StandardError 流,则任务将失败。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

没有。

注解

在哪里可以了解 Bash 脚本?

如何设置变量,以便后续脚本和任务可以读取该变量?

若要详细了解如何在脚本中定义生成变量,请参阅 定义和修改脚本中的生成变量

要了解有关在脚本中定义发布变量的更多信息,请参阅 在脚本中定义和修改发布变量

例子

Create test.sh 在你的仓库的根目录下创建。 我们建议从 Linux 环境(如实际 Linux 计算机或适用于 Linux 的 Windows 子系统)创建此文件,以便行尾正确。 另外,在提交之前不要忘记。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'

要求

要求 DESCRIPTION
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业:sh
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
Settable 变量 任意
代理版本 所有支持的代理版本。
任务类别 效用