Referência de tarefa do Azure Pipelines

Uma tarefa executa uma ação em um pipeline. Por exemplo, uma tarefa pode criar um aplicativo, interagir com recursos do Azure, instalar uma ferramenta ou executar um teste. As tarefas são os blocos de construção para definir a automação em um pipeline.

Os artigos nesta seção descrevem as tarefas internas do Azure Pipelines e especificam a semântica para atributos que têm um significado especial para cada tarefa.

Consulte a referência YAML para steps.task para obter detalhes sobre os atributos gerais compatíveis com as tarefas.

Para obter instruções e tutoriais sobre como criar pipelines usando tarefas, incluindo a criação de tarefas personalizadas, extensões personalizadas e a localização de tarefas no Visual Studio Marketplace, consulte conceitos de Tarefas e documentação do Azure Pipelines.

Importante

Para exibir a referência de tarefa para tarefas disponíveis para sua plataforma, selecione a versão correta do Azure DevOps no seletor de versão localizado acima do sumário. O suporte a recursos é diferente dependendo se você está trabalhando no Azure DevOps Services ou em uma versão local do Azure DevOps Server.
Para saber qual versão local você está usando, consulte pesquisar sua plataforma e versão do Azure DevOps.

Criar tarefas

Tarefa	Descrição
do .NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	Crie, teste, empacote ou publique um aplicativo dotnet ou execute um comando dotnet personalizado.
do AutoBuild de Segurança Avançada AdvancedSecurity-Codeql-Autobuild@1	Tenta criar o repositório localizando e compilando arquivos de projeto na pasta de origem.
segurança avançada inicializar CodeQL AdvancedSecurity-Codeql-Init@1	Inicializa o banco de dados CodeQL em preparação para a criação.
análise codeql de execução de segurança avançada AdvancedSecurity-Codeql-Analyze@1	Finaliza o banco de dados CodeQL e executa as consultas de análise.
de resultados de publicação de segurança avançada AdvancedSecurity-Publish@1	Combina arquivos SARIF produzidos por ferramentas de verificação de código, aprimora o arquivo SARIF combinado e publica o arquivo SARIF aprimorado no serviço de Segurança Avançada.
de build do Android AndroidBuild@1	AndroidBuild@1 foi preterido. Use Gradle.
de Assinatura do Android AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	Assinar e alinhar arquivos APK do Android.
ant Ant@1	Compile com o Apache Ant.
do Azure IoT Edge AzureIoTEdge@2	Crie e implante uma imagem do Azure IoT Edge.
do CMake CMake@1	Compile com o sistema de build multiplataforma do CMake.
de build de contêiner ContainerBuild@0	Tarefa de compilação de contêiner.
docker Docker@2 Docker@1 Docker@0	Crie ou envie por push imagens do Docker, faça logon ou logoff, inicie ou interrompa contêineres ou execute um comando do Docker.
do Docker Compose DockerCompose@1 DockerCompose@0	Compilar, efetuar push ou executar aplicativos docker de vários contêineres. A tarefa pode ser usada com o Registro de Contêiner do Docker ou do Azure.
baixar pacotes Nuget do GitHub DownloadGitHubNugetPackage@1	Restaure seus pacotes nuget usando a CLI do dotnet.
Ir Go@0	Obtenha, compile ou teste um aplicativo Go ou execute um comando Go personalizado.
Gradle Gradle@3 Gradle@2 Gradle@1	Crie usando um script de wrapper do Gradle.
Grunt Grunt@0	Execute o executor de tarefas JavaScript Grunt.
gulp gulp@1 gulp@0	Execute o gulp Node.js sistema de build baseado em tarefa de streaming.
fontes de índice e símbolos de publicação PublishSymbols@2 PublishSymbols@1	Indexe seu código-fonte e publique símbolos em um compartilhamento de arquivos ou servidor de símbolos do Azure Artifacts.
trabalho de fila do Jenkins JenkinsQueueJob@2	Enfileirar um trabalho em um servidor Jenkins.
de trabalho de fila do Jenkins JenkinsQueueJob@1	Enfileirar um trabalho em um servidor Jenkins.
Maven Maven@4 Maven@3 Maven@2 Maven@1	Compilar, testar e implantar com o Apache Maven.
do MSBuild MSBuild@1	Compilar com o MSBuild.
preparar de configuração de análise SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	Preparar a configuração de análise do SonarQube.
publicar de resultados do Portão de Qualidade SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	Publique o resultado do Portão de Qualidade do SonarQube no resultado do build do Azure DevOps, a ser usado após a análise real.
executar de análise de código SonarQubeAnalyze@6 SonarQubeAnalyze@5 SonarQubeAnalyze@4	Execute o scanner e carregue os resultados no servidor SonarQube.
de build do Visual Studio VSBuild@1	Compile com o MSBuild e defina a propriedade de versão do Visual Studio.
Xamarin.Android XamarinAndroid@1	Crie um aplicativo Android com o Xamarin.
do Xamarin.iOS XamariniOS@2 XamariniOS@1	Crie um aplicativo iOS com o Xamarin no macOS.
Xcode Xcode@5 Xcode@4	Compilar, testar ou arquivar um workspace do Xcode no macOS. Opcionalmente, empacote um aplicativo.
de build do Xcode Xcode@3 Xcode@2	Crie um workspace do Xcode no macOS.
pacote Xcode iOS XcodePackageiOS@0	Gere um arquivo .ipa da saída de build do Xcode usando xcrun (Xcode 7 ou inferior).

