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 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 será diferente se você estiver 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.

Tarefas de build

Tarefa	Descrição
.NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	Crie, teste, empacote ou publique um aplicativo dotnet ou execute um comando dotnet personalizado.
Advanced Security AutoBuild AdvancedSecurity-Codeql-Autobuild@1	Tenta criar o repositório localizando e criando 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.
Segurança Avançada Executar análise do CodeQL AdvancedSecurity-Codeql-Analyze@1	Finaliza o banco de dados CodeQL e executa as consultas de análise.
Android Build AndroidBuild@1	AndroidBuild@1 foi preterido. Use Gradle.
Assinatura do Android AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	Assinar e alinhar arquivos APK do Android.
Formiga Ant@1	Compilar com o Apache Ant.
Azure IoT Edge AzureIoTEdge@2	Crie e implante uma imagem de IoT Edge do Azure.
CMake CMake@1	Crie com o sistema de build multiplataforma do CMake.
Compilação de contêiner ContainerBuild@0	Tarefa de Build de Contêiner.
Docker Docker@2 Docker@1 Docker@0	Crie ou envie por push imagens do Docker, faça logoff ou logoff, inicie ou interrompa contêineres ou execute um comando do Docker.
Docker Compose DockerCompose@0	Compile, envie por push ou execute aplicativos do Docker de vários contêineres. A tarefa pode ser usada com o Registro de Contêiner do Azure ou o Docker.
Baixar pacotes Nuget do GitHub DownloadGitHubNugetPackage@1	Restaure seus pacotes nuget usando a CLI dotnet.
Go 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 Gradle.
Grunt Grunt@0	Execute o executor de tarefas JavaScript Grunt.
Gole 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.
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.
MSBuild MSBuild@1	Compilar com o MSBuild.
Preparar a Configuração de Análise SonarQubePrepare@5 SonarQubePrepare@4	Preparar a configuração de análise do SonarQube.
Publicar Resultado do Portão de Qualidade SonarQubePublish@5 SonarQubePublish@4	Publique o resultado do Portão de Qualidade do SonarQube no resultado da compilação do Azure DevOps, a ser usado após a análise real.
Executar análise de código SonarQubeAnalyze@5 SonarQubeAnalyze@4	Execute o scanner e carregue os resultados no servidor SonarQube.
Build do Visual Studio VSBuild@1	Crie com o MSBuild e defina a propriedade de versão do Visual Studio.
Xamarin.Android XamarinAndroid@1	Crie um aplicativo Android com o Xamarin.
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.
Xcode Build Xcode@3 Xcode@2	Crie um workspace do Xcode no macOS.
Xcode Package 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
Distribuição do App Center AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	Distribua builds de aplicativo para testadores e usuários por meio do Visual Studio App Center.
Implantação do modelo do ARM AzureResourceManagerTemplateDeployment@3	Implante um modelo do ARM (Azure Resource Manager) em todos os escopos de implantação.
Serviço de Aplicativo do Azure Clássico (preterido) AzureWebPowerShellDeployment@1	Crie ou atualize Serviço de Aplicativo do Azure usando Azure PowerShell.
implantação Serviço de Aplicativo do Azure AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Implante para 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.
Serviço de Aplicativo do Azure gerenciar AzureAppServiceManage@0	Iniciar, parar, reiniciar, trocar slot, excluir slot, instalar extensões de site ou habilitar o monitoramento contínuo para um Serviço de Aplicativo do Azure.
Configurações de 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 ser executado no agente do Windows.
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.
implantação de 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.
Cópia de arquivo do Azure AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	Copie arquivos para Armazenamento de Blobs do Azure ou máquinas virtuais.
Função do Azure no Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Implantar a função do Azure no cluster do Kubernetes.
implantação de 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 contêiner AzureFunctionAppContainer@1	Atualize um aplicativo de funções com um contêiner do Docker.
Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	Baixe os segredos de Key Vault do Azure.
Alertas do Azure Monitor (preteridos) AzureMonitorAlerts@0	Configurar alertas em métricas disponíveis para um recurso do Azure (preterido).
PowerShell do Azure AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	Execute um script do PowerShell em um ambiente do Azure.
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.
Implantação do Grupo de Recursos do Azure AzureResourceGroupDeployment@1	Implantar, iniciar, parar, excluir Grupos de Recursos do Azure.
Azure Spring Apps AzureSpringCloud@0	Implante aplicativos no Azure Spring Apps e gerencie implantações.
Tarefa de 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.
Aplicativo Web do Azure AzureWebApp@1	Implantar um Aplicativo Web do Azure para Linux ou Windows.
Aplicativo Web para Contêineres do Azure AzureWebAppContainer@1	Implantar contêineres no Serviço de Aplicativo do Azure.
Criar 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 conformidade do Azure Policy AzurePolicyCheckGate@0	Avaliação de segurança e conformidade para Azure Policy.
Chef Chef@1	Implante em ambientes do Chef editando atributos de ambiente.
Faca chef ChefKnife@1	Execute scripts com comandos Knife em sua estação de trabalho do Chef.
Copiar arquivos por SSH CopyFilesOverSSH@0	Copie arquivos ou compile artefatos para um computador remoto por SSH.
Implantar para o 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 de aplicativo Web do IIS (preterido) IISWebAppDeployment@1	Implante usando MSDeploy e, em seguida, crie/atualize sites e pools de aplicativos.
Gerenciamento de aplicativo Web do IIS IISWebAppManagementOnMachineGroup@0	Criar ou atualizar sites, aplicativos Web, diretórios virtuais ou pools de aplicativos.
Invocar API REST InvokeRESTAPI@1 InvokeRESTAPI@0	Invoque uma API REST como parte do pipeline.
kubectl Kubernetes@1 Kubernetes@0	Implante, configure e atualize um cluster do Kubernetes no Serviço de Contêiner do Azure executando comandos kubectl.
Intervenção manual ManualIntervention@8	Pause a implantação e aguarde a intervenção manual.
Validação manual ManualValidation@0	[VERSÃO PRÉVIA] Pause uma execução de pipeline para aguardar a interação manual. Funciona apenas 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@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.
Implantação de aplicativo da Malha do Serviço 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.
SQL Server implantação de banco de dados SqlDacpacDeploymentOnMachineGroup@0	Implante um banco de dados SQL Server usando scripts DACPAC ou SQL.
SQL Server implantação de banco de dados (preterido) SqlServerDacpacDeployment@1	Implante um banco de dados SQL Server usando DACPAC.
SSH SSH@0	Execute comandos do shell ou um script em um computador remoto usando SSH.
Cópia de arquivo de computador do Windows WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	Copie 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 crates 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 o Pacote Npm do Github DownloadGithubNpmPackage@1	Instale pacotes npm do GitHub.
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 do 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 executores de tarefas npm, como gulp e Grunt, se autentiquem com registros privados.
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 o 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	Configurar 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.
Comando 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.
Instalador do NuGet NuGetInstaller@0	Instala ou restaura pacotes NuGet ausentes. Use NuGetAuthenticate@0 tarefa para recursos mais recentes.
Empacotador do 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.
Publicador 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.
Restauração do NuGet NuGetRestore@1	Restaura pacotes NuGet em preparação para uma etapa de Build do Visual Studio.
Publicador de PyPI PyPIPublisher@0	Crie e carregue um sdist ou roda em um índice compatível com PyPI usando Twine.
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.
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 gêmeo. 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.
Restauração do componente Xamarin XamarinComponentRestore@0	Essa tarefa foi preterida. Em vez disso, use 'NuGet'.

