Partager via

ShellScript@2 - Tâche Script shell v2

La procédure décrite ci-dessous permet d’exécuter un script shell à l’aide bashde .

Syntaxe

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

Données d'entrée

scriptPath - chemin d’accès de script
string. Obligatoire.

Spécifie le chemin d’accès relatif entre la racine du référentiel et le fichier de script shell que vous souhaitez exécuter.


args - arguments
string.

Spécifie les arguments que vous souhaitez transmettre au script.


disableAutoCwd - Spécifier le répertoire de travail
boolean. Valeur par défaut : false.

Spécifie le répertoire de travail dans lequel la tâche exécute le script. Si la valeur n’est pas renseignée, la tâche utilise par défaut le dossier dans lequel se trouve le script.


cwd - répertoire de travail
string. Optionnel. Utilisez quand disableAutoCwd = true.

Spécifie le répertoire de travail dans lequel le script est exécuté. Si la valeur n’est pas renseignée, la tâche utilise la racine du référentiel (build) ou des artefacts (release), qui est $(System.DefaultWorkingDirectory).


failOnStandardError - Échec sur les d’erreur standard
boolean. Valeur par défaut : false.

Si la valeur est true, la tâche échoue si des erreurs sont écrites dans le flux StandardError.


Options de contrôle de tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Remarques

Où puis-je en savoir plus sur les scripts Bash ?

Comment définir une variable pour qu’elle puisse être lue par les scripts et les tâches suivants ?

Pour en savoir plus sur la définition de variables de build dans un script, consultez Définir et modifier vos variables de build dans un script.

Pour en savoir plus sur la définition de variables de mise en production dans un script, consultez Définir et modifier vos variables de mise en production dans un script

Exemples

Créez test.sh à la racine de votre dépôt. Nous vous recommandons de créer ce fichier à partir d’un environnement Linux (tel qu’une machine Linux réelle ou un sous-système Windows pour Linux) afin que les fins de ligne soient correctes. N’oubliez pas non plus de le faire chmod +x test.sh avant de vous engager.

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

Ajoutez la tâche suivante à votre pipeline pour exécuter le script précédent.

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

Spécifications

Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : sh
Capacités Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe lequel
variables settables N'importe lequel
Version de l’agent Toutes les versions de l’agent prises en charge.
Catégorie de tâche Utilité