Implantar tarefas

Tarefa	Descrição
App Center distribua AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	Distribua builds de aplicativo para testadores e usuários por meio do Visual Studio App Center.
de implantação de modelo do ARM AzureResourceManagerTemplateDeployment@3	Implante um modelo do ARM (Azure Resource Manager) em todos os escopos de implantação.
de Exportação de Configuração de Aplicativo do Azure AzureAppConfigurationExport@10	Baixe valores-chave para variáveis de tarefa da Configuração de Aplicativos do Azure.
clássico do Serviço de Aplicativo do Azure (preterido) AzureWebPowerShellDeployment@1	Crie ou atualize o Serviço de Aplicativo do Azure usando o Azure PowerShell.
implantação do Serviço de Aplicativo do Azure AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Implante no Serviço de Aplicativo do Azure um aplicativo Web, móvel ou de API usando Docker, Java, .NET, .NET Core, Node.js, PHP, Python ou Ruby.
o Serviço de Aplicativo do Azure gerenciar AzureAppServiceManage@0	Iniciar, parar, reiniciar, trocar de slot, excluir slot, instalar extensões de site ou habilitar o monitoramento contínuo para um Serviço de Aplicativo do Azure.
configurações do Serviço de Aplicativo do Azure AzureAppServiceSettings@1	Atualizar/adicionar configurações de aplicativo a um Aplicativo Web do Azure para Linux ou Windows.
CLI do Azure AzureCLI@2 AzureCLI@1	Execute comandos da CLI do Azure em uma assinatura do Azure em um script do PowerShell Core/Shell ao executar no agente linux ou no script PowerShell/PowerShell Core/Batch ao executar no agente do Windows.
de visualização da CLI do Azure AzureCLI@0	Execute um script shell ou lote com comandos da CLI do Azure em uma assinatura do Azure.
implantação do Serviço de Nuvem do Azure AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Implantar um Serviço de Nuvem do Azure.
Implantação de Aplicativos de Contêiner do Azure AzureContainerApps@1 AzureContainerApps@0	Uma tarefa do Azure DevOps para criar e implantar aplicativos de contêiner do Azure.
de implantação do Banco de Dados do Azure para MySQL AzureMysqlDeployment@1	Execute seus scripts e faça alterações no Banco de Dados do Azure para MySQL.
de cópia de arquivo do Azure AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	Copie arquivos para o Armazenamento de Blobs do Azure ou máquinas virtuais.
a Função do Azure no do Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Implantar a função do Azure no cluster do Kubernetes.
implantação do Azure Functions AzureFunctionApp@2 AzureFunctionApp@1	Atualize um aplicativo de funções com aplicativos Web baseados em .NET, Python, JavaScript, PowerShell e Java.
Azure Functions para de contêiner AzureFunctionAppContainer@1	Atualize um aplicativo de funções com um contêiner do Docker.
do Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	Baixe os segredos do Azure Key Vault.
alertas do Azure Monitor (preteridos) AzureMonitorAlerts@0	Configure alertas em métricas disponíveis para um recurso do Azure (preterido).
do Azure PowerShell AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	Execute um script do PowerShell em um ambiente do Azure.
de implantação do grupo de recursos do Azure AzureResourceGroupDeployment@2	Implante um modelo do ARM (Azure Resource Manager) em um grupo de recursos e gerencie máquinas virtuais.
de Implantação do Grupo de Recursos do Azure AzureResourceGroupDeployment@1	Implantar, iniciar, parar, excluir Grupos de Recursos do Azure.
do Azure Spring Apps AzureSpringCloud@0	Implantar aplicativos no Azure Spring Apps e gerenciar implantações.
implantação do Banco de Dados SQL do Azure SqlAzureDacpacDeployment@1	Implante um Banco de Dados SQL do Azure usando DACPAC ou execute scripts usando SQLCMD.
implantação do conjunto de dimensionamento de VMs do Azure AzureVmssDeployment@0	Implantar uma imagem do conjunto de dimensionamento de máquinas virtuais.
do Aplicativo Web do Azure AzureWebApp@1	Implantar um aplicativo Web do Azure para Linux ou Windows.
aplicativo Web do Azure para contêineres AzureWebAppContainer@1	Implantar contêineres no Serviço de Aplicativo do Azure.
criar de imagem do computador PackerBuild@1 PackerBuild@0	Crie uma imagem de computador usando o Packer, que pode ser usado para a implantação do conjunto de dimensionamento de máquinas virtuais do Azure.
verificar o de conformidade do Azure Policy AzurePolicyCheckGate@0	Avaliação de segurança e conformidade do Azure Policy.
Chef Chef@1	Implante em ambientes chef editando atributos de ambiente.
de Faca do Chef ChefKnife@1	Execute scripts com comandos Knife na estação de trabalho do Chef.
copiar arquivos por SSH CopyFilesOverSSH@0	Copiar arquivos ou compilar artefatos para um computador remoto por SSH.
Implantar no kubernetes KubernetesManifest@1 KubernetesManifest@0	Use arquivos de manifesto do Kubernetes para implantar em clusters ou até mesmo assar os arquivos de manifesto a serem usados para implantações usando gráficos do Helm.
implantação de aplicativo Web do IIS IISWebAppDeploymentOnMachineGroup@0	Implantar um site ou aplicativo Web usando a Implantação da Web.
implantação do IIS Web App (preterido) IISWebAppDeployment@1	Implante usando o MSDeploy e, em seguida, crie/atualize sites e pools de aplicativos.
aplicativo Web do IIS gerenciar IISWebAppManagementOnMachineGroup@0	Crie ou atualize sites, aplicativos Web, diretórios virtuais ou pools de aplicativos.
invocar da API REST InvokeRESTAPI@1 InvokeRESTAPI@0	Invoque uma API REST como parte do pipeline.
do Kubectl Kubernetes@1 Kubernetes@0	Implante, configure e atualize um cluster kubernetes no Serviço de Contêiner do Azure executando comandos kubectl.
de intervenção manual ManualIntervention@8	Pause a implantação e aguarde a intervenção manual.
de validação manual ManualValidation@1 ManualValidation@0	Pausar uma execução de pipeline para aguardar a interação manual. Funciona somente com pipelines YAML.
implantação do banco de dados MySQL MysqlDeploymentOnMachineGroup@1	Execute scripts e faça alterações em um Banco de Dados MySQL.
Empacotar e implantar gráficos do Helm HelmDeploy@1 HelmDeploy@0	Implante, configure e atualize um cluster do Kubernetes no Serviço de Contêiner do Azure executando comandos helm.
PowerShell em computadores de destino PowerShellOnTargetMachines@3	Execute scripts do PowerShell em computadores remotos usando PSSession e Invoke-Command para comunicação remota.
PowerShell em computadores de destino PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	Execute scripts do PowerShell em computadores remotos.
de implantação de aplicativo do Service Fabric ServiceFabricDeploy@1	Implantar um aplicativo do Azure Service Fabric em um cluster.
implantação do Service Fabric Compose ServiceFabricComposeDeploy@0	Implante um aplicativo Docker Compose em um cluster do Azure Service Fabric.
implantação de banco de dados do SQL Server SqlDacpacDeploymentOnMachineGroup@0	Implante um banco de dados do SQL Server usando scripts DACPAC ou SQL.
implantação de banco de dados do SQL Server (preterido) SqlServerDacpacDeployment@1	Implantar um banco de dados do SQL Server usando DACPAC.
SSH SSH@0	Execute comandos de shell ou um script em um computador remoto usando SSH.
de cópia de arquivo de computador do Windows WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	Copiar arquivos para computadores Windows remotos.

