Azure Pipelines タスク リファレンス

タスクはパイプラインでアクションを実行します。 たとえば、タスクでは、アプリの構築、Azure リソースの操作、ツールのインストール、テストの実行などを行うことができます。 タスクは、パイプラインで自動化を定義するための構成要素です。

このセクションの記事では、Azure Pipelines の組み込みタスクについて説明し、タスクごとに特別な意味を持つ属性のセマンティクスを指定します。

タスクでサポートされる一般的な属性の詳細については、steps.task の YAML リファレンスを参照してください。

カスタム タスクの作成、カスタム拡張機能、Visual Studio Marketplace でのタスクの検索など、タスクを使用してパイプラインを作成する方法とチュートリアルについては、タスクの概念の と Azure Pipelines ドキュメント を参照してください。

大事な

プラットフォームで使用できるタスクのタスク 参照を表示するには、目次の上にあるバージョン セレクターから正しい Azure DevOps バージョンを選択していることを確認します。 機能のサポートは、Azure DevOps Services とオンプレミス バージョンの Azure DevOps Server のどちらを使用しているかによって異なります。
使用しているオンプレミスのバージョンについては、「Azure DevOps プラットフォームとバージョンを検索する」を参照してください。

ビルド タスク

タスク	形容
.NET Core の DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	dotnet アプリケーションをビルド、テスト、パッケージ化、発行するか、カスタム dotnet コマンドを実行します。
Advanced Security AutoBuild の AdvancedSecurity-Codeql-Autobuild@1	ソース フォルダー内のプロジェクト ファイルを検索してビルドすることで、リポジトリのビルドを試みます。
Advanced Security Initialize CodeQL AdvancedSecurity-Codeql-Init@1 の	ビルドの準備として CodeQL データベースを初期化します。
Advanced Security Perform CodeQL analysis AdvancedSecurity-Codeql-Analyze@1	CodeQL データベースを最終処理し、分析クエリを実行します。
Advanced Security Publish Results AdvancedSecurity-Publish@1	コード スキャン ツールによって生成された SARIF ファイルを結合し、結合された SARIF ファイルを拡張し、拡張された SARIF ファイルを Advanced Security サービスに発行します。
Android ビルド を する AndroidBuild@1	AndroidBuild@1は非推奨です。 Gradle を使用します。
Android 署名 の AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	Android APK ファイルに署名して配置します。
Ant Ant@1	Apache Ant を使用してビルドします。
Azure IoT Edge の AzureIoTEdge@2	Azure IoT Edge イメージをビルドしてデプロイします。
CMake を する CMake@1	CMake クロスプラットフォーム ビルド システムを使用してビルドします。
コンテナー ビルド ContainerBuild@0	コンテナー ビルド タスク。
Docker Docker@2 Docker@1 Docker@0	Docker イメージのビルドまたはプッシュ、ログインまたはログアウト、コンテナーの開始または停止、Docker コマンドの実行。
Docker Compose DockerCompose@1 DockerCompose@0	複数コンテナーの Docker アプリケーションをビルド、プッシュ、または実行します。 タスクは、Docker または Azure Container Registry で使用できます。
GitHub Nuget パッケージのダウンロード DownloadGitHubNugetPackage@1	dotnet CLI を使用して Nuget パッケージを復元します。
Go Go@0	Go アプリケーションを取得、ビルド、またはテストするか、カスタム Go コマンドを実行します。
Gradle Gradle@3 Gradle@2 Gradle@1	Gradle ラッパー スクリプトを使用してビルドします。
Grunt Grunt@0	Grunt JavaScript タスク ランナーを実行します。
gulp を する gulp@1 gulp@0	ストリーミング タスク ベースのビルド システム Node.js gulp を実行します。
ソースのインデックス作成とシンボルの発行 PublishSymbols@2 PublishSymbols@1	ソース コードのインデックスを作成し、シンボルをファイル共有または Azure Artifacts シンボル サーバーに発行します。
Jenkins キュー ジョブ の JenkinsQueueJob@2	Jenkins サーバーでジョブをキューに登録します。
Jenkins キュー ジョブ の JenkinsQueueJob@1	Jenkins サーバーでジョブをキューに登録します。
Maven の Maven@4 Maven@3 Maven@2 Maven@1	Apache Maven を使用してビルド、テスト、デプロイを行います。
MSBuild の MSBuild@1	MSBuild を使用してビルドします。
分析構成の準備 SonarQubePrepare@7 SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	SonarQube 分析構成を準備します。
品質ゲートの結果 を公開する SonarQubePublish@7 SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	実際の分析後に使用する、SonarQube の Quality Gate の結果を Azure DevOps ビルド結果に発行します。
コード分析 を実行する SonarQubeAnalyze@7 SonarQubeAnalyze@6 SonarQubeAnalyze@5 SonarQubeAnalyze@4	スキャナーを実行し、結果を SonarQube サーバーにアップロードします。
Visual Studio ビルド の VSBuild@1	MSBuild を使用してビルドし、Visual Studio のバージョン プロパティを設定します。
Xamarin.Android の XamarinAndroid@1	Xamarin を使用して Android アプリをビルドします。
Xamarin.iOS の XamariniOS@2 XamariniOS@1	macOS 上の Xamarin を使用して iOS アプリを構築します。
Xcode の Xcode@5 Xcode@4	macOS で Xcode ワークスペースをビルド、テスト、またはアーカイブします。 必要に応じて、アプリをパッケージ化します。
Xcode ビルド の Xcode@3 Xcode@2	macOS で Xcode ワークスペースを構築します。
Xcode パッケージ iOS XcodePackageiOS@0	xcrun (Xcode 7 以下) を使用して Xcode ビルド出力から .ipa ファイルを生成します。

