GitHub Actionsで.NETを高速化する
最終更新
.NETをGitHub Actionsで高速化するには、actions/setup-dotnetでNuGetパッケージフォルダーをキャッシュし、復元は一度だけ行います。その後、--no-restoreと--no-buildを指定してビルドとテストを実行し、各ステップが自身の作業だけを行うようにします。多くの遅い.NETパイプラインでは、dotnet testが既定で復元とビルドを行うため、気づかないうちに復元とビルドが3回実行されています。
このガイドでは、キャッシュ、ビルドとテストのコマンド、並列テスト、データベースサービスについて説明します。一般的な内容については、GitHub Actionsを高速化する方法をご覧ください。
復元とビルドの重複を止める
dotnet buildは最初にdotnet restoreを実行します。dotnet testはビルドを実行し、そのビルドが復元を実行します。フラグを付けずに復元、ビルド、テスト、発行を別々のステップにしている場合、各ステップで作業が重複します。各段階を一度ずつ実行してください。
- run: dotnet restore --locked-mode
- run: dotnet build --no-restore -c Release
- run: dotnet test --no-build -c Release
- run: dotnet publish src/Api -c Release --no-build -o out
--no-restoreは暗黙的な復元を省略します。--no-buildは暗黙的なビルドを省略し、既存の出力を使用します。そのため、構成(-c Release)はステップ間で一致させる必要があります。多くのプロジェクトを含むソリューションでは、この変更だけで数分短縮できることがよくあります。
NuGetパッケージフォルダーをキャッシュする
actions/setup-dotnetには組み込みのキャッシュ機能があります。READMEによると、既定では無効で、cache: trueを指定して有効にします。NuGetのグローバルパッケージフォルダーをキャッシュし、キーはpackages.lock.jsonから生成されます。READMEには、ロックファイルが存在しない場合はアクションがエラーを投げると記載されているため、ロックファイルが必要です。サブディレクトリにある場合はcache-dependency-pathを使用してください。
- uses: actions/checkout@v7
- uses: actions/setup-dotnet@v6
with:
dotnet-version: 9.0.x
cache: true
cache-dependency-path: "**/packages.lock.json"
ロックファイルを生成するには、プロジェクトまたはDirectory.Build.propsに<RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>を追加し、ローカルでdotnet restoreを一度実行して、packages.lock.jsonファイルをコミットします。CIでは、dotnet restore --locked-modeを使うと、ロックファイルが古い場合に失敗するため、ビルドの再現性も高まります。READMEでは、パッケージフォルダーのみが復元されると説明されているため、説明されている設定を適用しない限り、復元時にNU1403の警告が表示される場合があります。その場合はそのセクションをお読みください。
ロックファイルを使いたくない場合は、actions/cacheを使って~/.nuget/packagesをキャッシュし、キーには**/*.csprojとDirectory.Packages.propsから生成した値を使ってください。
- uses: actions/cache@v6
with:
path: ~/.nuget/packages
key: nuget-${{ runner.os }}-${{ hashFiles('**/*.csproj', '**/Directory.Packages.props') }}
restore-keys: nuget-${{ runner.os }}-
ビルドとテストの並列化
- ビルド。MSBuildは
-m(--maxcpucount)を指定すると、プロジェクトを並列にビルドします。dotnet buildでは既定で有効になり、すべてのコアを使用します。msbuildを直接呼び出す場合は、-mを指定してください。 - アセンブリをまたいだテスト。
dotnet testは、MSBuildの設定に従ってテストプロジェクトを並列に実行します。1つのアセンブリ内のテストは、テストフレームワーク独自のルールに従って実行されます。 - xUnit。テストクラスは別々のコレクションとして扱われ、既定ではクラス同士が並列に実行されます。1つのクラス内のテストは順番に実行されます。
xunit.runner.jsonでmaxParallelThreadsを指定して調整できます。状態を共有するテストは[Collection]にまとめ、直列に実行されるようにしてください。 - NUnitとMSTest。
[Parallelizable]または[assembly: Parallelize]を追加してください。既定では直列に実行されます。
テストステップ中のCPU使用率を確認してください。1つのコアの近くで止まっている場合、高速化の余地を残しています。
統合テスト用のサービス
SQL Serverを使用するASP.NET Coreアプリでは、サービスコンテナーをよく使用します。
services:
sql:
image: mcr.microsoft.com/mssql/server:2022-latest
env:
ACCEPT_EULA: "Y"
MSSQL_SA_PASSWORD: "Your_password123"
ports: ["1433:1433"]
options: >-
--health-cmd "/opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P Your_password123 -Q 'SELECT 1'"
--health-interval 10s --health-timeout 5s --health-retries 12
SQL Serverは少なくとも2 GBのメモリを必要とし、Postgresより起動に時間がかかるため、ヘルスチェックが不可欠です。sqlcmdへのイメージパスはバージョンによって変わっているため、固定したタグで確認してください。Testcontainersを使用する場合も、同じ起動コストがコンテナーごとに発生します。コレクションフィクスチャを通じてテスト実行ごとに1つのコンテナーを共有し、各テストが独自のデータベースまたはスキーマを作成するようにしてください。
完全なワークフロー
name: dotnet
on:
pull_request:
push:
branches: [main]
concurrency:
group: dotnet-${{ github.ref }}
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
env:
DOTNET_NOLOGO: true
DOTNET_CLI_TELEMETRY_OPTOUT: true
DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
jobs:
test:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v7
- uses: actions/setup-dotnet@v6
with:
dotnet-version: 9.0.x
cache: true
cache-dependency-path: "**/packages.lock.json"
- run: dotnet restore --locked-mode
- run: dotnet build --no-restore -c Release
- run: dotnet test --no-build -c Release --logger "trx;LogFileName=test.trx"
DOTNET_*変数は初回実行時の処理とテレメトリを無効にするため、新しいVMごとに少し時間を節約できます。リリースビルドでは、ReadyToRunとトリミングによって実際に時間が増えるため、mainでの発行ジョブ専用にしてください。
CPU コア数を増やす効果
MSBuildとRoslynコンパイラーはすべてのコアを使用し、並列テストフレームワークも同様です。当社のベンチマークにはReact + ASP.NET Core + SQL Serverの構成が含まれており、GitHubホステッドランナーでは3m34s、compiler.devでは1m41sでした(2.1x)。これは10のテストシャードと実際のデータベースを使った完全なCI実行で、2026年10月8日に測定しました。SQL Serverはメモリを多く消費するため、16 GBのマシンが有効です。7 GBのランナーでは、データベースとビルドに使えるメモリが少なくなります。
お使いのワークフローで試すには、1行をruns-on: [self-hosted, Linux, compiler-ci]に変更してください。詳細は料金と比較をご覧ください。関連情報:.NETテンプレート、GitHub Actionsのキャッシュ、テストのシャーディング。
よくある質問
setup-dotnetはNuGetパッケージをキャッシュしますか?
はい。cache: trueを指定すると有効になります。packages.lock.jsonが必要で、ない場合はエラーになります。サブフォルダーにあるロックファイルにはcache-dependency-pathを使用してください。
dotnet test --no-buildは何をしますか?
既存のビルド出力からテストを実行し、再度ビルドは行いません。構成フラグは前回のビルドと一致させる必要があります。
CIでdotnet restoreが遅いのはなぜですか?
新しいVMではNuGetキャッシュが空のため、すべてのパッケージをダウンロードします。パッケージフォルダーをキャッシュし、再現性のある復元には--locked-modeを使用してください。
.NETのテストを並列で実行できますか?
はい。xUnitは既定でテストコレクションを並列化します。NUnitとMSTestには属性が必要です。まず共有状態を分離してください。
関連記事
- GitHub ActionsでTypeScriptモノレポを高速化するGitHub Actionsで TypeScriptモノレポの型チェックとリンターを高速化する: インクリメンタルtsc、プロジェクト参照、Lintキャッシュ、並列ジョブ
- GitHub ActionsでモノレポのPlaywrightを高速化するGitHub Actions で Node モノレポの Playwright E2E テストを高速化: アプリを一度だけビルドし、Web アプリに変更がないときは E2E をスキップし、シャーディングとレポートのマージを行います。
- READMEにCIの速度バッジを追加するREADME のバッジで CI の速さを表示しましょう。リポジトリの GitHub Actions 実行時間の中央値が自動で更新されます。公開リポジトリは無料です。
- GitHub ActionsでBazelを高速化するGitHub Actions で Bazel を高速化する: setup-bazel、ディスクキャッシュ、リポジトリキャッシュ、リモートキャッシュ、適切な --jobs 設定。動作する YAML 付き。