Tarefas de pacote

Tarefa	Descrição
autenticação de carga (para executores de tarefas) CargoAuthenticate@0	Tarefa de autenticação para o cliente de carga usado para instalar a distribuição de engradado de carga.
CocoaPods CocoaPods@0	Instale as dependências do CocoaPods para projetos Swift e Objective-C Cocoa.
ambiente conda CondaEnvironment@1 CondaEnvironment@0	Essa tarefa foi preterida. Use conda diretamente no script para trabalhar com ambientes anaconda.
baixar de pacote do Github Npm DownloadGithubNpmPackage@1	Instale pacotes npm do GitHub.
de Autenticação do Maven MavenAuthenticate@0	Fornece credenciais para feeds do Azure Artifacts e repositórios maven externos.
npm Npm@1 Npm@0	Instale e publique pacotes npm ou execute um comando npm. Dá suporte a registros npmjs.com e autenticados, como o Azure Artifacts.
autenticação npm (para executores de tarefas) npmAuthenticate@0	Não use essa tarefa se você também estiver usando a tarefa npm. Fornece credenciais npm para um arquivo .npmrc em seu repositório para o escopo do build. Isso permite que os executores de tarefas npm, como gulp e Grunt, se autentiquem com registros privados.
do NuGet NuGetCommand@2	Restaurar, empacotar ou enviar pacotes NuGet por push ou executar um comando NuGet. Dá suporte a feeds NuGet.org e autenticados, como o Azure Artifacts e o MyGet. Usa NuGet.exe e funciona com aplicativos .NET Framework. Para aplicativos .NET Core e .NET Standard, use a tarefa .NET Core.
autenticação do NuGet NuGetAuthenticate@1 NuGetAuthenticate@0	Configure as ferramentas do NuGet para autenticar com o Azure Artifacts e outros repositórios NuGet. Requer >NuGet = 4,8,5385, dotnet >= 6 ou MSBuild >= 15,8,166,59604.
de comando do NuGet NuGet@0	Preterido: use a tarefa "NuGet". Ele funciona com a nova estrutura do Instalador de Ferramentas para que você possa usar facilmente novas versões do NuGet sem esperar por uma atualização de tarefa, fornece melhor suporte para feeds autenticados fora dessa organização/coleção e usa o NuGet 4 por padrão.
do Instalador do NuGet NuGetInstaller@0	Instala ou restaura pacotes NuGet ausentes. Use NuGetAuthenticate@0 tarefa para recursos mais recentes.
do empacotador NuGet NuGetPackager@0	Preterido: use a tarefa "NuGet". Ele funciona com a nova estrutura do Instalador de Ferramentas para que você possa usar facilmente novas versões do NuGet sem esperar por uma atualização de tarefa, fornece melhor suporte para feeds autenticados fora dessa organização/coleção e usa o NuGet 4 por padrão.
de editor do NuGet NuGetPublisher@0	Preterido: use a tarefa "NuGet". Ele funciona com a nova estrutura do Instalador de Ferramentas para que você possa usar facilmente novas versões do NuGet sem esperar por uma atualização de tarefa, fornece melhor suporte para feeds autenticados fora dessa organização/coleção e usa o NuGet 4 por padrão.
de restauração do NuGet NuGetRestore@1	Restaura pacotes NuGet em preparação para uma etapa de Build do Visual Studio.
de editor PyPI PyPIPublisher@0	Crie e carregue um sdist ou roda em um índice compatível com PyPI usando o Twine.
de autenticação de pip do Python PipAuthenticate@1 PipAuthenticate@0	Tarefa de autenticação para o cliente pip usado para instalar distribuições do Python.
de autenticação de upload do gêmeo Python TwineAuthenticate@1 TwineAuthenticate@0	Autentique-se para carregar distribuições do Python usando o twine. Adicione '-r FeedName/EndpointName --config-file $(PYPIRC_PATH)' ao comando de upload do twine. Para feeds presentes nesta organização, use o nome do feed como o repositório (-r). Caso contrário, use o nome do ponto de extremidade definido na conexão de serviço.
pacotes universais UniversalPackages@0	Baixe ou publique Pacotes Universais.
de restauração de componente do Xamarin XamarinComponentRestore@0	Essa tarefa foi preterida. Em vez disso, use 'NuGet'.

