AWS Emulator リリース – 公式ローカル AWS API エミュレータ

TL;DR

AWS は、AWS API の公式オープンソースエミュレータをリリースしました。これはローカルで動作し、AWS CLI/SDK と統合され、Rust テストに組み込むこともできます。実際の AWS 認証情報やネットワーク呼び出しを不要にすることで、開発と CI テストを簡素化することを目的としていますが、本番環境やセキュリティ重視のテストには意図されていません。


AWS Emulator とは

AWS Emulator は、公開 AWS API サーフェスを実装するローカルプログラムです。デフォルトで 127.0.0.1:9297 の HTTPS エンドポイントを起動し、AWS サービスを模倣します。これにより、環境変数やプロセス内 HTTP クライアントを介して、任意の AWS CLI コマンドや SDK 呼び出しをエミュレータにリダイレクトできます。

  • AWS アカウントは不要です。
  • 追加のサービス料金は発生しません。実際の AWS リソースにのみ、後でデプロイするときに支払います。
  • このエミュレータは本番グレードのサービスではなく、セキュリティテスト(IAM ポリシー、KMS キー、クロスアカウントやクロスリージョンの呼び出しは完全には強制されません)には使用すべきではありません。

実行方法 – 3 つのモード

1. サーバーモード(CLI および任意の SDK)

  • Linux – RPM または Debian パッケージをインストールし、aws-emulator を実行します。
  • Windows/macOS – リポジトリに用意された短い Dockerfile からビルドした Docker イメージを実行します。
  • 通常の AWS エンドポイント環境変数(例: AWS_ENDPOINT_URL)を設定して、SDK/CLI をエミュレータに向けます。

2. 組み込みモード(Rust テスト)

  • aws-emulator-embedded を dev-dependency として追加します。
  • AwsEmulatorEmbedded インスタンスを作成し、その HTTP クライアントを SDK に直接渡します。
  • 各テストは分離されたエミュレータインスタンスを取得します。外部エンドポイントや証明書は不要です。

3. AI エージェント支援セットアップ

  • AI コーディングエージェント用の aws-emulator スキルをインストールします(aws agent-toolkit add-skill --skill-name aws-emulator)。
  • エージェントはエミュレータを自動的に起動および設定でき、AWS CLI v2.35.0+ が必要です。

忠実度と既知のギャップ

  • 各リリースは、各サービスが実際の AWS 動作にどの程度一致しているかを定量化する忠実度スコアを公開します。
  • 未解決の問題は issues/things-that-do-not-work/(欠落機能)と issues/things-that-now-work/(修正済みギャップ)の下に整理されています。
  • コミュニティのコメントによると、エミュレータには現在以下が欠けています:
    • クイック状態リセット(プロセスを再起動する必要があります)。
    • IAM ポリシー評価、KMS キーポリシー、クロスアカウント/リージョンセマンティクスの完全なサポート。
    • 特定のサービス固有機能(例: Step Functions の Assign フィールド、完全な Lambda ランタイムサポート)。
  • プロジェクトの README は、テストで迅速な状態リセットが必要な場合、Moto のようなツールのドロップイン代替ではないと警告しています。

ソースからのビルド – コスト

  • 前提条件: Rust ツールチェーン、C コンパイラ、target/ ディレクトリ用に ≥ 100 GB の空きディスク、マルチコアマシン。
  • 完全なデバッグビルドは、AWS サービスごとに個別のクレートをコンパイルするため、大きなバイナリと長い初期コンパイル時間が発生します。
  • インクリメンタルビルドは高速です。CI では target/ のキャッシュ(または sccache の使用)が推奨されます。
  • リポジトリレイアウトは、サービスごとに 1 つのクレート、ルーターバイナリ、組み込みファサードを持つワークスペースを反映しています。

テレメトリ – オプトアウトオプション

テレメトリはデフォルトで有効になっており、最小限の使用データ(リクエスト/レスポンスペイロード、認証情報、個人データは含まれません)を収集します。以下で無効にできます:

  • コマンドラインフラグ: aws-emulator --telemetry off
  • 環境変数: EMULATOR_TELEMETRY=off
  • 設定ファイル ~/.aws/emulator/config.toml に [telemetry] enabled = false を設定
  • 組み込み API: EmbeddedOptions::default().telemetry(Telemetry::Off)

コミュニティの反応(Hacker News ハイライト)

  • 肯定的 – 数人のコメント投稿者が、エージェント駆動開発における潜在的な価値と、LocalStack の無料代替としての可能性を賞賛しました。
  • 懐疑的 – 長期的なメンテナンス、巨大なビルドフットプリント、プロジェクトが本格的な製品なのか概念実証なのかについて懸念が提起されました。
  • 比較 – ユーザーは Floci、MiniStack、Fakecloud、Moto と比較し、機能の重複とギャップ(例: 状態リセット、完全な IAM シミュレーション)の両方を指摘しました。
  • 技術的観察 – ビルドには > 100 GB のディスクが必要で、メモリを大量に消費する可能性があります。32 GB RAM のマシンで jobs を減らす必要があったというコメントもありました。

エミュレータを使用すべき場合

  • AWS コストをかけずに決定的な API 応答が必要なユニットテストおよび統合テスト。
  • 分離されたランナーで実行され、外部認証情報に依存できないCI パイプライン。
  • API サーフェスの検証のみが必要な CDK、Terraform、CloudFormation テンプレートのローカル開発。

使用すべきでない場合

  • セキュリティ重視のテスト(IAM ポリシー、KMS、バケットポリシー)– エミュレータはこれらの制御を強制しません。
  • パフォーマンスまたはスケーラビリティテスト – エミュレータはローカルで実行され、AWS の大規模インフラストラクチャをエミュレートできません。
  • 迅速な状態リセットが必要なテスト – 状態をクリアするにはエミュレータプロセスを再起動する必要があります。

貢献方法

  • GitHub Issues で忠実度のギャップを報告し、サービス名、操作、SDK バージョン、リクエスト、観察された逸脱を提供してください。
  • リポジトリはプルリクエストを受け付けていません。貢献は問題報告に限定されています。
  • コードは CC0-1.0(パブリックドメイン)でリリースされていますが、vendor/ ディレクトリは Apache-2.0 です。

結論

AWS のオープンソースエミュレータは、AWS 互換コードをオフラインで実行するための強力で公式にサポートされた方法を提供し、開発者のコストと摩擦を低減します。セキュリティセマンティクスや状態管理の周りに顕著なギャップがまだありますが、AI 駆動ツールとクラウドネイティブ開発ワークフローのより緊密な統合に向けた重要な一歩を表しています。

Sources

関連

  • プロジェクト
  • Dispatch
  • プロジェクト
  • Dispatch
  • プロジェクト