Delen via


ShellScript@2 - Shell-script v2-taak

Gebruik deze taak om een shellscript uit te voeren met behulp van bash.

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.

Invoerwaarden

scriptPath - Scriptpad
string. Vereist.

Hiermee geeft u het relatieve pad van de hoofdmap van de opslagplaats naar het shellscriptbestand dat u wilt uitvoeren.


args - Argumenten
string.

Hiermee geeft u de argumenten die u wilt doorgeven aan het script.


disableAutoCwd - Werkmap opgeven
boolean. Standaardwaarde: false.

Hiermee geeft u de werkmap op waarin de taak het script uitvoert. Als de waarde leeg blijft, wordt de taak standaard ingesteld op de map waarin het script zich bevindt.


cwd - Werkmap
string. Optioneel. Gebruik wanneer disableAutoCwd = true.

Hiermee geeft u de werkmap waarin het script wordt uitgevoerd. Als de waarde leeg blijft, gebruikt de taak de hoofdmap van de opslagplaats (build) of artefacten (release), namelijk $(System.DefaultWorkingDirectory).


failOnStandardError - Fout bij standaardfout
boolean. Standaardwaarde: false.

Als de waarde is true, mislukt de taak als er fouten naar de stream StandardError worden geschreven.


Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Waar vind ik meer informatie over Bash-scripts?

Hoe kan ik een variabele zo instellen dat deze kan worden gelezen door volgende scripts en taken?

Zie Uw buildvariabelen in een script definiëren en wijzigen voor meer informatie over het definiëren van buildvariabelen in een script.

Zie Uw releasevariabelen in een script definiëren en wijzigen voor meer informatie over het definiëren van releasevariabelen in een script

Voorbeelden

Maak test.sh in de hoofdmap van uw opslagplaats. U wordt aangeraden dit bestand te maken vanuit een Linux-omgeving (zoals een echte Linux-machine of Windows-subsysteem voor Linux), zodat de regeleinden juist zijn. Vergeet dit ook niet voordat chmod +x test.sh u het doorvoert.

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

Voeg de volgende taak toe aan uw pijplijn om het vorige script uit te voeren.

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

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: sh
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie Alle ondersteunde agentversies.
Taakcategorie Hulpprogramma