Tarefas de teste

Tarefa	Descrição
de teste do App Center AppCenterTest@1	Testar pacotes de aplicativos com o Visual Studio App Center.
de Teste de Carga do Azure AzureLoadTest@1	Automatize o teste de regressão de desempenho com o Teste de Carga do Azure.
de teste de estrutura de contêiner ContainerStructureTest@0	Usa container-structure-test (https://github.com/GoogleContainerTools/container-structure-test) para validar a estrutura de uma imagem com base em quatro categorias de testes - testes de comando, testes de existência de arquivo, testes de conteúdo de arquivo e testes de metadados.
de Teste do Centro Móvel VSMobileCenterTest@0	Teste pacotes de aplicativos móveis com o Visual Studio Mobile Center.
Publicar resultados de cobertura de código PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	Publique qualquer um dos resultados de cobertura de código de um build.
Publicar resultados do teste PublishTestResults@1	Publicar os resultados do teste no Azure Pipelines.
publicar resultados do teste PublishTestResults@2	Publicar os resultados do teste no Azure Pipelines.
Executar testes funcionais RunVisualStudioTestsusingTestAgent@1	Preterido: essa tarefa e sua tarefa complementar (Implantação do Agente de Teste do Visual Studio) foram preteridas. Em vez disso, use a tarefa "Teste do Visual Studio". A tarefa VSTest pode executar a unidade, bem como testes funcionais. Execute testes em um ou mais agentes usando a configuração de trabalho de vários agentes. Use a tarefa "Plataforma de Teste do Visual Studio" para executar testes sem precisar do Visual Studio no agente. A tarefa VSTest também traz novos recursos, como executar novamente automaticamente testes com falha.
de teste do Visual Studio VSTest@3 VSTest@2 VSTest@1	Execute testes funcionais e de unidade (Selenium, Appium, teste de interface do usuário codificado etc.) usando o executor de Teste do Visual Studio (VsTest). Estruturas de teste que têm um adaptador de teste do Visual Studio, como MsTest, xUnit, NUnit, Chutzpah (para testes JavaScript usando QUnit, Mocha e Jasmine), etc. podem ser executadas. Os testes podem ser distribuídos em vários agentes usando essa tarefa (versão 2 e posterior).
implantação do agente de teste do Visual Studio DeployVisualStudioTestAgent@2	DeployVisualStudioTestAgent@2 foi preterido. Use a tarefa Teste do Visual Studio para executar testes funcionais e de unidade.
de implantação do Agente de Teste do Visual Studio DeployVisualStudioTestAgent@1	Implante e configure o Agente de Teste para executar testes em um conjunto de computadores.
de nuvem de teste do Xamarin XamarinTestCloud@1	[Preterido] Teste aplicativos móveis com o Xamarin Test Cloud usando Xamarin.UITest. Em vez disso, use a tarefa "Teste do App Center".

Tarefas de ferramentas

Tarefa	Descrição
instalador do SDK/runtime do .NET Core DotNetCoreInstaller@1 DotNetCoreInstaller@0	Adquira uma versão específica do SDK do .NET Core da Internet ou do cache local e adicione-a ao PATH.
instalador da CLI do Docker DockerInstaller@0	Instale a CLI do Docker no computador do agente.
instalador de ferramentas do Duffle DuffleInstaller@0	Instale uma versão especificada do Duffle para instalar e gerenciar pacotes CNAB.
instalador de ferramentas do Go GoTool@0	Localize no cache ou baixe uma versão específica do Go e adicione-a ao PATH.
instalador de ferramentas do Helm HelmInstaller@1 HelmInstaller@0	Instale o Helm em um computador de agente.
instalar do Azure Func Core Tools FuncToolsInstaller@0	Instale as Ferramentas do Azure Func Core.
do instalador de ferramentas Java JavaToolInstaller@0	Adquira uma versão específica do Java de um blob do Azure fornecido pelo usuário ou do cache de ferramentas e define JAVA_HOME.
do instalador de ferramentas do Kubectl KubectlInstaller@0	Instale o Kubectl no computador do agente.
do instalador de ferramentas do Kubelogin KubeloginInstaller@0	Ajuda a instalar o kubelogin.
do instalador de ferramentas do NuGet NuGetToolInstaller@1 NuGetToolInstaller@0	Adquire uma versão específica do NuGet da Internet ou do cache de ferramentas e a adiciona ao PATH. Use essa tarefa para alterar a versão do NuGet usada nas tarefas do NuGet.
usar do .NET Core UseDotNet@2	Adquire uma versão específica do SDK do .NET Core da Internet ou do cache local e a adiciona ao PATH. Use essa tarefa para alterar a versão do .NET Core usada nas tarefas subsequentes. Além disso, fornece suporte a proxy.
usar do ecossistema Node.js UseNode@1 NodeTool@0	Configure um ambiente de Node.js e adicione-o ao PATH, fornecendo também suporte a proxy.
usar de versão do Python UsePythonVersion@0	Use a versão especificada do Python do cache de ferramentas, opcionalmente adicionando-a ao PATH.
usar a versão do Ruby UseRubyVersion@0	Use a versão especificada do Ruby do cache de ferramentas, opcionalmente adicionando-a ao PATH.
do instalador da plataforma de teste do Visual Studio VisualStudioTestPlatformInstaller@1	Adquira a plataforma de teste de nuget.org ou do cache de ferramentas. Atende à demanda 'vstest' e pode ser usado para executar testes e coletar dados de diagnóstico usando a tarefa Teste do Visual Studio.

Tarefas do utilitário

Tarefa	Descrição
de verificação de dependência de segurança avançada AdvancedSecurity-Dependency-Scanning@1	Verifique se há vulnerabilidades de dependência de software livre no código-fonte.
arquivos arquivar ArchiveFiles@2	Compactar arquivos em .7z, .tar.gz ou .zip.
arquivos de arquivo ArchiveFiles@1	Arquive arquivos usando formatos de compactação, como .7z, .rar, .tar.gz e .zip.
de Importação de Configuração de Aplicativo do Azure AzureAppConfigurationImport@10	Efetue push de valores de chave para uma instância de Configuração de Aplicativo do Azure.
de Instantâneo de Configuração de Aplicativo do Azure AzureAppConfigurationSnapshot@1	Crie um instantâneo em uma instância de Configuração de Aplicativo do Azure.
do Azure Network Load Balancer AzureNLBManagement@1	Conecte ou desconecte o adaptador de rede de uma máquina virtual do Azure ao pool de endereços de back-end de um Load Balancer.
Bash Bash@3	Execute um script Bash no macOS, Linux ou Windows.
de script do Lote BatchScript@1	Execute um comando ou script em lote do Windows e, opcionalmente, permita que ele altere o ambiente.
cache Cache@2	Armazenar arquivos em cache entre execuções.
cache (Beta) CacheBeta@1 CacheBeta@0	Armazenar arquivos em cache entre execuções.
linha de comando CmdLine@2 CmdLine@1	Execute um script de linha de comando usando Bash no Linux e macOS e cmd.exe no Windows.
copiar e publicar artefatos de build CopyPublishBuildArtifacts@1	CopyPublishBuildArtifacts@1 foi preterido. Em vez disso, use a tarefa Copiar Arquivos e a tarefa Publicar Artefatos de Build.
Copiar arquivos CopyFiles@2	Copie arquivos de uma pasta de origem para uma pasta de destino usando padrões correspondentes a caminhos de arquivo (não caminhos de pasta).
copiar arquivos CopyFiles@1	Copie arquivos da pasta de origem para a pasta de destino usando padrões de minimatch (os padrões de minimatch corresponderão apenas a caminhos de arquivo, não a caminhos de pasta).
arquivos de carregamento cURL cURLUploader@2 cURLUploader@1	Use os protocolos com suporte da cURL para carregar arquivos.
openssl (arquivo de descriptografia) DecryptFile@1	Descriptografe um arquivo usando OpenSSL.
atraso de Delay@1	Atrase a execução adicional de um fluxo de trabalho por um tempo fixo.
Excluir arquivos DeleteFiles@1	Exclua pastas ou arquivos que correspondam a um padrão.
implantar de aplicativo Web estático do Azure AzureStaticWebApp@0	Crie e implante um Aplicativo Web Estático do Azure.
Baixar artefatos de de compartilhamento de arquivos DownloadFileshareArtifacts@1	Baixe artefatos de um compartilhamento de arquivos, como \share\drop.
Baixar artefatos de build DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	Baixe arquivos que foram salvos como artefatos de uma compilação concluída.
baixar de versão do GitHub DownloadGitHubRelease@0	Baixa uma versão do GitHub de um repositório.
Baixar pacote DownloadPackage@1 DownloadPackage@0	Baixe um pacote de um feed de gerenciamento de pacotes no Azure Artifacts.
baixar artefatos de pipeline DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	Baixe artefatos de build e pipeline.
Baixar de arquivo seguro DownloadSecureFile@1	Baixe um arquivo seguro no computador do agente.
Extrair arquivos ExtractFiles@1	Extraia uma variedade de arquivos de arquivo morto e compactação, como .7z, .rar, .tar.gz e .zip.
de transformação de arquivo FileTransform@2 FileTransform@1	Substitua tokens por valores variáveis em arquivos de configuração XML ou JSON.
de upload de FTP FtpUpload@2 FtpUpload@1	Carregar arquivos usando FTP.
de comentários do GitHub GitHubComment@0	Escreva um comentário em seu problema de entidade do GitHub, ou seja, um pr (solicitação de pull).
de versão do GitHub GitHubRelease@1 GitHubRelease@0	Crie, edite ou exclua uma versão do GitHub.
instalar de certificado da Apple InstallAppleCertificate@2	Instale um certificado da Apple necessário para compilar em um computador do agente macOS.
instalar o apple certificate InstallAppleCertificate@1 InstallAppleCertificate@0	Instale um certificado da Apple necessário para criar em um agente macOS.
Instalar o perfil de provisionamento da Apple InstallAppleProvisioningProfile@1	Instale um perfil de provisionamento da Apple necessário para criar em um computador do agente macOS.
instalar o perfil de provisionamento da Apple InstallAppleProvisioningProfile@0	Instale um perfil de provisionamento da Apple necessário para criar em um agente macOS.
instalar de chave SSH InstallSSHKey@0	Instale uma chave SSH antes de um build ou implantação.
invocar o de funções do Azure AzureFunction@1 AzureFunction@0	Invoque uma função do Azure.
Jenkins baixar artefatos JenkinsDownloadArtifacts@1	Baixe artefatos produzidos por um trabalho do Jenkins.
Node.js do instalador do executor de tarefas NodeTaskRunnerInstaller@0	Instale Node.js versão específica para executar tarefas de nó.
de Notação Notation@0	Tarefa Pipepine do Azure para configurar a CLI de Notação, assinar e verificar com Notação.
do PowerShell PowerShell@2 PowerShell@1	Execute um script do PowerShell no Linux, macOS ou Windows.
Publicar artefatos de build PublishBuildArtifacts@1	Publique artefatos de build no Azure Pipelines ou em um compartilhamento de arquivos do Windows.
publicar artefatos de pipeline PublishPipelineArtifact@1 PublishPipelineArtifact@0	Publique (carregue) um arquivo ou diretório como um artefato nomeado para a execução atual.
publicar de metadados de pipeline PublishPipelineMetadata@0	Publicar metadados de pipeline no Repositório de Evidências.
publicar no barramento de serviço do Azure PublishToAzureServiceBus@2 PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	Envia uma mensagem para o Barramento de Serviço do Azure usando uma conexão de serviço do Azure Resource Manager (nenhum agente é necessário).
script Python PythonScript@0	Execute um arquivo Python ou um script embutido.
consultar alertas do Azure Monitor AzureMonitor@1	Observe as regras configuradas do Azure Monitor para alertas ativos.
consultar alertas clássicos do Azure Monitor AzureMonitor@0	Observe as regras clássicas do Azure Monitor configuradas para alertas ativos.
Itens de trabalho de consulta queryWorkItems@0	Execute uma consulta de item de trabalho e verifique o número de itens retornados.
examinar de aplicativo ReviewApp@0	Use essa tarefa no provedor de fase de implantação para criar um recurso dinamicamente.
powershell do Service Fabric ServiceFabricPowerShell@1	Execute um script do PowerShell no contexto de uma conexão de cluster do Azure Service Fabric.
de script do Shell ShellScript@2	Execute um script de shell usando o Bash.
atualizar versões de aplicativo do Service Fabric ServiceFabricUpdateAppVersions@1	Atualiza automaticamente as versões de um aplicativo do Service Fabric empacotado.
atualizar manifestos do Service Fabric ServiceFabricUpdateManifests@2	Atualize automaticamente partes de manifestos de aplicativo e serviço em um aplicativo empacotado do Azure Service Fabric.
de licença do Xamarin XamarinLicense@1	[Preterido] Atualizar para a versão gratuita do Xamarin: https://store.xamarin.com.

Código aberto

Essas tarefas são de software livre no GitHub. Comentários e contribuições são bem-vindos. Consulte da caixa de alteração de tarefa pipeline para obter uma lista de alterações de tarefa, incluindo um registro histórico de atualizações de tarefas.

Perguntas Freqüentes

O que são aliases de entrada de tarefa?

As entradas para uma tarefa são identificadas por um label, namee podem incluir um ou mais aliasesopcionais. O exemplo a seguir é um trecho do de código-fonte para a entrada de Entrada de Hosts Conhecidos da tarefa InstallSSHKey@0.

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

Antes dos pipelines YAML serem introduzidos em 2019, os pipelines eram criados e editados usando um editor de pipeline baseado em interface do usuário, e apenas o label era usado por autores de pipeline para fazer referência a uma entrada de tarefa.

Quando os pipelines YAML foram introduzidos em 2019, os autores de pipeline usando YAML começaram a usar a entrada de tarefa name para se referir a uma entrada de tarefa. Em alguns casos, os nomes de entrada da tarefa não eram descritivos, portanto, aliases foram adicionados para fornecer nomes descritivos adicionais para entradas de tarefa.

Por exemplo, a tarefa tem uma entrada de Entrada de Hosts Conhecidos chamada que espera uma entrada de um arquivo known_hosts. O rótulo entrada de hosts conhecidos no designer de pipeline clássico deixa isso claro, mas não é tão claro ao usar o nome em um pipeline YAML. Os aliases de entrada da tarefa foram introduzidos para permitir que os autores de tarefas fornecessem nomes descritivos para suas tarefas criadas anteriormente e, para a tarefa InstallSSHKey@0, um alias knownHostsEntryfoi adicionado, mantendo o nome hostName original para compatibilidade com pipelines existentes usando esse nome.

Todos os itens no aliases de uma entrada de tarefa são intercambiáveis com o name em um pipeline YAML. Os dois snippets YAML a seguir são funcionalmente idênticos, com o primeiro exemplo usando o alias knownHostsEntry e o segundo exemplo usando hostName.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

A partir do Azure DevOps Server 2019.1, o editor de pipeline do YAML foi introduzido, que fornece uma funcionalidade de tipo intellisense.

O editor de pipeline yaml usa o Yamlschema – Obter API REST para recuperar o esquema usado para validação no editor. Se uma entrada de tarefa tiver um alias, o esquema promoverá o alias para o nome YAML primário para a entrada da tarefa e o alias será sugerido pelo intellisense.

O exemplo a seguir é a entrada de tarefa Entrada de Hosts Conhecidos para a tarefa InstallSSHKey@0 do esquema YAML, com knownHostsEntry listados na posição de nome e hostName na coleção aliases.

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

Como o intellisense no editor de pipeline yaml exibe knownHostsEntrye o YAML gerado pelo assistente de tarefa usa knownHostsEntry no YAML gerado, a referência de tarefa exibe o alias do código-fonte da tarefa como o nome YAML para uma entrada de tarefa. Se uma tarefa tiver mais de um alias (há alguns que têm dois aliases), o primeiro alias será usado como o nome.

Por que a referência à tarefa foi alterada?

A documentação de referência de tarefas do Azure Pipelines foi movida para seu local atual para dar suporte às melhorias a seguir.

• Os artigos de tarefa são gerados usando o código-fonte da tarefa das tarefas do ade repositório de software livre do Azure Pipelines.
• Os nomes de entrada e os aliases da tarefa são gerados da origem da tarefa para que estejam sempre atualizados.
• Os blocos de sintaxe YAML são gerados da origem da tarefa para que estejam atualizados.
• Dá suporte a contribuições da comunidade com conteúdo integrado do usuário, como descrições de entrada de tarefas aprimoradas, comentários e exemplos.
• Fornece cobertura de tarefas para todas as versões do Azure DevOps com suporte.
• Atualizado a cada sprint para cobrir as atualizações mais recentes.

Para contribuir, consulte Contribuindo para o conteúdo das tarefas.

Onde posso aprender passo a passo como criar meu aplicativo?

criar seu aplicativo

Posso adicionar minhas próprias tarefas de build?

Sim: Adicionar uma tarefa de build

O que são tarefas do instalador?

Para saber mais sobre as tarefas do instalador de ferramentas, consulte Instaladores da Ferramenta.