Tarefas de teste

Tarefa	Descrição
Teste do App Center AppCenterTest@1	Testar pacotes de aplicativos com o Visual Studio App Center.
Teste de carga do Azure AzureLoadTest@1	Automatize o teste de regressão de desempenho com o Teste de Carga do Azure.
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 arquivos, testes de conteúdo de arquivo e testes de metadados.
Teste do Mobile Center VSMobileCenterTest@0	Testar 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 resultados de teste no Azure Pipelines.
Publicar resultados do teste PublishTestResults@2	Publicar resultados de 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 testes com falha automaticamente.
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).
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.
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.
Xamarin Test Cloud 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 da ferramenta

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 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 agente.
Instalar o Azure Func Core Tools FuncToolsInstaller@0	Instale o Azure Func Core Tools.
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.
Instalador da ferramenta kubectl KubectlInstaller@0	Instale o Kubectl no computador do agente.
Instalador de ferramentas do Kubelogin KubeloginInstaller@0	Ajuda a instalar o kubelogin.
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 esta tarefa para alterar a versão do NuGet usada nas tarefas do NuGet.
Usar o .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 Node.js ecossistema UseNode@1 NodeTool@0	Configure um ambiente de Node.js e adicione-o ao PATH, além de fornecer suporte a proxy.
Usar a 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.
Instalador da plataforma de teste do Visual Studio VisualStudioTestPlatformInstaller@1	Adquira a plataforma de teste do 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
Verificação avançada de dependência de segurança AdvancedSecurity-Dependency-Scanning@1	Verifique código aberto vulnerabilidades de dependência no código-fonte.
Arquivos de arquivo morto ArchiveFiles@2	Compacte arquivos em .7z, .tar.gz ou .zip.
Arquivamento ArchiveFiles@1	Arquive arquivos usando formatos de compactação como .7z, .rar, .tar.gz e .zip.
Balanceador de Carga de Rede do Azure 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.
Script de 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. 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).
cURL carregar arquivos cURLUploader@2 cURLUploader@1	Use os protocolos com suporte do cURL para carregar arquivos.
Descriptografar arquivo (OpenSSL) DecryptFile@1	Descriptografe um arquivo usando OpenSSL.
Atraso Delay@1	Atrase a execução de um fluxo de trabalho por um tempo fixo.
Excluir arquivos DeleteFiles@1	Exclua pastas ou arquivos que correspondam a um padrão.
Implantar o Aplicativo Web Estático do Azure AzureStaticWebApp@0	Compilar e implantar um Aplicativo Web Estático do Azure.
Baixar artefatos do 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 um build concluído.
Baixar a 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 arquivo seguro DownloadSecureFile@1	Baixe um arquivo seguro no computador do agente.
Extrair arquivos ExtractFiles@1	Extraia uma variedade de arquivos de arquivos e compactação, como .7z, .rar, .tar.gz e .zip.
Transformação de arquivo FileTransform@2 FileTransform@1	Substitua tokens por valores variáveis em arquivos de configuração XML ou JSON.
Upload de FTP FtpUpload@2 FtpUpload@1	Carregue arquivos usando FTP.
Comentário do GitHub GitHubComment@0	Escreva um comentário para sua entidade do GitHub, ou seja, um problema ou uma PR (solicitação de pull).
Versão do GitHub GitHubRelease@1 GitHubRelease@0	Criar, editar ou excluir uma versão do GitHub.
Instalar o certificado da Apple InstallAppleCertificate@2	Instale um certificado da Apple necessário para compilar em um computador agente macOS.
Instalar o Apple Certificate InstallAppleCertificate@1 InstallAppleCertificate@0	Instale um certificado da Apple necessário para compilar em um agente macOS.
Instalar o perfil de provisionamento da Apple InstallAppleProvisioningProfile@1	Instale um perfil de provisionamento da Apple necessário para compilar em um computador agente macOS.
Instalar o Perfil de Provisionamento da Apple InstallAppleProvisioningProfile@0	Instale um perfil de provisionamento da Apple necessário para compilar em um agente macOS.
Instalar chave SSH InstallSSHKey@0	Instale uma chave SSH antes de um build ou implantação.
Invocar a Função do Azure AzureFunction@1 AzureFunction@0	Invocar uma função do Azure.
Artefatos de download do Jenkins JenkinsDownloadArtifacts@1	Baixe artefatos produzidos por um trabalho do Jenkins.
Node.js instalador do executor de tarefas NodeTaskRunnerInstaller@0	Instale uma versão Node.js específica para executar tarefas de nó.
Notation Notation@0	Tarefa Pipepine do Azure para configurar a CLI de Notação, assinar e verificar com Notação.
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	Publicar (carregar) um arquivo ou diretório como um artefato nomeado para a execução atual.
Publicar metadados de pipeline PublishPipelineMetadata@0	Publique metadados de pipeline no repositório de evidências.
Publicar no Barramento de Serviço do Azure PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	Envia uma mensagem para Barramento de Serviço do Azure usando uma conexão de serviço (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 do Azure Monitor clássicas configuradas para alertas ativos.
Consultar itens de trabalho queryWorkItems@0	Execute uma consulta de item de trabalho e marcar o número de itens retornados.
Examinar Aplicativo ReviewApp@0	Use essa tarefa no provedor de fase de implantação para criar um recurso dinamicamente.
Service Fabric PowerShell ServiceFabricPowerShell@1	Execute um script do PowerShell no contexto de uma conexão de cluster do Azure Service Fabric.
Script de Shell ShellScript@2	Execute um script de shell usando 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.
Licença do Xamarin XamarinLicense@1	[Preterido] Atualizar para a versão gratuita do Xamarin: https://store.xamarin.com.

Software livre

Essas tarefas são de código aberto no GitHub. Comentários e contribuições são bem-vindos. Consulte Pipeline task changelog para obter uma lista de alterações de tarefa, incluindo um registro histórico de atualizações de tarefas.

Perguntas frequentes

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 opcionais aliases. O exemplo a seguir é um trecho do código-fonte para a entrada Entrada de Hosts Conhecidos da tarefa InstallSSHKey@0 .

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

Antes de os 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 name de tarefa 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 InstallSSHKey@0 tarefa tem uma entrada de Entrada de Hosts Conhecidos chamada hostName que espera uma entrada de um arquivo de 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 hostName nome em um pipeline YAML. Os aliases de entrada da tarefa foram introduzidos para permitir que os autores de tarefas forneçam nomes descritivos para suas tarefas criadas anteriormente e, para a InstallSSHKey@0 tarefa, um knownHostsEntryalias foi adicionado, mantendo o nome original hostName para compatibilidade com pipelines existentes usando esse nome.

Todos os itens em uma entrada de aliases 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, foi introduzido o editor de pipeline yaml, que fornece uma funcionalidade de tipo intellisense.

O editor de pipeline yaml usa a API REST Yamlschema – Get 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 da tarefa Entrada de Hosts Conhecidos para a InstallSSHKey@0 tarefa do esquema YAML, com knownHostsEntry listada na posição do nome e hostName na aliases coleção.

"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 pela tarefa assistente 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 Azure Pipelines código aberto repositório.
• 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 de usuário integrado, como descrições avançadas de entrada de tarefa, comentários e exemplos.
• Fornece cobertura de tarefa para todas as versões compatíveis do Azure DevOps.
• Atualizado a cada sprint para cobrir as atualizações mais recentes.

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

Onde posso aprender passo a passo como criar meu aplicativo?

Compilar o aplicativo

Posso adicionar minhas 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, confira Instaladores de ferramentas.