Compartilhar via


tarefa ShellScript@2 – Script do shell v2

Use esta tarefa para executar um script de shell usando bash.

Sintaxe

# 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 - Caminho do script
string. Obrigatórios.

Especifica o caminho relativo da raiz do repositório para o arquivo de script do shell que você deseja executar.


args - Argumentos
string.

Especifica os argumentos que você deseja passar para o script.


disableAutoCwd - Especificar Diretório de Trabalho
boolean. Valor padrão: false.

Especifica o diretório de trabalho em que a tarefa executa o script. Se o valor for deixado vazio, a tarefa usará como padrão a pasta em que o script está localizado.


cwd - Diretório de Trabalho
string. Opcional. Use quando disableAutoCwd = true.

Especifica o diretório de trabalho em que o script é executado. Se o valor for deixado vazio, a tarefa usará a raiz do repositório (build) ou artefatos (versão), que é $(System.DefaultWorkingDirectory).


failOnStandardError - Falha no Erro Padrão
boolean. Valor padrão: false.

Se o valor for true, a tarefa falhará se os erros forem gravados no fluxo StandardError.


Opções de controle de tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Onde posso aprender sobre scripts Bash?

Como fazer definir uma variável para que ela possa ser lida por scripts e tarefas subsequentes?

Para saber mais sobre como definir variáveis de build em um script, consulte Definir e modificar suas variáveis de build em um script.

Para saber mais sobre como definir variáveis de versão em um script, consulte Definir e modificar suas variáveis de versão em um script

Exemplos

Crie test.sh na raiz do repositório. É recomendável criar esse arquivo a partir de um ambiente Linux (como um computador Linux real ou Subsistema do Windows para Linux) para que as terminações de linha estejam corretas. Além disso, não se esqueça antes chmod +x test.sh de confirmá-lo.

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

Adicione a tarefa a seguir ao pipeline para executar o script anterior.

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

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
É executado em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam esta tarefa: sh
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões do agente com suporte.
Categoria da tarefa Utilitário