Condividi tramite

ShellScript@2 - Attività Shell script v2

Utilizzare questa attività per eseguire uno script di shell utilizzando 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.

Ingressi dati

scriptPath - percorso script
string. Obbligatorio.

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


args - argomenti
string.

Specifica gli argomenti che si desidera passare allo script.


disableAutoCwd - Specifica directory di lavoro
boolean. Valore predefinito: false

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


cwd - directory di lavoro
string. Opzionale. Usare quando disableAutoCwd = true.

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


failOnStandardError - errore standard
boolean. Valore predefinito: false

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


Opzioni di controllo delle attività

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

Variabili di uscita

Nessuno.

Osservazioni:

Dove posso trovare informazioni sugli script Bash?

Come si imposta una variabile in modo che possa essere letta 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 ulteriori informazioni sulla definizione delle variabili di rilascio in uno script, consulta Definire e modificare le variabili di rilascio in uno script

Esempi

Crea test.sh alla radice del tuo repository. Si consiglia di creare questo file da un ambiente Linux (ad esempio un computer Linux reale o un sottosistema Windows per Linux) in modo che le terminazioni di riga siano corrette. Inoltre, non dimenticate di farlo chmod +x test.sh prima di impegnarvi.

#!/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
Viene eseguito in Agente, DeploymentGroup
Richieste Gli agenti self-hosted devono disporre di funzionalità che soddisfano le esigenze seguenti per eseguire processi che utilizzano questa attività: sh
Funzionalità Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Utilità