.NET Core プロジェクトのビルド、テスト、およびデプロイ

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

この記事では、Azure Pipelines を使用して .NET Core プロジェクトを操作する方法について説明します。この記事では、次のタスクについて説明します。

.NET Core Web アプリを作成し、GitHub リポジトリにアップロードします。
Azure DevOps プロジェクトと Azure Pipelines パイプラインを作成してプロジェクトをビルドします。
セルフホステッドエージェントを使用してビルド環境を設定します。
依存関係を復元し、プロジェクトをビルドし、 .NET Core (DotNetCoreCLI@2) タスクまたはスクリプトを使用してテストします。
.NET Core (DotNetCoreCLI@2) タスクを使用して、他の .NET SDK コマンドをパイプラインに追加します。
コードカバレッジ結果の発行 (Publish code coverage results v2) タスクを使用して、コードカバレッジの結果を発行します。
ビルド出力をパッケージ化し、パイプライン、NuGet フィード、ZIP アーカイブ、またはその他のターゲットに配信します。

.NET Core Web アプリを作成し、GitHub リポジトリにアップロードします。
Azure DevOps プロジェクトと Azure Pipelines パイプラインを作成してプロジェクトをビルドします。
Microsoft がホストするエージェントまたはセルフホステッドエージェントを使用してビルド環境を設定します。
依存関係を復元し、プロジェクトをビルドし、 .NET Core (DotNetCoreCLI@2) タスクまたはスクリプトを使用してテストします。
.NET Core (DotNetCoreCLI@2) タスクを使用して、他の .NET SDK コマンドをパイプラインに追加します。
コードカバレッジ結果の発行 (Publish code coverage results v2) タスクを使用して、コードカバレッジの結果を発行します。
ビルド出力をパッケージ化し、パイプライン、NuGet フィード、ZIP アーカイブ、またはその他のターゲットに配信します。

Note

.NET Framework プロジェクトを操作するには、「.NET Framework を使用した ASP.NET アプリのビルド」を参照してください。

前提条件

この記事のすべての手順を完了するには、次の前提条件が必要です。

Azure DevOps 組織。無料で作成できます。
Azure DevOps プロジェクトを作成し、プロジェクトにパイプラインへのアクセス権を付与できるように、組織のプロジェクト管理者グループのメンバーシップ。 Azure DevOps 組織の所有者は、このメンバーシップを自動的に持ちます。
組織内の Azure DevOps プロジェクト。 Azure DevOps でプロジェクトを作成します。
無料レベルの並列ジョブを要求することで、Microsoft がホストするエージェントでパイプラインを実行する機能。この要求の処理には数日かかる場合があります。詳しくは、「並列ジョブの設定と支払いについて」をご覧ください。
プロジェクト管理者として割り当てることができるサービス接続の管理者または作成者ロール。
GitHub アカウントとリポジトリ。

この記事のすべての手順を完了するには、次の前提条件が必要です。

Azure DevOps コレクション。
組織で作成された Azure DevOps プロジェクト。手順については、「 Azure DevOps でプロジェクトを作成する」を参照してください。
Azure DevOps プロジェクトを作成し、プロジェクトにパイプラインへのアクセス権を付与できるように、プロジェクト管理者グループのメンバーシップ。 Azure DevOps 組織の所有者は、このメンバーシップを自動的に持ちます。
プロジェクト管理者として割り当てることができるサービス接続の管理者または作成者ロール。
GitHub アカウントとリポジトリ。

.NET プロジェクトを作成して GitHub にアップロードする

GitHub リポジトリに既に .NET プロジェクトを使用する場合は、このセクションをスキップできます。

使用する .NET プロジェクトがない場合は、次のようにローカルコンピューターに新しいプロジェクトを作成します。

.NET 8.0 SDK をインストールするか、インストールされていることを確認します。
ローカルコンピューターでターミナルウィンドウを開きます。
プロジェクトディレクトリを作成し、それに移動します。
dotnet new webapp -f net8.0を実行して、新しい .NET 8 Web アプリを作成します。
dotnet runを使用して、アプリケーションをローカルでビルドして実行します。
アプリケーションが起動したら、Ctrl キーを押しながら C キーを押してシャットダウンします。
ローカルプロジェクトをアップロードするか、GitHub リポジトリに接続します。

パイプラインを作成する

使用するパイプラインがある場合は、このセクションをスキップできます。それ以外の場合は、YAML パイプラインエディターまたはクラシックエディターを使用して、次のようにパイプラインを作成できます。

YAML
クラシック

Azure DevOps プロジェクトで、左側のナビゲーションメニューから [パイプライン ] を選択します。
このパイプラインがプロジェクトの最初のパイプラインである場合は、[ 新しい パイプライン] または [パイプラインの作成 ] を選択します。
[コードの場所] 画面で、GitHub を選択します。
サインインするために GitHub にリダイレクトされる場合があります。その場合は、GitHub の資格情報を入力します。
[ リポジトリの選択 ] 画面で、.NET アプリが含まれているリポジトリを選択します。
Azure Pipelines アプリをインストールするために、GitHub にリダイレクトされる場合があります。その場合は、[承認してインストール] を選択します。

[ 構成 ] タブで、[ 詳細を表示 ] を選択し、一覧から ASP.NET Core パイプラインテンプレートを選択します。このテンプレートでは、この記事で説明する手順と設定の多くを提供します。

[構成] タブで [スターターパイプライン] を選択して最小限のパイプラインから開始し、手順と設定を自分で追加することもできます。
[ 校閲 ] タブで、YAML コードを確認します。要件に合わせてファイルをカスタマイズできます。たとえば、別のエージェントプールを指定したり、別の .NET SDK をインストールするタスクを追加したりできます。

Azure DevOps プロジェクトで、左側のナビゲーションメニューから [パイプライン ] を選択します。
このパイプラインがプロジェクトの最初のパイプラインである場合は、[ 新しい パイプライン] または [パイプラインの作成 ] を選択します。
ソースリポジトリの種類を選択します。この例では、GitHub Enterprise Server を使用します。
次の画面で、次の情報を入力します。
- GitHub アカウントの URL ( https://github.com/mynameなど)。
- GitHub 個人用アクセストークン (PAT)。
- my-githubなどのサービス接続名。
［作成］ を選択します
使用する GitHub リポジトリを選択します。
[構成] タブで、[詳細を表示] を選択し、一覧から [ASP.NET Core パイプラインテンプレート] を選択します。このテンプレートでは、この記事で説明する手順と設定の多くを提供します。
新しい YAML パイプラインコードを調べます。要件に合わせて YAML ファイルをカスタマイズすることができます。たとえば、別の .NET SDK をインストールしたり、プロジェクトをテストして発行したりするタスクを追加できます。

準備ができたら、[保存および実行] を選択します。
必要に応じて[ コミット]メッセージを編集し、[ 保存して再度実行] を選択します。
[ 概要 ] タブの [ ジョブ ] セクションでジョブを選択して、パイプラインの動作を監視します。

これで、カスタマイズする準備ができている作業パイプラインが作成されました。

ビルド環境のセットアップ

Azure Pipelines では、セルフホステッドエージェントを使用して .NET Core プロジェクトをビルドします。 .NET Core SDK とランタイムは、 Windows、 Linux、 macOS、または Docker エージェントで使用できます。必要なバージョンの .NET Core SDK とランタイムがエージェントにインストールされていることを確認します。

特定のバージョンの .NET SDK をインストールするには、 UseDotNet@2 タスクを YAML パイプラインファイルに追加するか、クラシックエディターで .NET Core を使用 するタスクを追加します。

Note

物理システムで実行されるエージェントの場合、パイプラインを介して SDK とツールをインストールすると、エージェントのホスト上のビルド環境が変更されます。

次の YAML スニペットの例では、.NET SDK 8.0.x がインストールされます。

steps:
- task: UseDotNet@2
  inputs:
    version: '8.x'

新しい SDK をインストールするには、 performMultiLevelLookup を true に設定します。

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 8.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

ビルドジョブのエージェントプールとエージェントを選択できます。エージェントの機能に基づいてエージェントを指定することもできます。たとえば、次の YAML パイプラインスニペットでは、プールとエージェントの機能が選択されます。

pool:
  name: myPrivateAgents
  demands:
  - agent.os -equals Darwin
  - anotherCapability -equals somethingElse

Windows、Linux、または macOS 用の .NET Core SDK とランタイムを使用して、.NET Core プロジェクトをビルドできます。既定では、ビルドは Microsoft がホストするエージェントで実行されるため、インフラストラクチャを設定する必要はありません。

Azure Pipelines Microsoft でホストされるエージェントには、サポートされている .NET Core SDK のプレインストールバージョンがいくつか含まれています。使用可能なイメージと構成例の完全な一覧については、 Microsoft がホストするエージェントを参照してください。

次の YAML パイプラインスニペットは、エージェントプールの Ubuntu OS を設定します。

pool:
  vmImage: 'ubuntu-latest'

Microsoft がホストするエージェントには、一部の古いバージョンの .NET Core SDK は含まれていません。また、通常はプレリリースバージョンは含まれません。 Microsoft がホストするエージェントでこれらのバージョンの SDK が必要な場合は、 DotNet の使用 (UseDotNet@2) タスクを使用してインストールできます。

たとえば、次のコードは .NET 5.0.x SDK をインストールします。

steps:
- task: UseDotNet@2
  inputs:
    version: '5.x'

Windows エージェントには、既に .NET Core ランタイムが含まれています。新しい SDK をインストールするには、次のスニペットのように performMultiLevelLookup を true に設定します。

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 8.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

セルフホステッド・エージェント

または、セルフホステッドエージェントを使用して .NET Core プロジェクトをビルドすることもできます。 Linux、macOS、または Windows のセルフホステッドエージェントを設定できます。

セルフホステッドエージェントを使用すると、次の機能を利用できます。

UseDotNet@2 ツールインストーラーの実行コストを回避します。
リポジトリが大きい場合は、ビルド時間を短縮します。
インクリメンタルビルドを実行します。
Microsoft が公式にサポートしていないプレビュー SDK またはプライベート SDK を使用します。
企業またはオンプレミスの環境でのみ使用できる SDK を使用します。

詳しくは、「セルフホステッドエージェント」をご覧ください。

依存関係を復元する

NuGet パッケージは、プロジェクトがビルドしないコードに依存する方法です。 NuGet パッケージとプロジェクト固有のツールをダウンロードするには、dotnet restore () タスクを使用するか、パイプライン内のスクリプトとして、DotNetCoreCLI@2 コマンドを実行します。 dotnet restore コマンドは、.NET Core SDK でパッケージ化された NuGet.exe を使用し、.NET Core プロジェクト *.csproj ファイルで指定されたパッケージのみを復元できます。

.NET Core (DotNetCoreCLI@2) タスクを使用して、Azure Artifacts、NuGet.org、または認証された別の外部または内部の NuGet リポジトリから NuGet パッケージをダウンロードして復元できます。 NuGet フィードがパイプラインと同じプロジェクトにある場合は、認証する必要はありません。詳細については、「.NET Core タスク (DotNetCoreCLI@2)」を参照してください。

Microsoft ホステッドエージェントを使用すると、ビルドを実行するたびに新しいコンピューターが取得され、実行のたびにパッケージが復元されます。復元にはかなりの時間がかかることがあります。この問題を軽減するには、Azure Artifacts またはセルフホステッドエージェントを使用してパッケージキャッシュを利用します。

次のパイプラインでは、 DotNetCoreCLI@2 タスクを使用して Azure Artifact フィードを復元します。

trigger:
- main

pool:
  vmImage: 'windows-latest'

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 8.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-vsts-feed' # A series of numbers and letters

- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    arguments: '--configuration $(buildConfiguration)'
  displayName: 'dotnet build $(buildConfiguration)'

.NET Core SDK バージョン 2.0 以降では、 dotnet buildなどのコマンドを実行すると、パッケージが自動的に復元されます。認証されたフィードを使用する場合は、 .NET Core (DotNetCoreCLI@2) タスクを使用してパッケージを復元する必要があります。

Project Settings>Pipelines>Service 接続で NuGet サービス接続を作成して、認証されたフィードの資格情報を管理します。 NuGet サービス接続の詳細については、「 Azure Pipelines を使用して NuGet パッケージを発行する」を参照してください。

NuGet.org からパッケージを復元する

NuGet.org からパッケージを復元するには、次のようにパイプラインを更新します。

YAML
クラシック

YAML コードを直接編集するか、タスクアシスタントを使用して、復元コマンドをパイプラインに追加できます。

ビルドタスクの前に次のスニペットをazure-pipelines.yml ファイルに挿入して、.NET Core (DotNetCoreCLI@2) タスクを直接追加します。

steps:
- task: DotNetCoreCLI@2
  displayName: Restore
  inputs:
    command: restore
    projects: '**/*.csproj'
    feedsToUse: select

タスクアシスタントを使用するには:

タスクを挿入する YAML ファイル内の位置に移動します。
[タスクカタログ] で [.NET Core] を選択します。
構成画面で、[コマンド] ドロップダウンリストから [復元] を選択します。
[ プロジェクトまたはソリューションへのパス ] フィールドに、 *.csproj ファイルへのパスを入力します。すべてのサブフォルダー内のすべての *.csproj ファイルにワイルドカード **/*.csproj を使用できます。
フィードを追加するには、ここで選択したフィードと[NuGet.org からパッケージを使用する]が選択されていることを確認します。
[追加] を選択します。
[ 検証して保存] を選択し、[ 保存] を選択して変更をコミットします。

外部フィードからパッケージを復元する

外部 NuGet リポジトリを指定するには、リポジトリ内の NuGet.config ファイルに URL を配置します。 NuGet.config ファイルでカスタムフィードが指定されていること、および資格情報が NuGet サービス接続で指定されていることを確認します。

外部フィードからパッケージを復元するには、前のセクションの指示に従って restore タスクを追加しますが、構成設定は次のように変更します。

YAML
クラシック

ビルドタスクの前に次のスニペットをazure-pipelines.yml ファイルに挿入して、.NET Core (DotNetCoreCLI@2) タスクを直接追加します。 <NuGet service connection>をサービス接続名に置き換えます。

steps:
- task: DotNetCoreCLI@2
  displayName: Restore
  inputs:
    command: restore
    projects: '**/*.csproj'
    feedsToUse: config
    nugetConfigPath: NuGet.config    # Relative to root of the repository
    externalFeedCredentials: <NuGet service connection>

タスクアシスタントを使用するには:

.NET Core タスクを追加し、前の手順のように構成画面で復元を選択します。
フィードを追加するには、NuGet.configの [フィード] を選択します。
[ NuGet.configパス ] で、リポジトリのルートを基準にして、 NuGet.config ファイルへのパスを入力します。フィールドの横にある省略記号 ... を選択して、場所を参照して選択できます。
[ この組織/コレクション外のフィードの資格情報] で、選択した NuGet.config ファイル内の外部レジストリに使用する資格情報を選択します。同じ組織内のフィードの場合、このフィールドは空白のままにすることができます。ビルドの資格情報は自動的に使用されます。

.NET Framework プロジェクトのパッケージを復元する

ソリューションにも Microsoft .NET Framework プロジェクトがある場合、または package.json を使用して依存関係を指定する場合は、 NuGetCommand@2 タスクを使用してそれらの依存関係を復元します。

- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '**/*.sln'
    feedsToUse: 'select'

Note

Ubuntu 24.04 以降では、.NET CLI でNuGetCommand@2 タスクの代わりに NuGetAuthenticate タスクを使用する必要があります。詳細については、「新しい Ubuntu ホストイメージのサポート」を参照してください。

プロジェクトをビルドする

dotnet build コマンドを実行して、.NET Core プロジェクトをビルドします。 .NET Core (DotNetCoreCLI@2) タスクを使用するか、コマンドラインスクリプトとしてコマンドをパイプラインに追加できます。

ファイルを直接編集するか、タスクアシスタントを使用して、YAML パイプラインエディターを使用してビルドタスクを追加できます。

次のスニペットを挿入して 、.NET Core (DotNetCoreCLI@2) タスクを直接追加します。ニーズに合わせて arguments を更新します。

steps:
- task: DotNetCoreCLI@2
  displayName: Build
  inputs:
    command: build
    projects: '**/*.csproj'
    arguments: '--configuration $(buildConfiguration)'

タスクアシスタントを使用するには:

タスクを挿入する YAML ファイル内の位置に移動します。
.NET Core (DotNetCoreCLI@2) タスクを選択します。
[コマンド] ドロップダウンリストから [ビルド] を選択します。
[ プロジェクトまたはソリューションへのパス ] フィールドに、 *.csproj ファイルへのパスを入力します。すべてのサブフォルダー内のすべての *.csproj ファイルにワイルドカード **/*.csproj を使用できます。
[追加] を選択します。
[保存] を選び、変更をコミットします。

コマンドラインスクリプトを使用して .NET Core をビルドする

コマンドラインスクリプトを使用してビルドすることもできます。

YAML
クラシック

YAML ファイルを直接編集してビルドコマンドラインを追加するには、次のコードを追加します。

steps:
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

タスクアシスタントを使用してコマンドラインタスクを追加することもできます。

タスクを挿入する YAML ファイル内の位置に移動します。
一覧から コマンドライン (CmdLine@2) タスクを選択します。
[ スクリプト ] フィールドに、パラメーターを指定して dotnet build コマンドを入力します。たとえば、dotnet build --configuration $(buildConfiguration) のようにします。
[ 詳細設定>作業ディレクトリ] で、作業ディレクトリとして *.csproj ファイルへのパスを入力します。空白のままにすると、作業ディレクトリは既定で $(Build.SourcesDirectory)されます。
[追加] を選択します。
[保存] を選び、変更をコミットします。

クラシックエディターを使用してビルドコマンドラインを追加するには:

パイプラインの [ タスク ] タブで、 エージェントジョブ 1 またはビルドタスクを実行する他のジョブを選択します。
[+] を選択してそのジョブに新しいタスクを追加します。
タスクカタログで、[ コマンドライン ] を選択し、[ 追加] を選択します。
左側のウィンドウで、追加した コマンドラインスクリプト タスクを選択して、タスクエディターを開きます。
必要に応じて 、表示名 を編集します。
[ スクリプト] で、パラメーターを指定して dotnet build コマンドを入力します。たとえば、dotnet build --configuration $(buildConfiguration) のようにします。
[ 詳細設定>作業ディレクトリ] で、作業ディレクトリとして *.csproj ファイルへのパスを入力します。省略記号 ... を選択して、リポジトリの場所を参照して選択できます。
左側のウィンドウで、タスクをドラッグして、正しいタスクシーケンスに配置します。
ページの上部にある [保存] & [キュー]>[保存] を選択します。

他の .NET SDK コマンドをパイプラインに追加する

.NET Core () タスクを使用するか、スクリプトとして、他の DotNetCoreCLI@2 SDK コマンドをパイプラインに追加できます。

.NET Core タスクを使用して .NET CLI コマンドを追加する

.NET Core (DotNetCoreCLI@2) タスクを使用すると、.NET CLI コマンドをパイプラインに簡単に追加できます。 .NET Core (DotNetCoreCLI@2) タスクを追加するには、YAML ファイルを編集するか、クラシックエディターを使用します。

YAML
クラシック

YAML パイプラインエディターでタスクアシスタントを使用して .NET Core コマンドを追加するには、次の手順を実行します。

タスクを挿入する YAML ファイル内の位置に移動します。
[タスクカタログ] で [.NET Core] を選択します。
コマンドフィールドのドロップダウンリストから実行する コマンド を選択します。
必要なオプションを構成します。
[追加] を選択します。
[保存] を選び、変更をコミットします。

スクリプトに .NET Core CLI コマンドを追加する

.NET Core CLI コマンドは、script ファイルにとして追加できます。例えば次が挙げられます。


steps:
# ...
- script: dotnet test <test-project>

ツールをインストールする

Windows で実行されているビルドに dotnetsay などの .NET Core グローバルツールをインストールするには、 .NET Core タスクを追加し、構成で次のプロパティを設定します。

コマンド: カスタム
プロジェクトへのパス: 空のままにします
カスタムコマンド: tool
引数: install -g dotnetsay

ツールを実行するには、コマンドライン タスクを追加し、[dotnetsay] フィールドに「」と入力します。

テストの実行

リポジトリにテストプロジェクトがある場合は、 .NET Core (DotNetCoreCLI@2) タスクを使用して、MSTest、xUnit、NUnit などのテストフレームワークを使用して単体テストを実行できます。テストプロジェクトは、Microsoft.NET.Test.SDK バージョン 15.8.0 以降を参照する必要があります。

テスト結果は自動的にサービスに発行され、ビルドの概要で使用できます。テスト結果を使用して、失敗したテストのトラブルシューティングとテストのタイミングの分析を行うことができます。

パイプラインにテストタスクを追加するには、次のスニペットを azure-pipelines.yml ファイルに追加します。

steps:
# ...
# do this after other tasks such as build
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration)'

タスクアシスタントを使用して .NET Core (DotNetCoreCLI@2) タスクを追加する場合は、次のプロパティを設定します。

コマンド: テスト
プロジェクトへのパス: ソリューション内のテストプロジェクトに設定する
引数: --configuration $(BuildConfiguration)

または、特定のロガーを使用して dotnet test コマンドを実行し、 PublishTestResults@2 タスクを使用することもできます。

steps:
# ...
# do this after your tests run
- script: dotnet test <test-project> --logger trx
- task: PublishTestResults@2
  condition: succeededOrFailed()
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

コードカバレッジを収集する

Windows プラットフォームでビルドする場合は、組み込みのカバレッジデータコレクターを使用してコードカバレッジメトリックを収集できます。テストプロジェクトは、Microsoft.NET.Test.SDK バージョン 15.8.0 以降を参照する必要があります。

.NET Core (DotNetCoreCLI@2) タスクを使用してテストを実行すると、カバレッジデータがサーバーに自動的に発行されます。ビルドの概要から *.coverage ファイルをダウンロードして、Visual Studio で表示できます。

コードカバレッジを収集するには、パイプラインにテストタスクを追加するときに、 --collect "Code Coverage" 引数を追加します。

steps:
# ...
# do this after other tasks such as build
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration) --collect "Code Coverage"'

タスクアシスタントを使用して .NET Core (DotNetCoreCLI@2) タスクを追加する場合は、次のプロパティを設定します。

コマンド: テスト
プロジェクトへのパス: ソリューション内のテストプロジェクトに設定する
引数: --configuration $(BuildConfiguration) --collect "Code Coverage"

[テスト結果の発行] オプションはオンのままにします。

または、特定のロガーで dotnet test コマンドを使用してコードカバレッジの結果を収集し、 PublishTestResults@2 タスクを実行するには、次のコードを使用します。

steps:
# ...
# do this after your tests run
- script: dotnet test <test-project> --logger trx --collect "Code Coverage"
- task: PublishTestResults@2
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

Coverlet を使ってコードカバレッジメトリックを収集する

Linux または macOS 上でビルドする場合は、 Coverlet または同様のツールを使用してコードカバレッジメトリックを収集できます。

コードカバレッジ結果の発行 (PublishCodeCoverageResults@2) タスクを使用して、コードカバレッジの結果をサーバーに発行できます。 Cobertura または JaCoCo カバレッジ形式で結果を生成するようにカバレッジツールを構成する必要があります。

Coverlet を使用してテストを実行し、コードカバレッジを発行するには:

coverlet.collector NuGet パッケージの参照を追加します。
azure-pipelines.yml ファイルに次のスニペットを追加します。

- task: DotNetCoreCLI@2
  displayName: 'dotnet test'
  inputs:
    command: 'test'
    arguments: '--configuration $(buildConfiguration) --collect:"XPlat Code Coverage" -- DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Format=cobertura'
    publishTestResults: true
    projects: '<test project directory>'
  
- task: PublishCodeCoverageResults@2
  displayName: 'Publish code coverage report'
  inputs:
    codeCoverageTool: 'Cobertura'
    summaryFileLocation: '$(Agent.TempDirectory)/**/coverage.cobertura.xml'

コードをパッケージ化して提供する

ビルド出力をパッケージ化して配信するには、次のことができます。

ビルド成果物を Azure Pipelines に発行します。
NuGet パッケージを作成し、それを NuGet フィードに発行します。
NuGet パッケージを Azure Artifacts に発行します。
WEB アプリにデプロイする ZIP アーカイブを作成します。
Azure Artifacts シンボルサーバーまたはファイル共有にシンボルを発行します。

また、アプリに対して、イメージをビルドして、それをコンテナーレジストリにプッシュすることもできます。

成果物を Azure Pipelines に発行する

.NET ビルドの出力をパイプラインに発行するには、次の手順に従います。

.NET CLI を使用してdotnet publish --output $(Build.ArtifactStagingDirectory)を実行するか、publish コマンドを使用して DotNetCoreCLI@2 () タスクを追加します。
パイプライン成果物の発行 (PublishPipelineArtifact@1) タスクを使用して成果物を発行します。このタスクは、 $(Build.ArtifactStagingDirectory) 内のすべてのファイルをビルドの成果物としてアップロードします。

azure-pipelines.yml ファイルに次のコードを追加します。

steps:

- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)' 
    artifactName: 'myWebsite'

公開前にさらにファイルをビルドディレクトリにコピーするには、Copy Files (CopyFile@2) タスクを使用します。

Note

publishWebProjects () タスクのDotNetCoreCLI@2入力は既定でtrueに設定され、リポジトリ内のすべての Web プロジェクトが発行されます。詳細については、 azure-pipelines-tasks GitHub リポジトリを参照してください。

.NET ビルドの出力をパイプラインに発行するには、次のタスクを実行します。

.NET CLI を使用してdotnet publish --output $(Build.ArtifactStagingDirectory)を実行するか、publish コマンドを使用して DotNetCoreCLI@2 () タスクを追加します。
Publish build artifact (PublishBuildArtifacts@1) タスクを使用して、アーティファクトを発行します。

次 のazure-pipelines.yml コードでは、ビルド成果物も ZIP ファイルとして発行されます。 PublishBuildArtifacts@1 タスクは、$(Build.ArtifactStagingDirectory)内のすべてのファイルをビルドの成果物としてアップロードします。

steps:

- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: true
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
    ArtifactName: 'drop'

詳細については、「ビルドアーティファクトを発行してダウンロードする」を参照してください。

NuGet フィードに発行する

NuGet パッケージを作成して NuGet フィードに発行するには、次のスニペットを azure-pipelines.yml ファイルに追加します。

steps:
# ...
# do this near the end of your pipeline
- script: dotnet pack /p:PackageVersion=$(version)  # define the version variable elsewhere in your pipeline
- task: NuGetAuthenticate@1
  inputs:
    nuGetServiceConnections: '<NuGet service connection>'
- task: NuGetCommand@2
  inputs:
    command: push
    nuGetFeedType: external
    publishFeedCredentials: '<NuGet service connection>'
    versioningScheme: byEnvVar
    versionEnvVar: version

Note

NuGetAuthenticate@1 タスクでは、NuGet API キー認証はサポートされていません。 NuGet API キーを使用している場合は、 NuGetCommand@2 タスクを使用し、 command 入力を push に設定し、引数を --api-key します。たとえば、dotnet nuget push --api-key $(NuGetApiKey) のようにします。

NuGet パッケージのバージョン管理と発行の詳細については、「 Azure Pipelines を使用して NuGet パッケージを発行する」を参照してください。

NuGet パッケージを Azure Artifacts に発行する

NuGetCommand@2 タスクを使用して、NuGet パッケージを Azure Artifacts フィードに発行できます。詳細については、「 Azure Pipelines を使用して NuGet パッケージを発行する」を参照してください。

ZIP ファイルアーカイブを Web アプリに発行する

Web アプリに発行する準備ができている ZIP ファイルアーカイブを作成するには、次のスニペットを azure-pipelines.ymlに追加します。ほとんどの場合、パイプラインの終わり近くでアプリをビルドした後、このタスクを実行します。たとえば、Windows 上の Azure Web アプリにデプロイする前に、このタスクを実行します。

