ShellScript@2: Shellskript v2-Aufgabe

  • Artikel

Verwenden Sie diese Aufgabe, um ein Shellskript mit bashauszuführen.

Syntax

# 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.

Eingaben

scriptPath - Skriptpfad
string. Erforderlich.

Gibt den relativen Pfad vom Repositorystamm zu der Shellskriptdatei an, die Sie ausführen möchten.


args - Argumente
string.

Gibt die Argumente an, die Sie an das Skript übergeben möchten.


disableAutoCwd - Angeben des Arbeitsverzeichnisses
boolean. Standardwert. false.

Gibt das Arbeitsverzeichnis an, in dem der Task das Skript ausführt. Wenn der Wert leer bleibt, wird der Task standardmäßig auf den Ordner festgelegt, in dem sich das Skript befindet.


cwd - Arbeitsverzeichnis
string. Optional. Verwenden Sie , wenn disableAutoCwd = true.

Gibt das Arbeitsverzeichnis an, in dem das Skript ausgeführt wird. Wenn der Wert leer bleibt, verwendet die Aufgabe den Stamm des Repositorys (Build) oder artefakte (Release), der lautet $(System.DefaultWorkingDirectory).


failOnStandardError - Fehler beim Standardfehler
boolean. Standardwert. false.

Wenn der Wert ist true, schlägt die Aufgabe fehl, wenn Fehler in den StandardError-Stream geschrieben werden.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Wo kann ich bash-Skripts kennenlernen?

Gewusst wie eine Variable so festlegen, dass sie von nachfolgenden Skripts und Aufgaben gelesen werden kann?

Weitere Informationen zum Definieren von Buildvariablen in einem Skript finden Sie unter Definieren und Ändern Ihrer Buildvariablen in einem Skript.

Weitere Informationen zum Definieren von Releasevariablen in einem Skript finden Sie unter Definieren und Ändern ihrer Releasevariablen in einem Skript.

Beispiele

Erstellen Sie test.sh im Stammverzeichnis Ihres Repositorys. Es wird empfohlen, diese Datei aus einer Linux-Umgebung (z. B. einem echten Linux-Computer oder Windows-Subsystem für Linux) zu erstellen, damit die Zeilenenden korrekt sind. Vergessen Sie es auch nicht, bevor chmod +x test.sh Sie es committen.

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

Fügen Sie der Pipeline die folgende Aufgabe hinzu, um das vorherige Skript auszuführen.

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

Anforderungen

Anforderung Beschreibung
Pipelinetypen YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen , um Aufträge auszuführen, die diese Aufgabe verwenden: sh
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Setzbare Variablen Any
Agent-Version Alle unterstützten Agent-Versionen.
Aufgabenkategorie Hilfsprogramm