返回资讯中心
外部精选
云计算
#云原生#Amazon Bedrock AgentCore#Announcements#Developer Tools#Launch

AWS发布本地模拟器AWS Emulator,开发者可在本机测试AWS应用

来源标题:Test your applications against AWS locally with AWS Emulator

AWS推出开源本地模拟器AWS Emulator,开发者可在本机通过相同的AWS CLI和SDK命令测试几乎全部AWS服务。该工具用Rust编写,无额外服务费,仅在实际部署AWS资源时付费,源码已在GitHub发布。Linux用户可通过RPM或Debian包安装,macOS和Windows用户需在Docker中运行。

AWS BlogDaniel Abib2026/11/11 · 6 天前30 分钟阅读

以下正文由 AI 翻译自 AWS Blog(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

今天,我们宣布推出 AWS Emulator,这是一个可在你自己的机器上运行的 Amazon Web Services(AWS)本地模拟器。AWS Command Line Interface(AWS CLI)、AWS SDK 以及你的编码 agent 通过本地 HTTPS 端点与它通信,使用的 API 与它们在云中使用的 AWS API 相同,而且这一切都在你的笔记本电脑上完成。AWS Emulator 不收取额外服务费。你只需在为部署到 AWS 的资源付费。其源代码托管在 GitHub 上。在 Linux 上,你可以通过 RPM 或 Debian 包安装;在 macOS 和 Windows 上,你可以在 Docker 中运行它。

工作原理

你安装模拟器、启动它,然后把你的工具指向本地端点。AWS Emulator 启动时会生成自己的凭证、配置文件和证书,并将它们写入 ~/.aws/emulator/9297/。你设置环境变量,让 AWS SDK 与你的笔记本电脑通信,而不是与 AWS 通信,同时你的应用程序代码保持不变。

这样一来,你现有的测试、CLI 脚本和编码 agent 都能照常工作。一个创建 Amazon DynamoDB 表、写入一个条目并读回该条目的单元测试仍然是同一个测试,它可以在你的机器上运行,无需部署。编码 agent 可以创建资源、检查结果并反复迭代,而无需等待在某个 Region 中部署。

该模拟器用 Rust 实现,因此在笔记本电脑上保持较低的 CPU 和内存占用。它支持在 GitHub 上的 AWS API models 仓库中拥有 API 模型的 AWS 服务的 API,并且由于它是基于这些模型构建的——与 AWS SDK 使用的模型相同——你的请求和返回的错误与在 AWS 上具有相同的结构。

如果你是开发者,尤其是使用 Kiro 或 Claude Code 等编码 agent 的开发者,你可以利用这个循环在本地测试真实复杂度的 AWS 交互。

让我们试一试

首先,我在 Amazon Linux 2023 上安装了该包。该包将 aws-emulator 命令添加到 /usr/bin/,因此它在 PATH 中。

PKG=https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest
sudo dnf install -y $PKG/aws-emulator-x86_64.rpm
aws-emulator -v

在 macOS 和 Windows 上,你可以根据文档中的简短 Dockerfile 构建 Docker 镜像,并在容器中运行模拟器。我们不发布现成的镜像。

我用 aws-emulator 启动了模拟器。它在 127.0.0.1:9297 上提供 HTTPS 服务,因此只有我自己的电脑可以访问它;它还把日志写成 JSON 行,显示地址、配置文件和证书文件。

aws-emulator

在另一个终端中,我设置了将 AWS CLI 指向模拟器的环境变量,并取消设置任何可能提供真实 AWS 凭证的变量。

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_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

模拟器每次启动都会生成新的密钥。其访问密钥 ID 以 EMULATOR 开头,因此你不会把它们误认为真实的 AWS 密钥,并且它会拒绝用任何其他密钥签名的请求。为了确认我的 shell 正在与模拟器通信,我检查了健康端点和调用者身份。模拟器使用单一账户 000000000000。

curl --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health
aws sts get-caller-identity

然后我创建了一个存储桶,复制进去一个小对象,并列出它。

$ aws s3 mb s3://local-getting-started
make_bucket: local-getting-started
$ echo "hello from the emulator" > hello.txt
$ aws s3 cp hello.txt s3://local-getting-started/
upload: ./hello.txt to s3://local-getting-started/hello.txt
$ aws s3 ls s3://local-getting-started/

将 AWS CLI 指向我的笔记本电脑后,我使用的仍是我已经熟悉的相同命令,而本地端点对它们做出了响应。

接下来,我想以我目前实际工作的方式来体验它,因此在模拟器仍在运行的情况下,我打开 Kiro,让它创建一个 Amazon DynamoDB 表、写入一个条目并读回该条目,全部针对 AWS Emulator 而不是我的 AWS 账户。

kiro> 使用本地 AWS Emulator(环境变量已在此 shell 中设置),创建一个 DynamoDB 表 "kiro-demo",使用字符串键 "id",放入一个条目 {id: "item-1", msg: "hello from kiro"},然后用 get-item 读回它。
$ aws dynamodb create-table --table-name kiro-demo \
    --attribute-definitions AttributeName=id,AttributeType=S \
    --key-schema AttributeName=id,KeyType=HASH \
    --billing-mode PAY_PER_REQUEST
$ aws dynamodb put-item --table-name kiro-demo \
    --item '{"id": {"S": "item-1"}, "msg": {"S": "hello from kiro"}}'
$ aws dynamodb get-item --table-name kiro-demo --key '{"id": {"S": "item-1"}}'

要将相同的设置用于现有测试套件,我会启动模拟器,在运行测试的脚本中设置相同的环境变量,然后照常运行它们。

在进程内使用模拟器

将模拟器作为本地进程运行,会为你提供一个 HTTPS 端点,它通过环境变量与 AWS CLI 和 AWS SDK 配合使用。某些 SDK 需要额外设置才能信任模拟器证书,例如 AWS SDK for Java 的信任存储。对于测试,还有第二种选择。AWS Emulator 提供嵌入式模式,你可以直接在测试进程内实例化它,并通过其 HTTP 客户端接入 SDK,而不是通过网络与单独的服务器通信。每个嵌入式实例都保持自己的状态,因此测试不会共享存储桶、表或队列,并且你可以并行运行多个实例。嵌入式模式适用于 AWS SDK for Rust。你将 GitHub 上的 aws-emulator-embedded crate 添加到 Cargo.toml 文件的 [dev-dependencies] 部分。以下示例完全在进程内创建一个 Amazon DynamoDB 表、写入一个条目并读回该条目。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →