Udostępnij za pomocą


ShellScript@2 — zadanie skryptu powłoki w wersji 2

Użyj tego zadania, aby uruchomić skrypt powłoki przy użyciu bash.

Składnia

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

Dane wejściowe

scriptPath - ścieżka skryptu
string. To jest wymagane.

Określa ścieżkę względną od katalogu głównego repozytorium do pliku skryptu powłoki, który chcesz uruchomić.


args - argumenty
string.

Określa argumenty, które mają być przekazywane do skryptu.


disableAutoCwd - Określanie katalogu roboczego
boolean. Wartość domyślna: false.

Określa katalog roboczy, w którym zadanie uruchamia skrypt. Jeśli wartość pozostanie pusta, zadanie domyślnie wybierze folder, w którym znajduje się skrypt.


katalogu roboczego cwd -
string. Opcjonalny. Użyj polecenia , gdy disableAutoCwd = true.

Określa katalog roboczy, w którym jest uruchamiany skrypt. Jeśli wartość pozostanie pusta, zadanie użyje katalogu głównego repozytorium (kompilacji) lub artefaktów (wydania), czyli $(System.DefaultWorkingDirectory).


failOnStandardError - niepowodzenie w błędu standardowego
boolean. Wartość domyślna: false.

Jeśli wartość to true, zadanie zakończy się niepowodzeniem, jeśli błędy zostaną zapisane w strumieniu StandardError.


Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Gdzie mogę dowiedzieć się więcej o skryptach Bash?

Jak ustawić zmienną, aby mogła być odczytywana przez kolejne skrypty i zadania?

Aby dowiedzieć się więcej na temat definiowania zmiennych kompilacji w skrypcie, zobacz Definiowanie i modyfikowanie zmiennych kompilacji w skrypcie.

Aby dowiedzieć się więcej na temat definiowania zmiennych wydania w skrypcie, zobacz Definiowanie i modyfikowanie zmiennych wydania w skrypcie

Przykłady

Utwórz test.sh w katalogu głównym repozytorium. Zalecamy utworzenie tego pliku w środowisku Linux (takim jak prawdziwy komputer z systemem Linux lub podsystem Windows dla systemu Linux), aby zakończenia wierszy były poprawne. Nie zapomnij też o tym chmod +x test.sh , zanim to zrobisz.

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

Dodaj następujące zadanie do potoku, aby uruchomić poprzedni skrypt.

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

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami , aby uruchamiać zadania korzystające z tego zadania: sh
Możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń Jakikolwiek
zmienne ustawiane Jakikolwiek
Wersja agenta Wszystkie obsługiwane wersje agentów.
Kategoria zadań Użyteczność