Referência da tarefa 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 desta seção descrevem as tarefas internas para o Azure Pipelines e especificam a semântica para atributos que têm significado especial para cada tarefa.

Consulte o Referência YAML para steps.task para obter detalhes sobre os atributos gerais suportados pelas tarefas.

Para obter instruções e tutoriais sobre como criar pipelines usando tarefas, incluindo a criação de tarefas personalizadas, extensões personalizadas e 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 tarefas disponíveis para sua plataforma, certifique-se de selecionar a versão correta do Azure DevOps no seletor de versão localizado acima do índice. O suporte a recursos difere dependendo se você está trabalhando a partir dos Serviços de DevOps do Azure ou de uma versão local do Servidor de DevOps do Azure.
Para saber qual versão local você está usando, consulte Procurar sua plataforma e versão do Azure DevOps.

Tarefas de compilação

Tarefa	Descrição
.NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	Crie, teste, empacote ou publique um aplicativo .NET ou execute um comando personalizado da CLI do .NET.
Segurança Avançada AutoBuild AdvancedSecurity-Codeql-Autobuild@1	Tenta construir o repositório localizando e construindo 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 construção.
Segurança Avançada Execute a análise CodeQL AdvancedSecurity-Codeql-Analyze@1	Finaliza o banco de dados CodeQL e executa as consultas de análise.
Segurança Avançada Publicar Resultados AdvancedSecurity-Publish@1	Combina o(s) arquivo(s) SARIF produzido(s) pela(s) ferramenta(s) de varredura de código, aprimora o arquivo SARIF combinado e publica o arquivo SARIF aprimorado no serviço de Segurança Avançada.
Android Build AndroidBuild@1	AndroidBuild@1 foi preterido. Use Gradle.
de assinatura do Android AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	Assine e alinhe arquivos APK Android.
Formiga Ant@1	Construa com o Apache Ant.
Azure IoT Edge AzureIoTEdge@2	Crie e implante uma imagem do Azure IoT Edge.
CMake CMake@1	Construa com o sistema de construção multiplataforma CMake.
Container Build ContainerBuild@0	Tarefa de construção de contêiner.
Docker Docker@2 Docker@1 Docker@0	Crie ou envie imagens do Docker, faça login ou logout, inicie ou pare contêineres ou execute um comando do Docker.
Docker Compose DockerCompose@1 DockerCompose@0	Crie, envie ou execute aplicativos Docker de vários contêineres. A tarefa pode ser usada com o Docker ou o Registro de Contêiner do Azure.
Baixar pacotes Nuget do GitHub DownloadGitHubNugetPackage@1	Restaure seus pacotes nuget usando a CLI dotnet.
Vá Go@0	Obtenha, crie ou teste um aplicativo Go ou execute um comando Go personalizado.
Gradle Gradle@3 Gradle@2 Gradle@1	Crie usando um script wrapper Gradle.
Grunt Grunt@0	Execute o executor de tarefas JavaScript Grunt.
gulp gulp@1 gulp@0	Execute o sistema de compilação baseado em tarefas gulp Node.js streaming.
Indexar fontes e publicar símbolos 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.
de trabalho na fila Jenkins JenkinsQueueJob@2	Enfileirar um trabalho em um servidor Jenkins.
Jenkins Queue Job JenkinsQueueJob@1	Enfileirar um trabalho em um servidor Jenkins.
Maven Maven@4 Maven@3 Maven@2 Maven@1	Crie, teste e implante com o Apache Maven.
MSBuild MSBuild@1	Crie com o MSBuild.
Preparar de configuração de análise SonarQubePrepare@7 SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	Prepare a configuração de análise do SonarQube Server.
Publicar o resultado do Quality Gate SonarQubePublish@7 SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	Publique o resultado do Quality Gate do Servidor SonarQube no resultado da compilação do Azure DevOps, para ser usado após a análise real.
Executar análise de código SonarQubeAnalyze@7 SonarQubeAnalyze@6 SonarQubeAnalyze@5 SonarQubeAnalyze@4	Execute o scanner e carregue os resultados para o servidor SonarQube.
de compilação 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	Crie, teste ou arquive um espaço de trabalho Xcode no macOS. Opcionalmente, empacote um aplicativo.
Xcode Build Xcode@3 Xcode@2	Crie um espaço de trabalho Xcode no macOS.
Pacote Xcode iOS XcodePackageiOS@0	Gere um arquivo .ipa a partir da saída de compilação do Xcode usando xcrun (Xcode 7 ou inferior).