steps:
# ...
- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

このアーカイブを Web アプリに発行するには、Azure Web アプリのデプロイに関する記事を参照してください。

シンボルを発行する

PublishSymbols@2 タスクを使用して、シンボルを Azure Artifacts シンボルサーバーまたはファイル共有に発行できます。詳細については、「シンボルを発行する」を参照してください。

たとえば、シンボルをファイル共有に発行するには、 azure-pipelines.yml ファイルに 次のスニペットを追加します。

- task: PublishSymbols@2
  inputs:
    SymbolsFolder: '$(Build.SourcesDirectory)'
    SearchPattern: '**/bin/**/*.pdb'
    IndexSources: true
    PublishSymbols: true
    SymbolServerType: 'FileShare' 
    SymbolsPath: '\\<server>\<shareName>'

クラシックエディターを使用するには、 インデックスソースを追加し、シンボル タスクをパイプラインに発行します。

トラブルシューティング

プロジェクトがローカルコンピューター上に正常にビルドされ、Azure Pipelines ではビルドされない場合は、次の潜在的な原因と是正措置を確認してください。

.NET Core SDK のプレリリースバージョンは Microsoft がホストするエージェントにインストールされていないため、新しいバージョンの SDK をすべての Azure Pipelines データセンターにロールアウトするには数週間かかる場合があります。ロールアウトが完了するのを待つ代わりに、 .NET Core の使用タスクを使用して、Microsoft ホスト型エージェントに必要な .NET Core SDK バージョンをインストールできます。

