Partilhar via


ShellScript@2 - Tarefa Shell script v2

Use esta tarefa para executar um shell script usando basho .

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.

Insumos

scriptPath - caminho do script
string. Obrigatório

Especifica o caminho relativo da raiz do repositório para o arquivo de shell script 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 predefinido: false.

Especifica o diretório de trabalho onde a tarefa executa o script. Se o valor for deixado vazio, o padrão da tarefa será a pasta onde o script está localizado.


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

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


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

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


Opções de controlo de tarefas

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

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 compilação em um script, consulte Definir e modificar suas variáveis de compilação em um script.

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

Exemplos

Crie test.sh na raiz do seu repositório. Recomendamos criar este arquivo a partir de um ambiente Linux (como uma máquina Linux real ou um subsistema Windows para Linux) para que as terminações de linha estejam corretas. Além disso, não se esqueça de chmod +x test.sh antes de cometê-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 seguinte tarefa ao seu pipeline para executar o script anterior.

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

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam essa tarefa: sh
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria de tarefa Utilidade