Implantar tarefas

Tarefa	Descrição
App Center distribuem AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	Distribua compilações de aplicativos para testadores e usuários por meio do Visual Studio App Center.
de implantação de modelo ARM AzureResourceManagerTemplateDeployment@3	Implante um modelo do Azure Resource Manager (ARM) em todos os escopos de implantação.
de Exportação de Configuração de Aplicativo do Azure AzureAppConfigurationExport@10	Exporte valores-chave para variáveis de tarefa da Configuração do Aplicativo do Azure.
do Serviço de Aplicativo do Azure Classic (preterido) AzureWebPowerShellDeployment@1	Crie ou atualize o Serviço de Aplicativo do Azure usando o Azure PowerShell.
Serviço de Aplicativo do Azure implantar AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Implante no Serviço de Aplicativo do Azure um aplicativo Web, móvel ou 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 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 um Aplicativo Web do Azure para Linux ou Windows.
da CLI do Azure AzureCLI@2 AzureCLI@1	Execute comandos da CLI do Azure em uma assinatura do Azure em um script PowerShell Core/Shell quando executado no agente Linux ou no script PowerShell/PowerShell Core/Batch quando executado no agente do Windows.
de visualização da CLI do Azure AzureCLI@0	Execute um script Shell ou Batch com comandos da CLI do Azure em uma assinatura do Azure.
de implantação do Serviço de Nuvem do Azure AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Implante um Serviço de Nuvem do Azure.
Aplicativos de Contêiner do Azure Implantar AzureContainerApps@1 AzureContainerApps@0	Uma Tarefa de DevOps do Azure 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.
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.
Função do Azure no Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Implante a função do Azure no cluster do Kubernetes.
Azure Functions Implantar AzureFunctionApp@2 AzureFunctionApp@1	Atualize um aplicativo funcional com aplicativos Web baseados em .NET, Python, JavaScript, PowerShell, Java.
Azure Functions para de contêiner AzureFunctionAppContainer@1	Atualize um aplicativo de função 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 (Preterido) AzureMonitorAlerts@0	Configure alertas em métricas disponíveis para um recurso do Azure (Preterido).
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 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	Implante, inicie, pare, exclua Grupos de Recursos do Azure.
Azure Spring Apps AzureSpringCloud@0	Implante aplicativos no Azure Spring Apps e gerencie implantações.
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.
de implantação do conjunto de escala de VM do Azure AzureVmssDeployment@0	Implante uma imagem de conjunto de escala de máquina virtual.
Azure Web App AzureWebApp@1	Implante um Aplicativo Web do Azure para Linux ou Windows.
Aplicativo Web do Azure para Contêineres AzureWebAppContainer@1	Implante contêineres no Serviço de Aplicativo do Azure.
Criar de imagem de máquina PackerBuild@1 PackerBuild@0	Crie uma imagem de máquina usando o Packer, que pode ser usada para a implantação do conjunto de dimensionamento de máquinas virtuais do Azure.
Verificar a conformidade com a Política do Azure AzurePolicyCheckGate@0	Avaliação de segurança e conformidade para a Política do Azure.
Chef Chef@1	Implante em ambientes Chef editando atributos de ambiente.
Chef Knife ChefKnife@1	Execute scripts com comandos Knife na estação de trabalho do Chef.
Copiar ficheiros através de SSH CopyFilesOverSSH@0	Copie arquivos ou construa artefatos para uma máquina remota por SSH.
implantar no Kubernetes KubernetesManifest@1 KubernetesManifest@0	Use os arquivos de manifesto do Kubernetes para implantar em clusters ou até mesmo compile os arquivos de manifesto a serem usados para implantações usando gráficos Helm.
aplicativo Web do IIS implantar IISWebAppDeploymentOnMachineGroup@0	Implante um site ou aplicativo Web usando o Web Deploy.
implantação do IIS Web App (preterido) IISWebAppDeployment@1	Implante usando MSDeploy e, em seguida, crie/atualize sites e pools de aplicativos.
aplicativo Web do IIS gerencia IISWebAppManagementOnMachineGroup@0	Crie ou atualize sites, aplicativos Web, diretórios virtuais ou pools de aplicativos.
Invoque a API REST InvokeRESTAPI@1 InvokeRESTAPI@0	Invoque uma API REST como parte do seu pipeline.
Kubectl Kubernetes@1 Kubernetes@0	Implante, configure, atualize um cluster 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.
de validação manual ManualValidation@1 ManualValidation@0	Pause uma execução de pipeline para aguardar a interação manual. Funciona apenas com pipelines YAML.
banco de dados MySQL implantar MysqlDeploymentOnMachineGroup@1	Execute scripts e faça alterações em um banco de dados MySQL.
Empacotar e implantar gráficos Helm HelmDeploy@1 HelmDeploy@0	Implante, configure, atualize um cluster Kubernetes no Serviço de Contêiner do Azure executando comandos helm.
PowerShell em máquinas de destino PowerShellOnTargetMachines@3	Execute scripts do PowerShell em máquinas remotas usando PSSession e Invoke-Command para comunicação remota.
PowerShell em máquinas de destino PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	Execute scripts do PowerShell na(s) máquina(s) remota(s).
de implantação de aplicativos do Service Fabric ServiceFabricDeploy@1	Implante um aplicativo do Azure Service Fabric em um cluster.
Service Fabric Compose implantar ServiceFabricComposeDeploy@0	Implante um aplicativo Docker Compose em um cluster do Azure Service Fabric.
banco de dados SQL Server implantar SqlDacpacDeploymentOnMachineGroup@0	Implante um banco de dados SQL Server usando scripts DACPAC ou SQL.
de implantação de banco de dados do SQL Server (preterido) SqlServerDacpacDeployment@1	Implante um banco de dados SQL Server usando DACPAC.
SSH SSH@0	Execute comandos shell ou um script em uma máquina remota usando SSH.
de cópia de arquivo de máquina do Windows WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	Copie arquivos para máquinas Windows remotas.