新しいバージョンの .NET Core SDK または Visual Studio は、たとえば NuGet ツールの新しいバージョンや機能が含まれている場合に、ビルドを中断する可能性があります。開発マシン上の .NET Core SDK のバージョンとランタイムがパイプラインエージェントと一致していることを確認します。

パイプラインに dotnet --version コマンドラインスクリプトを含め、.NET Core SDK のバージョンを出力できます。 .NET Core ツールインストーラーを使用してエージェントに同じバージョンをデプロイするか、プロジェクトと開発マシンを .NET Core SDK のパイプラインバージョンに更新します。
NuGet.org からパッケージを復元するときに接続の問題が原因で、ビルドが断続的に失敗する可能性があります。NuGet.org 問題が発生している場合や、Azure データセンターと NuGet.org の間にネットワークの問題が発生している可能性があります。アップストリームソースと共に Azure Artifacts を使用してパッケージをキャッシュすることで、ビルドの信頼性が向上するかどうかを調べることができます。

パイプラインの資格情報は、Azure Artifacts への接続に自動的に使用されます。通常、これらの資格情報は、プロジェクトコレクションビルドサービス アカウントから導出されます。 Azure Artifacts を使用して NuGet パッケージをキャッシュする方法の詳細については、「Azure Artifact フィードへの接続」を参照してください。
パイプラインでエンコードされていないロジックを Visual Studio で使用している可能性があります。 Azure Pipelines は、新しいプロセスでタスク内の各コマンドを順番に実行します。パイプラインビルドのログを調べて、ビルドで実行された正確なコマンドを確認します。問題を特定するには、開発用コンピューターで同じコマンドを同じ順序で繰り返します。
一部の .NET Core プロジェクトと一部の .NET Framework プロジェクトを含む混合ソリューションがある場合は、 NuGet タスクを使用して 、packages.config ファイルで指定されたパッケージを復元します。 MSBuild または Visual Studio Build タスクを追加して、.NET Framework プロジェクトをビルドします。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-08

