Compartir a través de

ShellScript@2 - Tarea de script de shell v2

Utilice esta tarea para ejecutar un script de shell mediante bash.

Sintaxis

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

Entradas

scriptPath - ruta de acceso de script
string. Obligatorio.

Especifica la ruta de acceso relativa desde la raíz del repositorio hasta el archivo de script de shell que desea ejecutar.


argumentos de args -
string.

Especifica los argumentos que desea pasar al script.


disableAutoCwd - Especificar directorio de trabajo
boolean. Valor predeterminado: false.

Especifica el directorio de trabajo en el que se ejecuta la tarea el script. Si el valor se deja vacío, el valor predeterminado de la tarea es la carpeta donde se encuentra el script.


de directorio de trabajo de
string. Opcional. Use cuando disableAutoCwd = true.

Especifica el directorio de trabajo donde se ejecuta el script. Si el valor se deja vacío, la tarea usa la raíz del repositorio (compilación) o artefactos (versión), que es $(System.DefaultWorkingDirectory).


failOnStandardError - error en la de error estándar
boolean. Valor predeterminado: false.

Si el valor es true, se producirá un error en la tarea si se escriben errores en la secuencia StandardError.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

¿Dónde puedo aprender sobre los scripts de Bash?

¿Cómo configuro una variable para que pueda ser leída por scripts y tareas posteriores?

Para obtener más información sobre cómo definir variables de compilación en un script, consulte Definir y modificar las variables de compilación en un script.

Para obtener más información sobre cómo definir variables de versión en un script, consulte Definir y modificar las variables de versión en un script

Ejemplos

Cree test.sh en la raíz de su repositorio. Se recomienda crear este archivo desde un entorno Linux (como una máquina Linux real o un subsistema de Windows para Linux) para que los finales de línea sean correctos. Además, no lo olvides chmod +x test.sh antes de cometerlo.

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

Agregue la siguiente tarea a la canalización para ejecutar el script anterior.

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

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
demandas Los agentes autohospedados deben tener capacidades que coincidan con las siguientes demandas para ejecutar trabajos que utilicen esta tarea: sh
Capacidades Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Cualquiera
variables settable Cualquiera
Versión del agente Todas las versiones de agente admitidas.
Categoría de tarea Utilidad