Udostępnij za pośrednictwem

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

  • Artykuł

To zadanie służy do uruchamiania skryptu powłoki przy użyciu polecenia 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.

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

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


args - Argumenty
string.

Określa argumenty, które mają zostać przekazane 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 zostanie domyślnie ustawione na folder, w którym znajduje się skrypt.


cwd - Katalog roboczy
string. Opcjonalny. Użyj polecenia , gdy disableAutoCwd = true.

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


failOnStandardError - Błąd standardowy kończy się niepowodzeniem
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 zadaniami

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

Zmienne wyjściowe

Brak.

Uwagi

Gdzie można dowiedzieć się więcej o skryptach powłoki Bash?

Jak mogę ustawić zmienną, aby można ją było odczytać przez kolejne skrypty i zadania?

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

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

Przykłady

Utwórz test.sh w katalogu głównym repozytorium. Zalecamy utworzenie tego pliku ze środowiska systemu Linux (na przykład rzeczywistej maszyny z systemem Linux lub Podsystem Windows dla systemu Linux), aby zakończenia wierszy są poprawne. Ponadto nie zapomnij o chmod +x test.sh tym przed jego zatwierdzeniem.

#!/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 w Agent, DeploymentGroup
Wymagania Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: sh
Możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń Dowolne
Zmienne ustawialne Dowolne
Wersja agenta Wszystkie obsługiwane wersje agenta.
Kategoria zadania Narzędzie