Inceptarium

Contract Test Garage

概要

Contract Test Garageは、コンテナ化された開発環境に契約テストを導入し、テスト失敗を可観測性に結びつける少人数向けの実務コンサルパッケージです。スターターテスト群、CIテンプレート、90分のペアリング実作業を含みます。

解決する課題

小規模チームがコンテナ内でAPIを提供するとき、契約テストが無いと統合が壊れやすく、可観測性も分断されがちです。結果として本番障害やロールバックが発生し、対応に時間を取られます。

解決策

最小限で方針を決めた導入を行います:コンシューマ駆動の契約テストやスキーマ検証のサンプル、Docker対応のテストランナー、GitHub Actions等のCIテンプレート、テスト失敗メトリクスをPrometheus/Elasticへ送るフック。90分のペアリングでリポジトリに組み込み、保守チェックリストを渡します。

ユーザーストーリー

アイリスはパートナーの請求APIと連携する二つのマイクロサービスを管理しています。以前の障害後、彼女はContract Test Garageを依頼しました。コンサルタントはリポジトリを確認して三つの契約テストを追加:コンシューマ駆動のPact、一つのスキーマ検証、docker-compose上のスモークテスト。90分のペアリングで実際に設定し、CIジョブをコミットしてPrometheusに失敗メトリクスを送るように連携。次のパートナー側の変更でCIが警告を出し、アイリスは差分を確認してマッピングを修正、プロダクションに到達する前に直せました。導入は1日で済み、以前のような週次の炎上を防げています。

パースペクティブ: Supporting independent professionals or small shops

作成日時: 2025/11/23 11:20:43