コンテンツへスキップ

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には属性が必要です。まず共有状態を分離してください。

このワークフローを compiler.dev で実行する カード登録不要 · 200 無料分

無料で試す