次の方法で共有

.NET Core プロジェクトのビルド、テスト、およびデプロイ

前提条件

.NET プロジェクトを作成して GitHub にアップロードする

パイプラインを作成する

ビルド環境のセットアップ

セルフホステッド・エージェント

依存関係を復元する

NuGet.org からパッケージを復元する

外部フィードからパッケージを復元する

.NET Framework プロジェクトのパッケージを復元する

プロジェクトをビルドする

.NET Core タスクを使用する

コマンド ライン スクリプトを使用して .NET Core をビルドする

他の .NET SDK コマンドをパイプラインに追加する

.NET Core タスクを使用して .NET CLI コマンドを追加する

スクリプトに .NET Core CLI コマンドを追加する

ツールをインストールする

テストの実行

コード カバレッジを収集する

Coverlet を使ってコード カバレッジ メトリックを収集する

コードをパッケージ化して提供する

成果物を Azure Pipelines に発行する

NuGet フィードに発行する

NuGet パッケージを Azure Artifacts に発行する

ZIP ファイル アーカイブを Web アプリに発行する

シンボルを発行する

トラブルシューティング

関連コンテンツ

フィードバック

その他のリソース

コマンドラインスクリプトを使用して .NET Core をビルドする

コードカバレッジを収集する

Coverlet を使ってコードカバレッジメトリックを収集する

ZIP ファイルアーカイブを Web アプリに発行する