ShellScript@2: tarea Script de shell v2

Artículo
07/02/2024

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

# 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 del script
string. Obligatorio.

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

args - Argumentos
string.

Especifica los argumentos que desea pasar al script.

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

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

cwd - Directorio de trabajo
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 el 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 tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

¿Dónde puedo obtener información sobre los scripts de Bash?

Principiantes/BashScripting para empezar.
Impresionante Bash para profundizar.

Cómo establecer una variable para que puedan leerse mediante scripts y tareas posteriores?

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

Para más información sobre cómo definir variables de versión en un script, consulte Definición y modificación de las variables de versión en un script.

Ejemplos

Cree test.sh en la raíz del repositorio. Se recomienda crear este archivo a partir de un entorno linux (como una máquina Linux real o Subsistema de Windows para Linux) para que los finales de línea sean correctos. Además, no olvide antes chmod +x test.sh de confirmarlo.

#!/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
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: sh
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	Todas las versiones de agente admitidas.
Categoría de la tarea:	Utilidad

Compartir vía