ShellScript@2 - シェル スクリプト 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.

# 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を使用します。

スクリプトを実行する作業ディレクトリを指定します。 値が空のままの場合、タスクはリポジトリ (ビルド) または成果物 (リリース) のルート () を $(System.DefaultWorkingDirectory)使用します。


failOnStandardError - 標準エラー時に失敗する
boolean. 既定値: false。

値が の場合、 trueエラーが StandardError ストリームに書き込まれた場合、タスクは失敗します。


タスク コントロール のオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

Bash スクリプトの詳細はどこで確認できますか?

操作方法後続のスクリプトやタスクで読み取ることができるように変数を設定しますか?

スクリプトでのビルド変数の定義の詳細については、「スクリプトで ビルド変数を定義および変更する」を参照してください。

スクリプトでのリリース変数の定義の詳細については、「スクリプトでのリリース変数の定義と変更」を参照してください。

例

リポジトリのルートに を作成 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'

要件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するための次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン サポートされているすべてのエージェント バージョン。
タスクのカテゴリ ユーティリティ