タスクをデプロイする

タスク	形容
App Center の配布 AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	Visual Studio App Center を使用してテスト担当者とユーザーにアプリ ビルドを配布します。
ARM テンプレートのデプロイ の AzureResourceManagerTemplateDeployment@3	すべてのデプロイ スコープに Azure Resource Manager (ARM) テンプレートをデプロイします。
Azure App Configuration Export を する AzureAppConfigurationExport@10	Azure App Configuration からタスク変数にキー値をダウンロードします。
Azure App Service クラシック (非推奨) AzureWebPowerShellDeployment@1	Azure PowerShell を使用して Azure App Service を作成または更新します。
Azure App Service のデプロイ の AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Docker、Java、.NET、.NET Core、Node.js、PHP、Python、または Ruby を使用して、Web、モバイル、または API アプリを Azure App Service にデプロイします。
Azure App Service の の管理 AzureAppServiceManage@0	Azure App Service の開始、停止、再起動、スロット スワップ、スロットの削除、サイト拡張機能のインストール、または継続的な監視を有効にします。
Azure App Service の設定 を する AzureAppServiceSettings@1	Azure Web App for Linux または Windows のアプリ設定を更新または追加します。
Azure CLI の AzureCLI@2 AzureCLI@1	Linux エージェントで実行する場合は PowerShell Core/Shell スクリプト、Windows エージェントで実行する場合は PowerShell/PowerShell Core/Batch スクリプトで Azure サブスクリプションに対して Azure CLI コマンドを実行します。
Azure CLI プレビュー の AzureCLI@0	Azure サブスクリプションに対して Azure CLI コマンドを使用してシェルまたは Batch スクリプトを実行します。
Azure Cloud Service デプロイ を する AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Azure クラウド サービスをデプロイします。
Azure Container Apps のデプロイ の AzureContainerApps@1 AzureContainerApps@0	Azure Container Apps をビルドしてデプロイするための Azure DevOps タスク。
Azure Database for MySQL のデプロイ を する AzureMysqlDeployment@1	スクリプトを実行し、Azure Database for MySQL に変更を加えます。
Azure ファイル コピー を する AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	Azure Blob Storage または仮想マシンにファイルをコピーします。
Kubernetes での Azure 関数の AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Kubernetes クラスターに Azure 関数をデプロイします。
Azure Functions Deploy AzureFunctionApp@2 AzureFunctionApp@1	.NET、Python、JavaScript、PowerShell、Java ベースの Web アプリケーションを使用して関数アプリを更新します。
コンテナー 用の Azure Functions を する AzureFunctionAppContainer@1	Docker コンテナーを使用して関数アプリを更新します。
Azure Key Vault を する AzureKeyVault@2 AzureKeyVault@1	Azure Key Vault シークレットをダウンロードします。
Azure Monitor アラートの (非推奨) AzureMonitorAlerts@0	Azure リソースで使用可能なメトリックに関するアラートを構成する (非推奨)。
Azure PowerShell の AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	Azure 環境内で PowerShell スクリプトを実行します。
Azure リソース グループのデプロイ を する AzureResourceGroupDeployment@2	Azure Resource Manager (ARM) テンプレートをリソース グループにデプロイし、仮想マシンを管理します。
Azure リソース グループのデプロイ の AzureResourceGroupDeployment@1	Azure リソース グループをデプロイ、開始、停止、削除します。
Azure Spring Apps の AzureSpringCloud@0	Azure Spring Apps にアプリケーションをデプロイし、デプロイを管理します。
Azure SQL Database のデプロイ を する SqlAzureDacpacDeployment@1	DACPAC を使用して Azure SQL Database をデプロイするか、SQLCMD を使用してスクリプトを実行します。
Azure VM スケール セットのデプロイ を する AzureVmssDeployment@0	仮想マシン スケール セット イメージをデプロイします。
Azure Web App AzureWebApp@1	Linux または Windows 用の Azure Web アプリをデプロイします。
Azure Web App for Containers AzureWebAppContainer@1	Azure App Service にコンテナーをデプロイします。
マシン イメージのビルド PackerBuild@1 PackerBuild@0	Packer を使用してマシン イメージを構築します。これは、Azure 仮想マシン スケール セットのデプロイに使用できます。
Azure Policy コンプライアンス を確認する AzurePolicyCheckGate@0	Azure Policy のセキュリティとコンプライアンスの評価。
Chef Chef@1	環境属性を編集して Chef 環境にデプロイします。
シェフナイフ ChefKnife@1	Chef ワークステーションで Knife コマンドを使用してスクリプトを実行します。
SSH 経由でファイルをコピーする CopyFilesOverSSH@0	SSH 経由でリモート コンピューターにファイルをコピーするか、成果物をビルドします。
Kubernetes へのデプロイの KubernetesManifest@1 KubernetesManifest@0	Kubernetes マニフェスト ファイルを使用してクラスターにデプロイしたり、Helm チャートを使用してデプロイに使用するマニフェスト ファイルをベイクしたりできます。
IIS Web アプリの展開 IISWebAppDeploymentOnMachineGroup@0	Web 配置を使用して Web サイトまたは Web アプリケーションをデプロイします。
IIS Web アプリの展開 (非推奨) IISWebAppDeployment@1	MSDeploy を使用してデプロイし、Web サイトとアプリ プールを作成/更新します。
IIS Web アプリで を管理する IISWebAppManagementOnMachineGroup@0	Web サイト、Web アプリ、仮想ディレクトリ、またはアプリケーション プールを作成または更新します。
REST API を呼び出す InvokeRESTAPI@1 InvokeRESTAPI@0	パイプラインの一部として REST API を呼び出します。
Kubectl を する Kubernetes@1 Kubernetes@0	kubectl コマンドを実行して、Azure Container Service で Kubernetes クラスターをデプロイ、構成、更新します。
手動介入 の ManualIntervention@8	デプロイを一時停止し、手動による介入を待ちます。
手動検証 ManualValidation@1 ManualValidation@0	パイプラインの実行を一時停止して、手動操作を待機します。 YAML パイプラインでのみ機能します。
MySQL データベースのデプロイ MysqlDeploymentOnMachineGroup@1	スクリプトを実行し、MySQL データベースに変更を加えます。
Helm チャート のパッケージ化とデプロイを する HelmDeploy@1 HelmDeploy@0	Helm コマンドを実行して、Azure Container Service で Kubernetes クラスターをデプロイ、構成、更新します。
ターゲット マシン で PowerShell を する PowerShellOnTargetMachines@3	リモート処理のために PSSession と Invoke-Command を使用して、リモート コンピューターで PowerShell スクリプトを実行します。
ターゲット マシン での PowerShell の PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	リモート コンピューターで PowerShell スクリプトを実行します。
Service Fabric アプリケーションのデプロイ を する ServiceFabricDeploy@1	Azure Service Fabric アプリケーションをクラスターにデプロイします。
Service Fabric Compose のデプロイ ServiceFabricComposeDeploy@0	Docker Compose アプリケーションを Azure Service Fabric クラスターにデプロイします。
SQL Server データベースのデプロイ SqlDacpacDeploymentOnMachineGroup@0	DACPAC または SQL スクリプトを使用して SQL Server データベースをデプロイします。
SQL Server データベースのデプロイ (非推奨) SqlServerDacpacDeployment@1	DACPAC を使用して SQL Server データベースをデプロイします。
SSH を する SSH@0	SSH を使用してリモート コンピューターでシェル コマンドまたはスクリプトを実行します。
Windows マシン ファイルのコピー を する WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	リモートの Windows マシンにファイルをコピーします。

