ShellScript@2: Shellskript v2-Aufgabe

Artikel
07/02/2024

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?

Anfänger/BashScripting für die ersten Schritte.
Awesome Bash , um tiefer zu gehen.

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

Freigeben über