Compartilhar via


ShellScript@2 - Tarefa Shell script 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.

Entradas

scriptPath - caminho de script
string. Obrigatório

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


argumentos args -
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 em branco, a tarefa será padronizada para a pasta em que o script está localizado.


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

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


failOnStandardError - falha no de erro padrão
boolean. Valor padrão: false.

Se o valor for true, a tarefa falhará se 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 as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Onde posso aprender sobre scripts Bash?

Como faço para 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. Recomendamos criar esse arquivo a partir de um ambiente Linux (como uma máquina Linux real ou o Subsistema do Windows para Linux) para que as terminações de linha estejam corretas. Além disso, não se esqueça de fazer isso antes de chmod +x test.sh 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
Execuções em Agent, DeploymentGroup
de demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam essa tarefa: sh
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente Todas as versões de agente com suporte.
Categoria de tarefa Utilidade