Spring Boot と AWS S3 を使ったアプリケーションのテスト

Transcript

1. Spring Boot と AWS S3 を使った アプリケーションのテスト 2025-06-06 JJUG CCC 2025 Spring Daisuke Garaike
2. 自己紹介 gara Twitter: @contour_gara Java で百貨店システムの開発 アジャイルでテストを知る テストがないコードがつらくて、 どうテストを書くかばかり考えている 2
3. JJUG CCC 登壇は 2 回目 3
4. S3 を使ったアプリケーション - バックエンド用途で考える - データ連携のためのデータストア - メッセージングで異常があった 際の退避場所 - 画像の保存 - etc. 4
5. 目的 - モダンな Web アプリケーション で使われる S3 - そんな S3 を使うアプリケーション のテストを書くモチベーションが 上がる 5
6. テストは必要なのか 6
7. テストは書きたい - 変更に強い - ソースコードの変更 - ライブラリアップデート - AWS SDK: ほぼ毎日 - 書いたコードが正確に動くこと を確信できる 7
8. 何をテストするべきか - ソフトウェアの振る舞い - 入力 - 出力 - 保存 - 計算 - リポジトリクラスは 3 つの 振る舞いあり - 入力・出力・保存 8
9. 問題を整理 9
10. S3 を使うクラスのテストの必要性は？ - 堅牢なコードのほとんどはエラーハンドリング 10 public String createDownloadUrl(String bucket, String key) { if (bucketIsNotPresent(bucket)) throw new RuntimeException("バケットが存在しません。"); if (objectIsNotPresent(bucket, key)) throw new RuntimeException("オブジェクトが存在しません。"); return s3Presigner .presignGetObject( getObjectPresignRequest -> getObjectPresignRequest .getObjectRequest(getObjectRequest -> getObjectRequest.bucket(bucket).key(key)) .signatureDuration(Duration.ofMinutes(10)) ) .url() .toExternalForm(); }
11. 技術的な課題 - ドメイン・リポジトリはともに アプリケーションの端 - 違い: - ドメイン: 純粋関数 - リポジトリ: さらに外に 外部サービス 11
12. 技術的な課題 - ドメイン・リポジトリはともに アプリケーションの端 - 違い: - ドメイン: 純粋関数 - リポジトリ: さらに外に 外部サービス 12 Presentation UseCase DB・S3 Domain Infra
13. テストダブル - ダミー・スタブ・スパイ・モック - インターフェースに もどづきふるまう - フェイク - 外部サービスとして ふるまう - テスト機構なし 13 モック スパイ スタブ ダミー フェイク テストダブル
14. LocalStack - AWS のサービスを docker 上で再現 14
15. テスト戦略 15
16. テストピラミッド - UT と IT 区別 - レイヤーをまたぐかどうか 16 出典: https://gihyo.jp/dev/serial/01/savanna-letter/0005
17. テストスコープ - Large: S3 - Medium: LocalStack 17 Small Medium Large
18. 結局、何をどうテストするのか - LocalStack を使う UT はコスパが悪い - 結合すると、データ準備の コストが増す - UT x Medium: 基本 - IT x Medium: ハッピーパス, etc. 18 Small Medium Large Unit Integra tion E2E
19. demo 19
20. リポジトリ 20 - https://github.com/contour-gara/spring-s3-sample-jjug-ccc-2025
21. システム構成 21
22. 作成した API 22 - 全件検索 - 画像をダウンロードするための署名付き URL 作成 - 保存 - 画像をアップロードするための署名付き URL 作成
23. AwsConfig 23 - AWS のクレデンシャルなどは アプリのプロパティにする ことでテストしやすくなる
24. UT 24
25. Testcontainers 25 - イメージ選定 - プロパティ設定
26. endpointOverride 26 - LocalStack に向けるため - プロパティが空文字かどうか で使い分けられるとスマート
27. データ準備と後処理 27 - 後処理: テストケース実行前に - 共通処理 - 準備は後処理の後 - 各テスト毎
28. IT 28
29. アプリケーションコンテナに対するテスト 29
30. forcePathStyle 30 - http://localstack:4566/ をエンドポイントとして 使うため
31. maven-failsafe-plugin 31 - 結合テストを実行するため
32. docker-compose-maven-plugin 32 - pre-integration-test で compose up - post-integration-test で compose down - verify で up -> IT -> down
33. まとめ 33
34. 感謝 34 - S3 を使用するクラスは、LocalStack を使って 自動テストが書ける - UT: Testcontainers, LocalStack に 切り替えられる実装 - IT: docker-compose-maven-plugin などの plugin