Testcontainers/2024-11-20-llt32

社内のLTイベント「えるLT Vol.32 オンライン」で発表した資料です

Transcript

1. Testcontainers Satoshi SAKAO えるLT Vol.32 2024-11-20  1
2. 話すひと 2 🏢 インフォコム株式会社 サービスマネジメント室 👨🔧 ソフトウェアエンジニア 🛠 Node.js / AWS / IoT / iOS (Swift) / Linux 💖 猫，B'z，テクテクライフ（ランク: 30），数学 Satoshi SAKAO @ottijp.com 𝕏 @ottijp
3. Now playing... 3 https://bsky.app/pro fi le/ottijp.com/post/3l7slr7xewc2z
4. Motivation 4 https://www.thoughtworks.com/radar/languages-and-frameworks/summary/testcontainers
5. Motivation 5 https://www.thoughtworks.com/radar/languages-and-frameworks/summary/pkl
6. Testcontainers • テストコードでDockerコンテナを起動し， "本物"を使ったintegration testを実現するライブラリ • コンテナで動かせるならなんでも（DB，MQ，ブラウザ，etc） • 自前でテスト実行前にコンテナ作ることもできるが， よりinstant & disposableにコンテナを使える • AtomicJar社が開発．2023年12月にDockerが買収． 6
7. E ff ect 7 https://speakerdeck.com/twada/automated-test-knowledge-from-savanna-202406- fi ndy-dev-prod-con-edition?slide=30
8. E ff ect 8 https://speakerdeck.com/twada/automated-test-knowledge-from-savanna-202406- fi ndy-dev-prod-con-edition?slide=32
9. Example 9 import { expect } from 'chai' import { GenericContainer } from 'testcontainers' import redis from 'async-redis' it('redis works', async () => { const container = await new GenericContainer('redis') .withExposedPorts(6379) .start() const client = redis.createClient( container.getFirstMappedPort(), container.getHost() ) await client.set('key', 'value') expect(await client.get('key')).to.equal('value') await client.quit() await container.stop() }) redisコンテナの作成 reidsクライアントの作成と テストデータのセット テストデータの検証 クリーンアップ
10. Features • テスト間でコンテナを再利用する • 実行中コンテナでコマンドを実行する • コンテナのログストリームを取得する • ネットワークを作成しコンテナへアタッチする • イメージをビルドする • composeを起動する • ホストのポートをコンテナにexposeする • コンテナ起動とテストを同期する（Wait strategy） 10
11. Others • modules • 特定のタスクを行いやすくするためのユーティリティ • Testcontainers Cloud • Dockerランタイムを提供 • Testcontainers Desktop • コンテナのデバッグ，ポートフォワード 11
12. Supported runtimes • Docker • Podman • Colima • Rancher Desktop 12 export DOCKER_HOST=unix://${HOME}/.rd/docker.sock export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock
13. 所感 • テストでコンテナをとても簡単に，信頼性高く利用できる • 環境構築やファイルシステムをいじるプログラムなどの テストとも相性が良さそう • Rancher Desktop対応が助かる 13
14. 14 Appendix
15. Supported languages • Java • Go • .Net • Node.js • Python • Rust • Haskell • Ruby 15
16. Wait strategy • ポートのリスン待ち（デフォルト） • Timeout • ログの出力待ち • Health Check • httpレスポンス • コマンド実行結果 • カスタムストラテジ • またはこれらの組み合わせ 16
17. Refs • 公式ページ https://testcontainers.com/ 17