AWS Emulatorとは
AWS公式が出したAWS APIのローカルエミュレータ、Rust製・無料・AWSアカウント不要の使い方【LocalStack・fakecloud・MiniStack・Motoとの違い】
AWS Emulatorは、AWS自身が公開したAWS APIのローカルエミュレータだ。Rust製で追加料金なし、AWSアカウントも不要で、開発機やCIでAWS CLI・SDKの接続先を差し替えるだけで使える。導入方法、サービス別の忠実度スコア、LocalStack・fakecloud・MiniStack・Motoとの違い、注意点を一次情報で整理する。
AWS Emulatorは、AWS自身が公開した「AWS APIのローカルエミュレータ」だ。自分のPC・開発サーバー・CI上で動かし、AWS CLIやSDKの接続先をそこへ向けるだけで、AWSアカウントなし・追加料金なしでアプリのAWS連携をテストできる。GUIはなく、本番運用やセキュリティテストには使わないツールと位置づけられている。
AWS公式ブログでの告知は2026年11月11日(筆者はAWSのシニアスペシャリストソリューションアーキテクトDaniel Abib氏、11月12日更新)。GitHubリポジトリ(aws/aws-emulator)は2026年11月16日時点でスター約8,400、ライセンスはCC0-1.0(vendor/ 配下のみApache License 2.0)、実装言語はRust。Hacker Newsでは11月11日に投稿され991ポイントを集めた。
なぜ今注目されているか
最大の理由は「AWS本体が出した」ことだ。これまでAWSのローカルテストはLocalStackなどサードパーティが担ってきたが、公式が同じ目的のツールを無償で出した。公式ドキュメントによれば、AIエージェントがAWSの変更に追従してエミュレータを継続的に更新しており、リリースは1日に何度も出ている(GitHubのreleasesでは2026年11月14日だけでv1.0.351からv1.0.385までが並ぶ)。
背景にはLocalStackの方針転換もある。InfoQの2026年2月15日付の報道では、LocalStackはCommunity EditionとProを1つのイメージに統合し、登録が必要になる(有料プランは1ライセンス月額39ドルから)と伝えられた。同社のGitHubリポジトリは2026年3月23日にアーカイブ(読み取り専用)になっている。こうした「無料で使えるローカルAWS」の空白を埋める動きの1つが、fakecloudやMiniStackであり、今回はそこにAWS公式が加わった形だ。
何ができるか
| 機能 | 内容 |
|---|---|
| AWS APIのローカル再現 | 1つのHTTPSエンドポイント(既定 https://127.0.0.1:9297)で、AWS API modelが公開されているサービスのAPIを受け付ける |
| 同じエラーの再現 | DynamoDBのテーブル名が3文字未満なら、AWSと同じ ValidationException で拒否する(公式の例) |
| 未実装操作の明示 | 未実装の操作はHTTP 501・エラーコード NotImplemented を返し、テストがすぐ失敗する |
| サーバーモード | Linux(RPM/deb)ではネイティブ、macOS/WindowsではDockerコンテナで常駐させる |
| 組み込みモード | Rust製テストのプロセス内で起動。テストごとに独立した状態を持ち、並列実行できる |
| AIエージェント用スキル | aws-emulator スキルがエミュレータの導入・起動・接続と、プロジェクトが動くかの確認を行う |
| 忠実度スコアの公開 | サービスごとの合格テスト数をリリースごとに公開。テスト本体は aws-emulator-evaluation-suite リポジトリにある |
対応サービスの一覧と忠実度は、リリースに添付される scores.json.gz(v1.0.385、2026年11月14日付、コミット 813af48)で確認できる。このファイルを筆者が集計したところ、43,548件のテスト単位のうち28,505件が合格(約65%)で、約350のサービス識別子が含まれていた。主要サービスの内訳は次のとおり(1つのテストが複数サービスにまたがる場合は各サービスに数えているため、公式が示す「サービスごとのk of n」とは数え方が少し異なる)。
| サービス | 合格 / 総数 | 合格率 |
|---|---|---|
| Amazon S3 | 2,061 / 2,845 | 約72% |
| Amazon DynamoDB | 1,542 / 2,142 | 約72% |
| Amazon SQS | 1,190 / 1,536 | 約77% |
| Amazon SNS | 557 / 641 | 約87% |
| AWS Lambda | 1,912 / 3,021 | 約63% |
| AWS IAM | 830 / 1,238 | 約67% |
| AWS STS | 163 / 261 | 約62% |
| AWS KMS | 423 / 510 | 約83% |
| AWS Secrets Manager | 345 / 444 | 約78% |
| Amazon CloudWatch Logs | 857 / 1,235 | 約69% |
| Amazon API Gateway(REST) | 898 / 1,219 | 約74% |
| AWS Step Functions | 772 / 987 | 約78% |
| Amazon EC2 | 1,246 / 2,499 | 約50% |
| AWS CloudFormation | 973 / 4,282 | 約23% |
公式によれば、エミュレータが最もよくAWSと一致するのはコントロールプレーン(作成・取得・更新・削除・一覧)のAPIで、データプレーンの忠実度やCloudFormation・Terraform・CDKといったIaCツールへの対応はサービスによってばらつく。上の表でもCloudFormationの合格率が低いのはそのためと読める。なお、スコアはテスト数が増えるたびに分母が変わる「スナップショット」であり、同じバージョンのテスト同士でしか比較できない。
インストールと料金
| 方法 | 内容 |
|---|---|
| 料金 | 追加のサービス料金なし。AWS上にデプロイしたリソースの料金だけがかかる |
| ライセンス | CC0-1.0(vendor/ 配下はApache License 2.0) |
| Linux | RPM/debパッケージ(x86_64・aarch64)。aws-emulator コマンドが /usr/bin/ に入る |
| macOS/Windows | 既製イメージは公開されておらず、公式のDockerfileから自分でビルドする |
| 組み込み(Rust) | aws-emulator-embedded クレートを [dev-dependencies] にGit依存で追加(リリースのコミットを rev に固定) |
| AIエージェント | AWS CLI 2.35.0以上で aws agent-toolkit add-skill --skill-name aws-emulator |
| ソースからビルド | Linux x86_64/aarch64。target/ に100GB以上の空きと長いビルド時間が必要 |
# Debian系(amd64)の例。公式の手順どおり
curl -fsSLo aws-emulator.deb https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb
sudo apt-get install -y ./aws-emulator.deb
aws-emulator -v
# 起動(既定は 127.0.0.1:9297 のHTTPS)
aws-emulator使い方 — 最短手順
- エミュレータを起動する(Linuxなら aws-emulator、macOS/WindowsならビルドしたDockerイメージを -p 127.0.0.1:9297:9297 で起動)。起動のたびに新しいアクセスキーと自己署名証明書が作られ、~/.aws/emulator/9297/ に書き出される
- 別のシェルで環境変数を設定する。エンドポイントは AWS_ENDPOINT_URL、証明書は AWS_CA_BUNDLE、認証情報は AWS_SHARED_CREDENTIALS_FILE
- 本物のAWS認証情報が入る変数(AWS_ACCESS_KEY_ID など)を unset する。残っているとSDKがそれで署名し、エミュレータに拒否される
- aws sts get-caller-identity で接続先を確認する。エミュレータなら Account が 000000000000 になる
- 通常どおりSDKやCLIを実行する。コードにエンドポイントや認証情報を書く必要はない
export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_CA_BUNDLE=~/.aws/emulator/9297/ca.pem
export AWS_EC2_METADATA_DISABLED=true
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE
aws s3api create-bucket --bucket amzn-s3-demo-bucket
aws sts get-caller-identity# Rustテストに組み込む場合(Cargo.toml)
[dev-dependencies]
aws-emulator-embedded = { git = "https://github.com/aws/aws-emulator", rev = "<commit>" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
// テスト側: SDK設定にエミュレータのHTTPクライアントと認証情報を渡す
let emulator = AwsEmulatorEmbedded::new(EmbeddedOptions::default());
let config = aws_config::defaults(aws_config::BehaviorVersion::latest())
.http_client(emulator.http_client())
.region(aws_config::Region::new("us-east-1"))
.credentials_provider(emulator.aws_credentials_provider())
.load()
.await;既存ツールとの違い
| 項目 | AWS Emulator | LocalStack | fakecloud | MiniStack | Moto |
|---|---|---|---|---|---|
| 提供元 | AWS(公式) | LocalStack社 | faiscadev | ministackorg | getmoto |
| ライセンス | CC0-1.0 | 旧OSS版はApache-2.0(リポジトリは2026年3月23日にアーカイブ) | AGPL-3.0 | MIT | Apache-2.0 |
| 実装 | Rust | 公式ページで確認できず | シングルバイナリ | Python | Python |
| 対象範囲 | AWS API modelがあるサービス(数は公式に明記なし) | 公式ページで確認できず | 105サービス | 60以上 | 公式ページで確認できず |
| 既定ポート | 9297(HTTPS) | 4566 | 4566 | 4566(GATEWAY_PORT で変更) | 5000(サーバーモード) |
| アカウント・登録 | 不要 | 無償版は登録が必要になると報道(InfoQ) | 不要 | 不要 | 不要 |
| 認証 | 既定でSigV4署名を要求(起動ごとの鍵) | 公式ページで確認できず | トークン不要 | 数字以外の任意のキーで可 | 公式ページで確認できず |
| 起動方法 | RPM/deb、Docker、Rust組み込み | Docker | 単一バイナリ | pip、Docker | pip、Docker、デコレータ(モック) |
| 忠実度の公開 | サービス別スコアをリリースごとに公開 | 公式ページで確認できず | 公式ページで確認できず | 公式ページで確認できず | 公式ページで確認できず |
使い分けの目安は次のとおり。AWS公式の挙動に近い検証をしたい、エラーメッセージまで一致させたい、Rustのテストにプロセス内で組み込みたいならAWS Emulator。すでに4566番ポートとLocalStack互換の設定で書かれた既存のテスト資産があるなら、同じ4566番ポートで動くfakecloudやMiniStackのほうが差し替えは軽い。Pythonのユニットテストだけで済むならMotoのデコレータが最も手軽だ。なお、AWS Emulatorは自己署名のHTTPSで鍵が起動ごとに変わるため、既存のHTTP前提の設定は書き換えが要る。
注意点・向いている人
- 本番利用・セキュリティテストには使えない: IAMポリシーやリソースポリシー(バケットポリシー、KMSキーポリシー)をAWSと同じようには評価しない。AWSが拒否するリクエストが通ることがある
- 1リージョン・1アカウント: リソースをリージョンやアカウントで分離しない(アカウントIDは 000000000000)。複数リージョンを試すならポートを分けて複数起動する
- メモリ上にのみ保存: 停止すると全リソースが消える。長時間運用や負荷試験は未検証で、アイドル時で約160MiBを使う
- 忠実度はサービスにより差がある: 上の表のとおり合格率は約23%から約87%まで幅がある。使うサービスのスコアと、issues/ の既知のギャップを先に確認する
- 証明書の設定が要る: Node.jsは NODE_EXTRA_CA_CERTS、JavaはPKCS12のtruststore、Rust・.NETは SSL_CERT_FILE など、SDKごとに追加設定がある。S3は localhost ではなく 127.0.0.1 を使う
- S3 Controlは届かない: SDKがアカウントIDをホスト名に付けるため、S3 Controlのリクエストはエミュレータに届かない(公式の記載)
- 信頼できるコードだけ動かす: Lambdaなどでコードを実行する場合、マシンから隔離されず、自分のユーザー権限でファイルを読み書きできる
- テレメトリが既定で有効: 匿名の利用・エラー情報を送る。リクエスト内容や認証情報は含まれないと公式は説明しており、--telemetry off や EMULATOR_TELEMETRY=off で止められる
- プルリクエストは受け付けない: 不具合は GitHub Issues に報告する運用で、セキュリティ上の問題はHackerOneまたはaws-security@amazon.comへ
- 向いている人: AWS連携コードをCIでアカウントなしに回したい人、Rustでテストを書く人、AIコーディングエージェントにAWS前提のアプリをローカルで試させたい人
よくある質問
AWS Emulatorは無料ですか?AWSアカウントは必要ですか?
公式ドキュメントでは追加のサービス料金はなく、AWSアカウントも不要とされている。料金がかかるのは、AWS上にデプロイしたリソースだけだ。ライセンスはCC0-1.0(vendor配下はApache License 2.0)。
LocalStackの代わりにそのまま使えますか?
そのままとは限らない。AWS Emulatorは既定ポートが9297のHTTPSで、起動のたびに新しい鍵と自己署名証明書を作るため、環境変数と証明書の設定が要る。4566番ポートを前提にしたテスト設定はそのままでは動かない。また、対応範囲とスコアはサービスごとに異なるので、自分が使うサービスで試すのが確実だ。
S3・DynamoDB・SQS・Lambdaは使えますか?
いずれもスコアが公開されている。リリースv1.0.385の scores.json.gz を筆者が集計した範囲では、S3約72%、DynamoDB約72%、SQS約77%、SNS約87%、Lambda約63%が合格している。未実装の操作はHTTP 501(NotImplemented)で明示的に失敗する。
Windows・macOSでも動きますか?
動くが、ネイティブではなくDocker経由だ。公式は既製イメージを公開しておらず、公式ドキュメントのDockerfileからイメージをビルドする。ポートは -p 127.0.0.1:9297:9297 のようにローカルだけに公開するよう案内されている。
Rust以外の言語から使えますか?
サーバーモードなら、AWS CLIや各種AWS SDK(Python、JavaScript、Go、Java、.NETなど)から環境変数でエンドポイントを向けて使える。プロセス内に組み込む組み込みモードは、AWS SDK for Rustのテスト向けだ。
AIエージェントとはどう使うのですか?
AWS CLI 2.35.0以上で aws agent-toolkit add-skill --skill-name aws-emulator を実行すると、エミュレータの導入・起動・接続と、プロジェクトが動くかの確認をエージェントに任せられる aws-emulator スキルが入る。
まとめ
AWS Emulatorは、AWS自身が出した無料のローカルAWS APIエミュレータで、CIやローカルでのAWS連携テストをアカウントなしで回せる。忠実度スコアがサービス別・リリース別に公開されているため、「使うサービスがどこまで動くか」を事前に数字で確認できるのが強みだ。一方でIAMや各種ポリシーは検証できず、スコアもサービスによって大きく違う。
導入前に自分のプロジェクトが使うサービスのスコアを見て、本番前には必ず実際のAWSで確認する、という前提で使うのが現実的だ。AWSの構成や費用の考え方は中小企業のためのAWS導入ガイドやAWSのコスト最適化の記事も参照してほしい。AWSの構築・移行の支援は クラウド構築・移行 でも扱っている。
参考リンク(一次ソース)
- https://github.com/aws/aws-emulator
- https://github.com/aws/aws-emulator/releases
- https://aws.amazon.com/blogs/aws/test-your-applications-against-aws-locally-with-aws-emulator/
- https://docs.aws.amazon.com/emulator/latest/userguide/what-is-service.html
- https://docs.aws.amazon.com/emulator/latest/userguide/fidelity.html
- https://docs.aws.amazon.com/emulator/latest/userguide/point-sdk-to-emulator.html
- https://docs.aws.amazon.com/emulator/latest/userguide/security.html
- https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-linux.html
- https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-docker.html
- https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-embedded.html
- https://github.com/ministackorg/ministack
- https://docs.getmoto.org/en/latest/docs/server_mode.html
- https://github.com/localstack/localstack
- https://www.infoq.com/news/2026/02/localstack-aws-community
株式会社オブライト
株式会社オブライトは、ソフトウェア開発、デジタルサイネージ、Web開発、ネットワークシステム、IoT/AR/VRなどの技術サービスを提供する東京のIT企業です。
この記事に関連する無料ツール(登録不要・その場で結果)
お気軽にご相談ください
お問い合わせ