S3 を使うアプリケーションをローカル完結で動かすことに全力を注いでみた / Running S3 Apps Offline

https://tamadev.connpass.com/event/395127/

Transcript

1. S3 を使うアプリケーションを ローカル完結で動かすことに 全力を注いでみた 2026-08-07 多摩.dev #4 Daisuke Garaike
2. 課題 1 AWS が外部サービス
3. 終 制作・著作 gara
4. LocalStack を使う • Docker • compose.yaml services: app: environment: AWS_S3_ENDPOINT: http://localstack:4566/ localstack: image: localstack/localstack-pro:latest environment: LOCALSTACK_AUTH_TOKEN: ${TOKEN} 4
5. 課題 2 ブラウザから 署名付き URL が叩けない
6. 署名付き URL • バックエンドを経由せずに S3 のファイルを使える • ブラウザからアクセスする 6
7. なぜブラウザから署名付き URL が叩けないのか services: app: environment: AWS_S3_ENDPOINT: http://localstack:4566/ • アプリが発行する署名付き URL は、 http://[BUCKET].localstack:4566/ • もちろん名前解決できない 7
8. *.localhost.localstack.cloud • localhost に名前解決される ◦ *.localhost.localstack.cloud -> localhost.localstack.cloud -> localhost 8
9. アプリで localstack に向ける必要がある services: app: environment: AWS_S3_ENDPOINT: http://s3.localhost.localstack.cloud:4566/ localstack: image: localstack/localstack-pro:latest networks: default: aliases: - s3.localhost.localstack.cloud environment: 9 LOCALSTACK_AUTH_TOKEN: ${TOKEN}
10. 無事にブラウザから署名付き URL が叩ける • [BUCKET].s3.localhost.localstack.cloud:4566 -> localhost.localstack.cloud:4566 -> localhost:4566 ◦ LocalStack のコンテナが 4566 を ローカルにマッピングする必要あり 10
11. 終 制作・著作 gara
12. 課題 3 え？ オフラインで動かない？
13. LocalStack はオフラインでは動かない services: localstack: image: localstack/localstack-pro:latest environment: LOCALSTACK_AUTH_TOKEN: ${TOKEN} • トークン認証 • 公開 DNS による *.localhost.localstack.cloud 解決 13
14. LocalStack やめよう • MinIO を使おう ◦ 追記: MinIO は登壇時点でメンテナンスを 終了しているようです。 使用する際は自己責任でお願いいたします。 MinIO の他にも S3 フェイクを実現する サービスはあるので、それらを使うことを 推奨いたします。 14
15. トークン認証は解決するが、公開 DNS 問題は？ • *.localhost は、localhost になる ◦ RFC 6761 “Special-Use Domain Names” (2013) ◦ 外部の DNS に問い合わせずにループバック • MinIO に自分は s3.localhost だと 思わせれば勝ち ◦ [BUCKET].s3.localhost -> localhost ◦ MINIO_DOMAIN で指定可能 15
16. オフラインでも動くローカル完結アプリの完成 services: app: environment: AWS_S3_ENDPOINT: http://s3.localhost:9000/ minio: image: minio/minio:latest networks: default: aliases: - s3.localhost environment: MINIO_DOMAIN: s3.localhost 16
17. S3 は ローカルでかつ オフラインで 動かせる 終 制作・著作 gara