Tarefas do pacote

Tarefa	Descrição
Cargo autenticar (para executores de tarefas) CargoAuthenticate@0	Tarefa de autenticação para o cliente de carga usado para instalar a distribuição de caixas de carga.
CocoaPods CocoaPods@0	Instale dependências do CocoaPods para projetos Swift e Objective-C Cacau.
Ambiente Conda CondaEnvironment@1 CondaEnvironment@0	Esta tarefa foi preterida. Use conda diretamente no script para trabalhar com ambientes Anaconda.
Baixe o pacote Github Npm DownloadGithubNpmPackage@1	Instale pacotes npm do GitHub.
Maven Authenticate MavenAuthenticate@0	Fornece credenciais para feeds de Artefatos do Azure 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.
npm authenticate (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 da compilação. Isso permite que executores de tarefas npm como gulp e Grunt se autentiquem com registros privados.
NuGet NuGetCommand@2	Restaure, empacote ou envie pacotes NuGet ou execute um comando NuGet. Suporta feeds NuGet.org e autenticados como Azure Artifacts e MyGet. Usa NuGet.exe e funciona com aplicativos .NET Framework. Para aplicativos .NET Core e .NET Standard, use a tarefa .NET Core.
NuGet autenticar NuGetAuthenticate@1 NuGetAuthenticate@0	Configure as ferramentas do NuGet para autenticar com os Artefatos do Azure e outros repositórios do NuGet. Requer NuGet >= 4.8.5385, dotnet >= 6 ou MSBuild >= 15.8.166.59604.
comando NuGet NuGet@0	Preterido: use a tarefa "NuGet" em vez disso. 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 obter os recursos mais recentes.
do empacotador NuGet NuGetPackager@0	Preterido: use a tarefa "NuGet" em vez disso. 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 editor NuGet NuGetPublisher@0	Preterido: use a tarefa "NuGet" em vez disso. 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 compilação do Visual Studio.
Editora PyPI PyPIPublisher@0	Crie e carregue um sdist ou roda para um índice compatível com PyPI usando o Twine.
Python pip autenticar PipAuthenticate@1 PipAuthenticate@0	Tarefa de autenticação para o cliente pip usado para instalar distribuições Python.
Python twine upload autenticar TwineAuthenticate@1 TwineAuthenticate@0	Autentique-se para carregar distribuições Python usando o twine. Adicione '-r FeedName/EndpointName --config-file $(PYPIRC_PATH)' ao comando twine upload. 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	Transfira ou publique Pacotes Universais.
de restauração de componentes Xamarin XamarinComponentRestore@0	Esta tarefa foi preterida. Em vez disso, use 'NuGet'.

Tarefas de teste

Tarefa	Descrição
de teste do App Center AppCenterTest@1	Teste pacotes de aplicativos com o Visual Studio App Center.
de Teste de Carga do Azure AzureLoadTest@1	Automatize os testes 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 arquivos, testes de conteúdo de arquivos e testes de metadados.
de teste do Mobile Center 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 da cobertura de código de uma compilação.
Publicar resultados de testes PublishTestResults@1	Publique resultados de teste no Azure Pipelines.
Publicar resultados de testes PublishTestResults@2	Publique resultados de teste no Azure Pipelines.
Executar testes funcionais RunVisualStudioTestsusingTestAgent@1	Preterido: Esta tarefa e sua tarefa complementar (Implantação do Agente de Teste do Visual Studio) foram preteridas. Use a tarefa 'Visual Studio Test' em vez disso. A tarefa VSTest pode executar testes de unidade e funcionais. Execute testes em um ou mais agentes usando a configuração de trabalho multiagente. Use a tarefa 'Visual Studio Test Platform' para executar testes sem precisar do Visual Studio no agente. A tarefa VSTest também traz novos recursos, como a reexecução automática de testes com falha.
de teste do Visual Studio VSTest@3 VSTest@2 VSTest@1	Execute testes funcionais e de unidade (Selenium, Appium, Coded UI test, etc.) usando o executor Visual Studio Test (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).
de 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 Test Agent para executar testes em um conjunto de máquinas.
Xamarin Test Cloud XamarinTestCloud@1	[Preterido] Teste aplicativos móveis com o Xamarin Test Cloud usando o Xamarin.UITest. Em vez disso, use a tarefa 'Teste do App Center'.

Tarefas da ferramenta

Tarefa	Descrição
instalador do .NET Core SDK/runtime 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.
do instalador da CLI do Docker DockerInstaller@0	Instale a CLI do Docker na máquina do agente.
instalador da ferramenta Duffle DuffleInstaller@0	Instale uma versão especificada do Duffle para instalar e gerenciar pacotes CNAB.
instalador da ferramenta Go GoTool@0	Encontre em cache ou baixe uma versão específica do Go e adicione-a ao PATH.
instalador da ferramenta Helm HelmInstaller@1 HelmInstaller@0	Instale o Helm em uma máquina de agente.
Instalar o Azure Func Core Tools FuncToolsInstaller@0	Instale o Azure Func Core Tools.
instalador da ferramenta Java JavaToolInstaller@1 JavaToolInstaller@0	Adquira uma versão específica do Java a partir de um blob do Azure fornecido pelo usuário ou do cache da ferramenta e defina JAVA_HOME.
instalador da ferramenta Kubectl KubectlInstaller@0	Instale o Kubectl na máquina do agente.
instalador da ferramenta Kubelogin KubeloginInstaller@0	Ajuda a instalar o kubelogin.
instalador da ferramenta 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 esta tarefa para alterar a versão do .NET Core usada em tarefas subsequentes. Além disso, fornece suporte a proxy.
Use Node.js ecossistema UseNode@1 NodeTool@0	Configure um ambiente Node.js e adicione-o ao PATH, além de fornecer suporte a proxy.
Usar Python versão UsePythonVersion@0	Use a versão especificada do Python a partir do cache de ferramentas, opcionalmente adicionando-a ao PATH.
Use Ruby versão UseRubyVersion@0	Use a versão especificada do Ruby no cache da ferramenta, 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 da ferramenta. Satisfaz a demanda 'vstest' e pode ser usado para executar testes e coletar dados de diagnóstico usando a tarefa de teste do Visual Studio.

Tarefas utilitárias

Tarefa	Descrição
Análise Avançada de Dependência de Segurança AdvancedSecurity-Dependency-Scanning@1	Analise vulnerabilidades de dependência de código aberto no seu código-fonte.
Arquivar ficheiros ArchiveFiles@2	Comprima ficheiros 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	Importe valores-chave para uma instância de Configuração de Aplicativo do Azure.
Instantâneo de Configuração do Aplicativo do Azure AzureAppConfigurationSnapshot@1	Crie um instantâneo em uma instância de Configuração do Aplicativo do Azure.
do Balanceador de Carga de Rede do Azure AzureNLBManagement@1	Conecte ou desconecte a interface de rede de uma máquina virtual do Azure ao pool de endereços de back-end de um Balanceador de Carga.
Bash Bash@3	Execute um script Bash no macOS, Linux ou Windows.
Script em lote BatchScript@1	Execute um comando do Windows ou script em lote e, opcionalmente, permita que ele altere o ambiente.
Cache Cache@2	Armazene arquivos em cache entre execuções.
Cache (Beta) CacheBeta@1 CacheBeta@0	Armazene 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 construção CopyPublishBuildArtifacts@1	CopyPublishBuildArtifacts@1 foi preterido. Em vez disso, use as tarefas Copiar arquivos e Publicar artefatos de compilação.
Copiar ficheiros 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 minicorrespondência (Os padrões de minicorrespondência corresponderão apenas aos caminhos do arquivo, não aos caminhos da pasta).
cURL Upload de arquivos cURLUploader@2 cURLUploader@1	Use os protocolos suportados pelo cURL para fazer upload de arquivos.
ficheiro de desencriptação (OpenSSL) DecryptFile@1	Desencriptar um ficheiro usando OpenSSL.
Atraso Delay@1	Atrasar 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 o do Aplicativo Web Estático do Azure AzureStaticWebApp@0	Crie e implante um Aplicativo Web Estático do Azure.
Baixar artefatos do de compartilhamento de arquivos DownloadFileshareArtifacts@1	Baixe artefatos de um compartilhamento de arquivos, como \share\drop.
Download construir artefatos DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	Baixe arquivos que foram salvos como artefatos de uma compilação concluída.
Download do GitHub Release DownloadGitHubRelease@0	Baixa uma versão do GitHub de um repositório.
Download do pacote DownloadPackage@1 DownloadPackage@0	Baixe um pacote de um feed de gerenciamento de pacotes no Azure Artifacts.
Download Pipeline Artifacts DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	Faça o download de artefatos de compilação e pipeline.
Baixe o arquivo seguro DownloadSecureFile@1	Transfira um ficheiro seguro para a máquina do agente.
Extrair arquivos ExtractFiles@1	Extraia uma variedade de arquivos compactados e compactados, como .7z, .rar, .tar.gz e .zip.
de transformação de arquivo FileTransform@2 FileTransform@1	Substitua tokens por valores de variáveis em arquivos de configuração XML ou JSON.
de upload FTP FtpUpload@2 FtpUpload@1	Carregue arquivos usando FTP.
de comentários do GitHub GitHubComment@0	Escreva um comentário para sua entidade do GitHub, ou seja, um problema ou uma solicitação pull (PR).
Versão do GitHub GitHubRelease@1 GitHubRelease@0	Crie, edite ou exclua uma versão do GitHub.
Instalar o certificado Apple InstallAppleCertificate@2	Instale um certificado Apple necessário para construir em uma máquina agente macOS.
Instalar o Apple Certificate InstallAppleCertificate@1 InstallAppleCertificate@0	Instale um certificado Apple necessário para construir 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 uma máquina de agente macOS.
Instalar o Apple Provisioning Profile InstallAppleProvisioningProfile@0	Instale um perfil de provisionamento da Apple necessário para criar em um agente do macOS.
Instalar chave SSH InstallSSHKey@0	Instale uma chave SSH antes de uma compilação ou implantação.
Invocar o Azure Function AzureFunction@1 AzureFunction@0	Invoque uma função do Azure.
Jenkins baixar artefatos JenkinsDownloadArtifacts@1	Baixe artefatos produzidos por um trabalho de Jenkins.
Node.js instalador do executor de tarefas NodeTaskRunnerInstaller@0	Instale uma versão Node.js específica para executar tarefas de nó.
Notação Notation@0	Azure Pipepine Task 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 construção PublishBuildArtifacts@1	Publique artefatos de compilação 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 metadados de pipeline PublishPipelineMetadata@0	Publique metadados de pipeline no armazenamento de evidências.
Publicar no do 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).
de script Python PythonScript@0	Execute um arquivo Python ou script embutido.
Consultar alertas do Azure Monitor AzureMonitor@1	Observe as regras configuradas do Azure Monitor para alertas ativos.
Query Classic Azure Monitor alertas AzureMonitor@0	Observe as regras clássicas do Azure Monitor configuradas para alertas ativos.
Consultar itens de trabalho queryWorkItems@0	Execute uma consulta de item de trabalho e verifique o número de itens retornados.
Revisão App ReviewApp@0	Use esta tarefa em 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.
Shell script ShellScript@2	Execute um shell script usando Bash.
Atualizar versões do aplicativo Service Fabric ServiceFabricUpdateAppVersions@1	Atualiza automaticamente as versões de um aplicativo Service Fabric empacotado.
Atualizar manifestos do Service Fabric ServiceFabricUpdateManifests@2	Atualize automaticamente partes de manifestos de aplicativo e serviço em um aplicativo do Azure Service Fabric empacotado.
Xamarin License XamarinLicense@1	[Preterido] Atualize para a versão gratuita do Xamarin: https://store.xamarin.com.

