ShellScript@2 - Attività script di Shell v2

Articolo
07/02/2024

Usare questa attività per eseguire uno script della shell usando bash.

Sintassi

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

Input

scriptPath - Percorso script
string. Obbligatorio.

Specifica il percorso relativo dalla radice del repository al file di script della shell da eseguire.

args - Argomenti
string.

Specifica gli argomenti da passare allo script.

disableAutoCwd - Specificare la directory di lavoro
boolean. Valore predefinito: false.

Specifica la directory di lavoro in cui l'attività esegue lo script. Se il valore è vuoto, l'attività viene predefinita nella cartella in cui si trova lo script.

cwd - Directory di lavoro
string. Facoltativa. Usare quando disableAutoCwd = true.

Specifica la directory di lavoro in cui viene eseguito lo script. Se il valore è vuoto, l'attività usa la radice del repository (build) o degli artefatti (versione), ovvero $(System.DefaultWorkingDirectory).

failOnStandardError - Errore standard non riuscita
boolean. Valore predefinito: false.

Se il valore è true, l'attività avrà esito negativo se gli errori vengono scritti nel flusso StandardError.

Opzioni di controllo attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

No.

Osservazioni

Dove è possibile ottenere informazioni sugli script Bash?

Principianti/BashScripting per iniziare.
Fantastico Bash per andare più profondo.

Ricerca per categorie impostare una variabile in modo che possa essere letto dagli script e dalle attività successive?

Per altre informazioni sulla definizione delle variabili di compilazione in uno script, vedere Definire e modificare le variabili di compilazione in uno script.

Per altre informazioni sulla definizione delle variabili di rilascio in uno script, vedere Definire e modificare le variabili di rilascio in uno script

Esempio

Creare test.sh nella radice del repository. È consigliabile creare questo file da un ambiente Linux (ad esempio un computer Linux reale o sottosistema Windows per Linux) in modo che le terminazioni di riga siano corrette. Inoltre, non dimenticare di prima di chmod +x test.sh eseguirne il commit.

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

Aggiungere l'attività seguente alla pipeline per eseguire lo script precedente.

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

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: sh
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Utilità

Condividi tramite