AWS Emulator 发布——官方本地 AWS API 模拟器
TL;DR
AWS 发布了一款官方、开源的 AWS API 模拟器,可在本地运行,与 AWS CLI/SDK 集成,并可嵌入 Rust 测试中。它旨在通过消除对真实 AWS 凭证或网络调用的需求来简化开发和 CI 测试,但不适用于生产环境或安全关键型测试。
AWS Emulator 是什么
AWS Emulator 是一个本地程序,实现了公开的 AWS API 接口。它启动一个 HTTPS 端点(默认 127.0.0.1:9297),模拟 AWS 服务,允许任何 AWS CLI 命令或 SDK 调用通过环境变量或进程内 HTTP 客户端重定向到模拟器。
- 无需 AWS 账户。
- 不收取额外服务费用;你只需在后续部署时支付真实 AWS 资源的费用。
- 该模拟器不是生产级服务,不应用于安全测试(IAM 策略、KMS 密钥、跨账户或跨区域调用未完全强制执行)。
如何运行——三种模式
1. 服务器模式(CLI 和任意 SDK)
- Linux – 安装 RPM 或 Debian 包并运行
aws-emulator。 - Windows/macOS – 运行基于仓库中提供的简短 Dockerfile 构建的 Docker 镜像。
- 通过设置常用的 AWS 端点环境变量(例如
AWS_ENDPOINT_URL)将 SDK/CLI 指向模拟器。
2. 嵌入式模式(Rust 测试)
- 将
aws-emulator-embedded添加为开发依赖。 - 创建
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 服务编译一个单独的 crate,导致二进制文件庞大且初始编译时间较长。
- 增量构建很快;建议在 CI 中缓存
target/(或使用sccache)。 - 仓库布局反映了一个工作区,每个服务一个 crate、一个路由器二进制文件和一个嵌入式门面。
遥测——选择退出选项
遥测默认启用,以收集最少的使用数据(不包含请求/响应负载、凭证或个人数据)。你可以通过以下方式禁用它:
- 命令行标志:
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。
何时使用模拟器
- 单元和集成测试,需要确定性 API 响应且无需承担 AWS 成本。
- CI 管道,在隔离的运行器上运行且不能依赖外部凭证。
- 本地开发 CDK、Terraform 或 CloudFormation 模板,仅需 API 表面验证。
何时不使用
- 安全关键型测试(IAM 策略、KMS、存储桶策略)——模拟器不强制执行这些控制。
- 性能或可扩展性测试——模拟器在本地运行,无法模拟 AWS 的大规模基础设施。
- 需要快速状态重置的测试——必须重启模拟器进程才能清除状态。
如何贡献
- 通过 GitHub Issues 报告保真度差距,提供服务名称、操作、SDK 版本、请求和观察到的偏差。
- 该仓库不接受拉取请求;贡献仅限于问题报告。
- 代码以 CC0-1.0(公有领域)发布,但
vendor/目录除外,该目录为 Apache-2.0。
总结
AWS 的开源模拟器提供了一种强大且官方支持的方式,可在离线状态下运行 AWS 兼容代码,降低开发者的成本和摩擦。尽管它仍存在显著差距——尤其是在安全语义和状态管理方面——但它代表了向 AI 驱动工具与云原生开发工作流更紧密集成迈出的重要一步。
Sources
相关
- 项目
- Dispatch
- 项目
- Dispatch
- 项目