Código aberto

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

Perguntas Frequentes

O que são aliases de entrada de tarefas?

As entradas para uma tarefa são identificadas por um label, namee podem incluir uma ou mais aliasesopcionais. O exemplo a seguir é um trecho do de código-fonte para a entrada Entrada de Hosts Conhecidos do 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 pelos autores do pipeline para fazer referência a uma entrada de tarefa.

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

Por exemplo, a tarefa InstallSSHKey@0 tem uma entrada Entrada de Hosts Conhecidos chamada hostName que espera uma entrada de um arquivo known_hosts. O rótulo Known Hosts Entry no designer de pipeline clássico deixa isso claro, mas não é tão claro ao usar o nome hostName em um pipeline YAML. Os aliases de entrada de tarefas foram introduzidos para permitir que os autores de tarefas forneçam nomes decriptivos 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 entrada de uma tarefa são intercambiáveis com o name em um pipeline YAML. Os dois trechos de 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 YAML foi introduzido, que fornece uma funcionalidade de tipo intellisense.

O editor de pipeline YAML usa o Yamlschema - Get REST API 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 de tarefa, e o alias será sugerido pelo intellisense.

O exemplo a seguir é a entrada de tarefa Known Hosts Entry para a tarefa InstallSSHKey@0 do esquema YAML, com knownHostsEntry listado no nome, posição 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 da tarefa mudou?

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

• Os artigos de tarefas são gerados usando o código-fonte da tarefa do repositório de código aberto de tarefas do Azure Pipelines.
• Os nomes e aliases de entrada de tarefas são gerados a partir da fonte da tarefa para que estejam sempre atualizados.
• Os blocos de sintaxe YAML são gerados a partir da fonte da tarefa para que estejam atualizados.
• Suporta contribuições da comunidade com conteúdo de usuário integrado, como descrições aprimoradas de entrada de tarefas, comentários e exemplos.
• Fornece cobertura de tarefas para todas as versões suportadas do Azure DevOps.
• 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?

Crie seu aplicativo

Posso adicionar minhas próprias tarefas de compilação?

Sim: Adicionar uma tarefa de compilação

O que são tarefas do instalador?

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