C#のテスト自動化とCI入門！初心者でもわかる継続的インテグレーションの構築方法
生徒
「C#でプログラムを作った後、毎回手動でテストを実行するのが大変なのですが、何か自動化する方法はありますか？」
先生
「それは継続的インテグレーション、通称CI（シーアイ）という仕組みを使うのが一番ですね。コードを保存するたびに、ロボットが自動でテストを動かしてくれますよ。」
生徒
「自動でテストをしてくれるなんて魔法みたいですね！初心者でも設定できるのでしょうか？」
先生
「手順を追えば大丈夫です。まずはCIの基本と、C#での具体的な組み込み方について学んでいきましょう！」
1. 継続的インテグレーション（CI）とは何か？
プログラミングの世界には、継続的インテグレーション（Continuous Integration）、略してCIという言葉があります。これは、開発者が作成したプログラムを、専用のサーバーやクラウド環境で「自動的に組み立て（ビルド）」、さらに「自動的にテスト」を実行する仕組みのことです。
パソコンを初めて触る方にとっては、料理の自動調理マシンを想像すると分かりやすいかもしれません。あなたが切った野菜（プログラムコード）を調理台に置く（保存する）だけで、マシンが勝手に火を通し、味見（テスト）をして、失敗していないかを確認してくれるようなものです。この仕組みを導入することで、人間が手作業でテストを繰り返す手間を省き、バグ（プログラムの不具合）を早期に発見できるようになります。
2. なぜテストをCIに組み込む必要があるのか
C#でアプリケーションを開発していると、機能が増えるたびに「以前作った場所が壊れていないか」を確認する作業が必要になります。これを毎回手動で行うのは非常に時間がかかりますし、人間なのでどうしても見落としが発生してしまいます。
CIにテストを組み込む最大のメリットは、常に最新の状態が正常であると保証される点にあります。GitHubなどのコード管理ツールにプログラムを送信するたびにテストが実行されるため、「昨日までは動いていたのに、今日修正したせいで動かなくなった」という事態にすぐ気づくことができます。これにより、安心して新しい機能の開発に集中できる環境が整います。Visual Studioなどのツールと連携させることで、開発の効率は飛躍的に向上します。
3. 自動テストを実行するためのC#コードの準備
CIを始める前に、まずは自動テストそのものが動くコードを用意する必要があります。C#では「xUnit」や「NUnit」といったテスト用フレームワークがよく使われます。今回は、簡単な足し算の結果を確認するテストプログラムを見てみましょう。
まずは、テストの対象となるメインのプログラムです。
public class Calculator
{
public int Add(int a, int b)
{
// 2つの数字を足して返すだけの簡単な仕組みです
return a + b;
}
}
次に、このプログラムが正しく動くかを判定するテストコードを準備します。Assert（アサート）という言葉が出てきますが、これは「結果が予想通りであることを確認する」という意味です。
using Xunit;
public class CalculatorTests
{
[Fact]
public void Add_ShouldReturnSumOfTwoParameters()
{
// 準備
var calc = new Calculator();
// 実行
int result = calc.Add(10, 20);
// 検証（10+20が30になっているか確認する）
Assert.Equal(30, result);
}
}
4. GitHub Actionsを使用したCIの設定方法
現在、最も普及しているCIツールの一つがGitHub Actions（ギットハブ・アクションズ）です。これはGitHubというプログラム共有サイトが提供しているサービスで、設定ファイルを一つ作成するだけで、C#のテストを自動実行してくれます。
設定ファイルは「YAML（ヤムル）」という形式で記述します。これはプログラムの設定を箇条書きのような形式で書くためのルールです。このファイルを特定のフォルダに保存するだけで、あなたがコードを更新した瞬間にクラウド上のコンピューターが動き出し、C#のビルドとテストを代行してくれます。設定の基本は「環境を整える」「ライブラリを入れる」「テストを動かす」の3ステップです。
5. ワークフローファイルの具体的な書き方
実際にCIを動かすための設定ファイル（ワークフローファイル）の内容を見てみましょう。この内容は、プロジェクトの直下にある「.github/workflows」という名前のフォルダの中に保存します。HTMLのように構造化された設定ファイルですが、意味を理解すれば難しくありません。
name: CSharp Test CI
on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Setup .NET
uses: actions/setup-dotnet@v3
with:
dotnet-version: 8.0.x
- name: Restore dependencies
run: dotnet restore
- name: Build
run: dotnet build --no-restore
- name: Test
run: dotnet test --no-build --verbosity normal
ここで重要なのは最後の「dotnet test」という命令です。これが実行されることで、先ほど作成した足し算のテストが自動的に走り、計算間違いがないかをチェックしてくれます。
6. 失敗したテストの原因を特定する方法
CIのテストが失敗すると、画面に「×」印が表示されます。初心者の方は「壊してしまった！」と焦るかもしれませんが、これはプログラムが誤作動するのを防いでくれたという「成功」の証でもあります。エラーメッセージを読み解くことで、どこを直すべきかが明確になります。
例えば、足し算のロジックを間違えて引き算にしてしまった場合、テスト結果には以下のようなメッセージが出力されます。実行結果の画面を確認することで、期待していた値と実際の値の差をすぐに把握できます。
Failed Add_ShouldReturnSumOfTwoParameters
Error Message:
Assert.Equal() Failure
Expected: 30
Actual: -10
このように、「何が期待されていたか（Expected）」と「実際の結果（Actual）」を比較して、間違いを修正していくのがデバッグの基本作業となります。
7. 複数のテストパターンで品質を高める
CIに組み込むテストは、単純な成功例だけでなく、複雑な条件やエラーになりそうなケースも含めるのが理想的です。例えば、0を足した場合や、マイナスの数字を足した場合など、思いつく限りのパターンを並べておくと、プログラムの信頼性がさらに高まります。
以下のコードは、複数のデータを一度にテストに流し込む「理論テスト」という手法を使ったC#の書き方です。これにより、少ない記述で多くのチェックをCI上で実行できます。
using Xunit;
public class AdvanceCalculatorTests
{
[Theory]
[InlineData(1, 1, 2)]
[InlineData(-5, 5, 0)]
[InlineData(0, 0, 0)]
public void Add_VariousScenarios(int n1, int n2, int expected)
{
var calc = new Calculator();
var actual = calc.Add(n1, n2);
// 複数のパターンを自動で連続テストします
Assert.Equal(expected, actual);
}
}
8. 継続的デプロイ（CD）へのステップアップ
テストの自動化が完成すると、その先には「CD（継続的デプロイ）」という世界が待っています。これは、CIでのテストがすべて合格したときだけ、自動的に本番のサーバーにアプリを公開する仕組みのことです。CIとCDは合わせて「CI/CD」と呼ばれ、現代のプログラミング開発において欠かせない標準技術となっています。
初心者のうちは、まずは「コードを書いたら勝手にテストが動く」というCIの便利さを体感することから始めてみてください。手動で何度も「デバッグ開始」ボタンを押す生活から解放されると、プログラミングがもっと楽しくなります。エラーを恐れず、CIという強力な味方を味方につけて、確実なステップアップを目指しましょう。