パッケージ タスク

タスク	形容
Cargo 認証 (タスク ランナーの場合) CargoAuthenticate@0	Cargo crates ディストリビューションのインストールに使用される貨物クライアントの認証タスク。
CocoaPods CocoaPods@0	Swift プロジェクトと Objective-C Cocoa プロジェクトの CocoaPods 依存関係をインストールします。
Conda 環境 を する CondaEnvironment@1 CondaEnvironment@0	このタスクは非推奨です。 Anaconda 環境を操作するには、スクリプトで conda を直接使用します。
Github Npm パッケージ をダウンロードする DownloadGithubNpmPackage@1	GitHub から npm パッケージをインストールします。
Maven 認証 の MavenAuthenticate@0	Azure Artifacts フィードと外部 Maven リポジトリの資格情報を提供します。
npm を する Npm@1 Npm@0	npm パッケージをインストールして発行するか、npm コマンドを実行します。 Azure Artifacts などの npmjs.com および認証済みレジストリをサポートします。
npm 認証 (タスク ランナーの場合) npmAuthenticate@0	npm タスクも使用している場合は、このタスクを使用しないでください。 ビルドのスコープについて、リポジトリ内の .npmrc ファイルに npm 資格情報を提供します。 これにより、gulp や Grunt などの npm タスク ランナーがプライベート レジストリで認証できるようになります。
NuGet の NuGetCommand@2	NuGet パッケージを復元、パック、またはプッシュするか、NuGet コマンドを実行します。 Azure Artifacts や MyGet などの NuGet.org および認証済みフィードをサポートします。 NuGet.exe を使用し、.NET Framework アプリで動作します。 .NET Core アプリと .NET Standard アプリの場合は、.NET Core タスクを使用します。
NuGet 認証 NuGetAuthenticate@1 NuGetAuthenticate@0	Azure Artifacts やその他の NuGet リポジトリで認証するように NuGet ツールを構成します。 NuGet >= 4.8.5385、dotnet >= 6、または MSBuild >= 15.8.166.59604 が必要です。
NuGet コマンド を する NuGet@0	非推奨: 代わりに "NuGet" タスクを使用してください。 新しいツール インストーラー フレームワークで動作するため、タスクの更新を待たずに新しいバージョンの NuGet を簡単に使用でき、この組織/コレクションの外部で認証されたフィードのサポートが向上し、既定では NuGet 4 が使用されます。
NuGet インストーラー の NuGetInstaller@0	不足している NuGet パッケージをインストールまたは復元します。 最新の機能NuGetAuthenticate@0タスクを使用します。
NuGet パッケージャー を する NuGetPackager@0	非推奨: 代わりに "NuGet" タスクを使用してください。 新しいツール インストーラー フレームワークで動作するため、タスクの更新を待たずに新しいバージョンの NuGet を簡単に使用でき、この組織/コレクションの外部で認証されたフィードのサポートが向上し、既定では NuGet 4 が使用されます。
NuGet パブリッシャー の NuGetPublisher@0	非推奨: 代わりに "NuGet" タスクを使用してください。 新しいツール インストーラー フレームワークで動作するため、タスクの更新を待たずに新しいバージョンの NuGet を簡単に使用でき、この組織/コレクションの外部で認証されたフィードのサポートが向上し、既定では NuGet 4 が使用されます。
NuGet 復元 の NuGetRestore@1	Visual Studio ビルド ステップの準備として NuGet パッケージを復元します。
PyPI パブリッシャー を する PyPIPublisher@0	Twine を使用して、sdist または wheel を作成して PyPI 互換インデックスにアップロードします。
Python pip の認証 を する PipAuthenticate@1 PipAuthenticate@0	Python ディストリビューションのインストールに使用される pip クライアントの認証タスク。
python twine アップロード 認証 TwineAuthenticate@1 TwineAuthenticate@0	Twine を使用して Python ディストリビューションをアップロードするための認証。 twine upload コマンドに '-r FeedName/EndpointName --config-file $(PYPIRC_PATH)' を追加します。 この組織に存在するフィードの場合は、リポジトリ (-r) としてフィード名を使用します。 それ以外の場合は、サービス接続で定義されているエンドポイント名を使用します。
ユニバーサル パッケージ を する UniversalPackages@0	ユニバーサル パッケージをダウンロードまたは発行します。
Xamarin コンポーネントの復元 の XamarinComponentRestore@0	このタスクは非推奨です。 代わりに 'NuGet' を使用してください。

