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
  • 项目