Partilhar via


ShellScript@2 - Tarefa de script de concha v2

Utilize esta tarefa para executar um script de concha utilizando bash.

Syntax

# 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 roteiro
string. Obrigatório.

Especifica o caminho relativo desde a raiz do repo até ao ficheiro de script da concha que pretende executar.


args - Argumentos
string.

Especifica os argumentos que pretende 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, a tarefa fica desafina na pasta onde o script está localizado.


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

Especifica o diretório de trabalho onde o guião é executado. Se o valor ficar vazio, a tarefa utiliza a raiz do repo (construção) ou artefactos (libertação), ou seja $(System.DefaultWorkingDirectory).


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

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


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefa. Para obter mais informações, consulte opções de Controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Onde posso aprender sobre os guiões do Bash?

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

Para saber mais sobre a definição de variáveis de construção num script, consulte Definir e modificar as variáveis de construção num script.

Para saber mais sobre a definição de variáveis de lançamento num script, consulte Definir e modificar as variáveis de lançamento num script

Exemplos

Crie test.sh na raiz do seu repo. Recomendamos a criação deste ficheiro a partir de um ambiente Linux (como uma verdadeira máquina Linux ou Subsistema Windows para Linux) para que as terminações de linha estejam corretas. Além disso, não te esqueças de o fazer chmod +x test.sh antes de o cometeres.

#!/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'

Requisitos

Requisito Description
Tipos de gasodutos YAML, Construção clássica, lançamento clássico
Continua Agente, Grupo de Implementação
Exigências Os agentes auto-hospedados devem ter capacidades que correspondam às seguintes exigências para executar empregos que utilizem esta tarefa: sh
Capacidades Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis de configuração Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria da tarefa Utilitário