テスト タスク

タスク	形容
App Center のテスト AppCenterTest@1	Visual Studio App Center を使用してアプリ パッケージをテストします。
Azure Load Testing AzureLoadTest@1	Azure Load Testing を使用してパフォーマンス回帰テストを自動化します。
コンテナー構造テスト ContainerStructureTest@0	コンテナー構造テスト (https://github.com/GoogleContainerTools/container-structure-test) を使用して、コマンド テスト、ファイル存在テスト、ファイル コンテンツ テスト、メタデータ テストの 4 つのカテゴリに基づいてイメージの構造を検証します。
Mobile Center テスト VSMobileCenterTest@0	Visual Studio Mobile Center を使用してモバイル アプリ パッケージをテストします。
コード カバレッジの結果を発行 PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	ビルドからコード カバレッジの結果を発行します。
テスト結果 を発行する PublishTestResults@1	テスト結果を Azure Pipelines に発行します。
テスト結果 発行 PublishTestResults@2	テスト結果を Azure Pipelines に発行します。
機能テストの実行 RunVisualStudioTestsusingTestAgent@1	非推奨: このタスクとそのコンパニオン タスク (Visual Studio テスト エージェントの配置) は非推奨です。 代わりに 'Visual Studio テスト' タスクを使用してください。 VSTest タスクでは、単体テストと機能テストを実行できます。 マルチエージェント ジョブ設定を使用して、1 つ以上のエージェントでテストを実行します。 "Visual Studio Test Platform" タスクを使用して、エージェントで Visual Studio を必要とせずにテストを実行します。 VSTest タスクには、失敗したテストを自動的に再実行するなどの新しい機能も用意されています。
Visual Studio テスト の VSTest@3 VSTest@2 VSTest@1	Visual Studio テスト (VsTest) ランナーを使用して、単体テストと機能テスト (Selenium、Appium、コード化された UI テストなど) を実行します。 MsTest、xUnit、NUnit、Chutzpah (QUnit、Mocha、および Jasmine を使用する JavaScript テスト用) などの Visual Studio テスト アダプターを持つテスト フレームワークを実行できます。 テストは、このタスク (バージョン 2 以降) を使用して複数のエージェントに配布できます。
Visual Studio テスト エージェントの展開 の DeployVisualStudioTestAgent@2	DeployVisualStudioTestAgent@2は非推奨です。 Visual Studio テスト タスクを使用して、単体テストと機能テストを実行します。
Visual Studio テスト エージェントの展開 の DeployVisualStudioTestAgent@1	一連のマシンでテストを実行するようにテスト エージェントをデプロイして構成します。
Xamarin Test Cloud の XamarinTestCloud@1	[非推奨]Xamarin.UITest を使用して Xamarin Test Cloud でモバイル アプリをテストします。 代わりに、"App Center テスト" タスクを使用します。

ツール タスク

タスク	形容
.NET Core SDK/ランタイム インストーラー の DotNetCoreInstaller@1 DotNetCoreInstaller@0	インターネットまたはローカル キャッシュから特定のバージョンの .NET Core SDK を取得し、PATH に追加します。
Docker CLI インストーラー を する DockerInstaller@0	エージェント コンピューターに Docker CLI をインストールします。
Duffle ツール インストーラー の DuffleInstaller@0	CNAB バンドルをインストールおよび管理するために、指定されたバージョンの Duffle をインストールします。
Go ツール インストーラー GoTool@0	キャッシュ内で検索するか、Go の特定のバージョンをダウンロードして PATH に追加します。
Helm ツール インストーラー の HelmInstaller@1 HelmInstaller@0	エージェント コンピューターに Helm をインストールします。
Azure Func Core Tools をインストールする FuncToolsInstaller@0	Azure Func Core Tools をインストールします。
Java ツール インストーラーの JavaToolInstaller@0	ユーザー指定の Azure BLOB またはツール キャッシュから特定のバージョンの Java を取得し、JAVA_HOME設定します。
Kubectl ツール インストーラー の KubectlInstaller@0	エージェント コンピューターに Kubectl をインストールします。
Kubelogin ツール インストーラー の KubeloginInstaller@0	kubelogin のインストールに役立ちます。
NuGet ツール インストーラー を する NuGetToolInstaller@1 NuGetToolInstaller@0	インターネットまたはツール キャッシュから特定のバージョンの NuGet を取得し、PATH に追加します。 このタスクを使用して、NuGet タスクで使用される NuGet のバージョンを変更します。
.NET Core を使用する UseDotNet@2	インターネットまたはローカル キャッシュから特定のバージョンの .NET Core SDK を取得し、PATH に追加します。 このタスクを使用して、後続のタスクで使用される .NET Core のバージョンを変更します。 さらに、プロキシのサポートも提供します。
Node.js エコシステム を使用する UseNode@1 NodeTool@0	Node.js 環境を設定し、PATH に追加し、さらにプロキシのサポートを提供します。
Python バージョンの を使用する UsePythonVersion@0	ツール キャッシュから指定したバージョンの Python を使用し、必要に応じて PATH に追加します。
Ruby バージョンの を使用する UseRubyVersion@0	ツール キャッシュから指定したバージョンの Ruby を使用し、必要に応じて PATH に追加します。
Visual Studio テスト プラットフォーム インストーラー の VisualStudioTestPlatformInstaller@1	nuget.org またはツール キャッシュからテスト プラットフォームを取得します。 "vstest" の要求を満たし、Visual Studio テスト タスクを使用してテストを実行し、診断データを収集するために使用できます。

ユーティリティ タスク

タスク	形容
高度なセキュリティ依存関係のスキャン を する AdvancedSecurity-Dependency-Scanning@1 の	ソース コードでオープン ソースの依存関係の脆弱性をスキャンします。
アーカイブ ファイル ArchiveFiles@2	ファイルを.7z、.tar.gz、または .zipに圧縮します。
アーカイブ ファイルの ArchiveFiles@1	.7z、.rar、.tar.gz、.zipなどの圧縮形式を使用してファイルをアーカイブします。
Azure App Configuration Import AzureAppConfigurationImport@10	Azure App Configuration インスタンスにキー値をプッシュします。
Azure App Configuration Snapshot AzureAppConfigurationSnapshot@1	Azure App Configuration インスタンスにスナップショットを作成します。
Azure Network Load Balancer の AzureNLBManagement@1	Azure 仮想マシンのネットワーク インターフェイスを Load Balancer のバックエンド アドレス プールに接続または切断します。
Bash Bash@3	macOS、Linux、または Windows で Bash スクリプトを実行します。
Batch スクリプト を する BatchScript@1	Windows コマンドまたはバッチ スクリプトを実行し、必要に応じて環境を変更できるようにします。
キャッシュ の Cache@2	実行間でファイルをキャッシュします。
キャッシュ (ベータ) CacheBeta@1 CacheBeta@0	実行間でファイルをキャッシュします。
コマンド ライン の CmdLine@2 CmdLine@1	Bash on Linux と macOS を使用してコマンド ライン スクリプトを実行し、Windows で cmd.exe します。
ビルド成果物 のコピーと発行の CopyPublishBuildArtifacts@1	CopyPublishBuildArtifacts@1は非推奨です。 代わりに、[ファイルのコピー] タスクと [ビルド成果物の発行] タスクを使用します。
ファイル をコピーする CopyFiles@2	(フォルダー パスではなく) ファイル パスに一致するパターンを使用して、ソース フォルダーからターゲット フォルダーにファイルをコピーします。
ファイルのコピー CopyFiles@1	minimatch パターンを使用してソース フォルダーからターゲット フォルダーにファイルをコピーします (ミニマッチ パターンは、フォルダー パスではなくファイル パスにのみ一致します)。
cURL Upload Files cURLUploader@2 cURLUploader@1	cURL でサポートされているプロトコルを使用してファイルをアップロードします。
Decrypt ファイル (OpenSSL) DecryptFile@1	OpenSSL を使用してファイルの暗号化を解除します。
遅延 Delay@1	ワークフローの実行をさらに一定時間遅らせる。
ファイル を削除する DeleteFiles@1	フォルダー、またはパターンに一致するファイルを削除します。
Azure Static Web App をデプロイする AzureStaticWebApp@0	Azure Static Web アプリをビルドしてデプロイします。
ファイル共有 から成果物をダウンロードする DownloadFileshareArtifacts@1	\share\drop などのファイル共有から成果物をダウンロードします。
ビルド成果物 をダウンロードする DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	完了したビルドの成果物として保存されたファイルをダウンロードします。
GitHub リリース をダウンロード DownloadGitHubRelease@0	リポジトリから GitHub リリースをダウンロードします。
パッケージ をダウンロードする DownloadPackage@1 DownloadPackage@0	Azure Artifacts のパッケージ管理フィードからパッケージをダウンロードします。
パイプライン成果物 のダウンロードを する DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	ビルドとパイプラインの成果物をダウンロードします。
セキュリティで保護されたファイルの をダウンロードする DownloadSecureFile@1	セキュリティで保護されたファイルをエージェント コンピューターにダウンロードします。
ファイル を抽出する ExtractFiles@1	.7z、.rar、.tar.gz、.zipなど、さまざまなアーカイブファイルと圧縮ファイルを抽出します。
ファイル変換 FileTransform@2 FileTransform@1	トークンを XML または JSON 構成ファイルの変数値に置き換えます。
FTP アップロード FtpUpload@2 FtpUpload@1	FTP を使用してファイルをアップロードします。
GitHub コメント を する GitHubComment@0	GitHub エンティティ (問題またはプル要求 (PR) など) にコメントを書き込みます。
GitHub リリース を する GitHubRelease@1 GitHubRelease@0	GitHub リリースを作成、編集、または削除します。
Apple 証明書 をインストールする InstallAppleCertificate@2	macOS エージェント コンピューター上のビルドに必要な Apple 証明書をインストールします。
Apple Certificate をインストール InstallAppleCertificate@1 InstallAppleCertificate@0	macOS エージェントでビルドするために必要な Apple 証明書をインストールします。
Apple プロビジョニング プロファイル をインストールする InstallAppleProvisioningProfile@1	macOS エージェント コンピューター上に構築するために必要な Apple プロビジョニング プロファイルをインストールします。
Apple Provisioning Profile をインストールする InstallAppleProvisioningProfile@0	macOS エージェントでビルドするために必要な Apple プロビジョニング プロファイルをインストールします。
SSH キー をインストールする InstallSSHKey@0	ビルドまたはデプロイの前に SSH キーをインストールします。
Azure 関数 を呼び出す AzureFunction@1 AzureFunction@0	Azure 関数を呼び出します。
Jenkins の成果物のダウンロード JenkinsDownloadArtifacts@1	Jenkins ジョブによって生成された成果物をダウンロードします。
Node.js タスク ランナー インストーラーの NodeTaskRunnerInstaller@0	ノード タスクを実行するために、特定の Node.js バージョンをインストールします。
表記 Notation@0	Notation CLI を設定し、Notation を使用して署名および検証するための Azure Pipepine タスク。
PowerShell の PowerShell@2 PowerShell@1	Linux、macOS、または Windows で PowerShell スクリプトを実行します。
ビルド成果物 を発行する PublishBuildArtifacts@1	ビルド成果物を Azure Pipelines または Windows ファイル共有に発行します。
パイプライン成果物の発行 の PublishPipelineArtifact@1 PublishPipelineArtifact@0	ファイルまたはディレクトリを、現在の実行の名前付き成果物として発行 (アップロード) します。
パイプライン メタデータ の発行 PublishPipelineMetadata@0	パイプライン メタデータを証拠ストアに発行します。
Azure Service Bus に発行する PublishToAzureServiceBus@2 PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	Azure Resource Manager サービス接続を使用して Azure Service Bus にメッセージを送信します (エージェントは必要ありません)。
Python スクリプト を する PythonScript@0	Python ファイルまたはインライン スクリプトを実行します。
Azure Monitor アラートの のクエリを実行する AzureMonitor@1	アクティブなアラートに対して構成された Azure Monitor ルールを確認します。
クラシック Azure Monitor アラート のクエリを する AzureMonitor@0	アクティブなアラートの構成済みのクラシック Azure Monitor ルールを確認します。
作業項目の のクエリ queryWorkItems@0	作業項目クエリを実行し、返された項目の数を確認します。
アプリの を確認する ReviewApp@0	デプロイ フェーズ プロバイダーでこのタスクを使用して、リソースを動的に作成します。
Service Fabric PowerShell の ServiceFabricPowerShell@1	Azure Service Fabric クラスター接続のコンテキストで PowerShell スクリプトを実行します。
シェル スクリプト の ShellScript@2	Bash を使用してシェル スクリプトを実行します。
Service Fabric アプリのバージョンの更新 ServiceFabricUpdateAppVersions@1	パッケージ化された Service Fabric アプリケーションのバージョンを自動的に更新します。
Service Fabric マニフェストの更新 ServiceFabricUpdateManifests@2	パッケージ化された Azure Service Fabric アプリケーションのアプリケーション マニフェストとサービス マニフェストの一部を自動的に更新します。
Xamarin ライセンス の XamarinLicense@1	[非推奨]Xamarin の無料バージョンにアップグレードする: https://store.xamarin.com。

オープンソース

これらのタスクは、GitHub上のオープン ソース です。 フィードバックと投稿は大歓迎です。 タスクの更新の履歴レコードなど、タスクの変更の一覧については、「パイプライン タスク変更ログの」を参照してください。

FAQ

タスク入力エイリアスとは

タスクへの入力は、label(name) によって識別され、1 つ以上の省略可能な aliasesを含めることができます。 次の例は、InstallSSHKey@0 タスクの 既知のホスト エントリ 入力に ソース コードからの抜粋です。

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

YAML パイプラインが 2019 年に導入される前は、UI ベースのパイプライン エディターを使用してパイプラインが作成および編集され、パイプライン作成者がタスク入力を参照するために使用された label のみでした。

YAML パイプラインが 2019 年に導入されたとき、YAML を使用するパイプライン作成者は、タスク入力 name を使用してタスク入力を参照し始めました。 場合によっては、タスク入力名がわかりやすいものではなかったため、タスク入力にわかりやすい名前を追加するために aliases が追加されました。

たとえば、InstallSSHKey@0 タスクには、known_hosts ファイルからのエントリを必要とする hostName という名前の 既知のホスト エントリ 入力があります。 クラシック パイプライン デザイナーの Known Hosts Entry ラベルを使用すると、これは明確になりますが、YAML パイプラインで hostName 名を使用する場合は明確ではありません。 タスク入力エイリアスが導入され、タスク作成者は以前に作成したタスクの名前を減らし、InstallSSHKey@0 タスクの場合は、元の knownHostsEntry 名を保持しながら、その名前を使用して既存のパイプラインとの互換性を保ちながら、hostName追加されました。

タスク入力の aliases 内のすべての項目は、YAML パイプライン内の name と交換可能です。 次の 2 つの YAML スニペットは機能的に同じです。最初の例では knownHostsEntry エイリアスを使用し、2 番目の例は 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

Azure DevOps Server 2019.1 以降では、YAML パイプライン エディターが導入され、Intellisense 型の機能が提供されました。

YAML パイプライン エディターでは、Yamlschema - Get REST API を使用して、エディターでの検証に使用されるスキーマを取得します。 タスク入力にエイリアスがある場合、スキーマはエイリアスをタスク入力のプライマリ YAML 名に昇格し、intellisense によってエイリアスが提案されます。

次の例は、YAML スキーマからの タスクの InstallSSHKey@0 タスク入力で、knownHostsEntry が名前の位置に表示され、hostName コレクションに aliases されています。

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

YAML パイプライン エディターの intellisense には knownHostsEntryが表示され、タスク アシスタント によって生成された YAML は生成された YAML で knownHostsEntry を使用するため、タスク参照ではタスクソース コードからの alias がタスク入力の YAML 名として表示されます。 タスクに複数のエイリアスがある場合 (エイリアスが 2 つあるものがあります)、最初のエイリアスが名前として使用されます。

タスク参照が変更された理由

Azure Pipelines タスクのリファレンス ドキュメントは、次の機能強化をサポートするために現在の場所に移動されました。

• タスクアーティクルは、Azure Pipelines タスクオープン ソース リポジトリのタスク ソース コードを使用して生成されます。
• タスク入力名とエイリアスは、常に最新の状態になるようにタスク ソースから生成されます。
• YAML 構文ブロックは、タスク ソースから生成されるため、最新の状態になります。
• 強化されたタスク入力の説明、解説、例など、統合されたユーザー コンテンツでコミュニティへの投稿をサポートします。
• サポートされているすべての Azure DevOps バージョンのタスク カバレッジを提供します。
• 最新の更新プログラムをカバーするために、すべてのスプリントを更新しました。

投稿するには、タスクコンテンツに貢献する を参照してください。

アプリを構築する方法の詳細については、どこで学習できますか?

アプリ をビルドする

独自のビルド タスクを追加できますか?

はい: ビルド タスク を追加する

インストーラー タスクとは

ツール インストーラー タスクの詳細については、「ツール インストーラーの」を参照してください。