· 1 min read · AI开发工具

在本地跑通 AWS Emulator 的 S3:一次 Boto3 实测

本机安装 AWS Emulator 1.0.485 后,隔离云凭据并指向本地端点,用 Boto3 完成 S3 建桶、上传、下载与正文比对;附流程、实测输出和边界说明。

2026 年 11 月 11 日,AWS 发布 AWS Emulator。发布文章《AWS Emulator and the engineer’s job when agents write the code》的作者是 Swaminathan Sivasubramanian,新闻入口在这里,项目仓库是 https://github.com/aws/aws-emulator 。本篇记录 2026 年 11 月 17 日在本机的一次 S3 实测:安装并启动模拟器、隔离测试进程的 AWS 配置、用 Boto3 调用本地端点,核对请求状态和下载正文。

编码智能体在本地模拟器上完成调用与回读

发布文章中的说法与代码许可#

原文作者回顾了约二十年前与 Amazon 早期工程师 Al Vermeulen 开发分布式锁服务 Alf 的经历:团队在 JVM 中模拟服务及网络环境,主动排列事件顺序、注入丢包等故障,并用 TLA+ 等形式化方法检查问题。原文称,这些手段帮助团队在真实服务器部署前发现了大部分并发错误,但真实环境仍会暴露模拟覆盖不到的问题。

原文称,如今 AWS 服务已超过 200 项,手工为每个服务造测试环境不再现实;项目方案是让智能体依据公开 API 模型(Smithy 格式)编写模拟器,并用在真实 AWS 上验证过的保真测试来检查结果。按原文的官方陈述,AWS Emulator 由 400 多个 API 模型构建,覆盖 200 多项 AWS 服务,可在本机免费离线运行;改动需经过包含安全智能体对抗审查的合并门禁。上述数字和功能描述来自原文与官方文档,本篇没有逐项验证。

许可要分开看:仓库主项目采用 CC0-1.0,vendor/ 目录内的代码是 Apache-2.0,不能把整个仓库统称为 CC0。安装与安全说明见官方 Linux 安装文档、SDK 指向模拟器的文档和安全文档。

流程#

flowchart TD
    A[下载安装包并校验签名] --> B[安装并以 telemetry off 启动]
    B --> C[隔离凭据与配置,指向本地端点]
    C --> D[Boto3 调用本地 S3]
    D --> E[建桶、上传、下载、比对正文]
    E --> F[清理测试对象与桶]

从安装、关闭遥测、隔离配置到 S3 调用的步骤序列

安装与启动#

本次按官方包路径下载 .deb、签名文件和公钥,导入后验签,再安装。安装日志中的校验和安装结果如下:

PRTCL // TEXT
+ curl -fsSLo aws-emulator_amd64.deb.sig https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb.sig
+ curl -fsSLo aws-publishing.asc https://downloads.aws.com/keys/gpg/current.asc
+ gpg --import aws-publishing.asc
gpg: key 2E5BF49BD940F624: public key "SSM Publishing <ssm-publishing@amazon.com>" imported
+ gpg --fingerprint ssm-publishing@amazon.com
pub rsa4096 2026-07-20 [SC]
98BC F336 A3BE 53B7 34E9 67C5 2E5B F49B D940 F624
uid [ unknown] SSM Publishing <ssm-publishing@amazon.com>
+ gpg --verify aws-emulator_amd64.deb.sig aws-emulator.deb
gpg: Signature made Tue Nov 17 12:12:46 2026 CST
gpg: using RSA key 98BCF336A3BE53B734E967C52E5BF49BD940F624
gpg: Good signature from "SSM Publishing <ssm-publishing@amazon.com>" [unknown]
Primary key fingerprint: 98BC F336 A3BE 53B7 34E9 67C5 2E5B F49B D940 F624
+ sudo apt-get install -y ./aws-emulator.deb
The following NEW packages will be installed:
aws-emulator
Selecting previously unselected package aws-emulator.
Setting up aws-emulator (1.0.485-1) ...

安装后核对版本,本机以 aws-emulator --telemetry off 启动,端点为 https://127.0.0.1:9297。实际日志和版本输出:

PRTCL // TEXT
Version: 1.0.485
Release date: 2026.11.17
Commit: a2568e8a8db45f44e1a9fea808f13b22373aab60
python 3.13.5 boto3 1.44.4 botocore 1.44.4
PRTCL // TEXT
{"timestamp":"2026-11-17T05:02:56.271997Z","level":"INFO","fields":{"message":"aws-emulator emulator starting"},"target":"aws_emulator"}
This emulator collects usage and error telemetry: disabled (via the embedding configuration); to turn it back on, remove every opt-out setting and restart
{"timestamp":"2026-11-17T05:02:56.387961Z","level":"INFO","fields":{"message":"request authentication enabled","credentials_file":"/home/box/.aws/emulator/9297/emulator_credentials"},"target":"aws_emulator_server"}
{"timestamp":"2026-11-17T05:02:56.388028Z","level":"INFO","fields":{"message":"emulator server information","endpoint_url":"https://127.0.0.1:9297","health_check_url":"https://127.0.0.1:9297/__admin/health","config_file":"/home/box/.aws/emulator/9297/config","ca_file":"/home/box/.aws/emulator/9297/ca.pem","java_truststore_file":"/home/box/.aws/emulator/9297/truststore.p12"},"target":"aws_emulator_server"}

遥测默认是开启的;要在本机离线跑,启动时显式关闭。日志中的提示写明:想重新开启,需要移除所有退出设置并重启。请求认证使用模拟器生成的凭据文件,健康检查地址是 __admin/health。

隔离凭据并指向本地端点#

测试脚本先清掉调用进程里所有 AWS 凭据与端点变量,再只设置模拟器自己的文件位置和本地地址。示例只展示变量名和文件路径,不展示真实云密钥,也不展示凭据文件内容:

PRTCL // BASH
Terminal window
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE \
AWS_SHARED_CREDENTIALS_FILE AWS_CONFIG_FILE AWS_ENDPOINT_URL AWS_CA_BUNDLE \
AWS_REGION AWS_DEFAULT_REGION AWS_EC2_METADATA_DISABLED AWS_DISABLE_HOST_PREFIX_INJECTION \
AWS_WEB_IDENTITY_TOKEN_FILE AWS_ROLE_ARN AWS_CONTAINER_CREDENTIALS_RELATIVE_URI \
AWS_CONTAINER_CREDENTIALS_FULL_URI AWS_CONTAINER_AUTHORIZATION_TOKEN
PORT=9297
EMUDIR="$HOME/.aws/emulator/$PORT"
export AWS_ENDPOINT_URL="https://127.0.0.1:$PORT"
export AWS_SHARED_CREDENTIALS_FILE="$EMUDIR/emulator_credentials"
export AWS_CONFIG_FILE="$EMUDIR/config"
export AWS_CA_BUNDLE="$EMUDIR/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

测试进程的边界:内部只放模拟器生成的凭据与本地端点,通往真实云的路径被挡住

用 Boto3 调用 S3#

客户端显式指定本地端点、us-east-1 区域和 path 风格寻址;脚本先取桶列表,再建桶、上传、下载并比对字节,最后删除测试对象与测试桶:

PRTCL // PYTHON
from botocore.config import Config
import boto3
s3 = boto3.client(
"s3",
endpoint_url="https://127.0.0.1:9297",
region_name="us-east-1",
config=Config(s3={"addressing_style": "path"}, inject_host_prefix=False),
)
r = s3.list_buckets()
print("list_buckets HTTP:", r["ResponseMetadata"]["HTTPStatusCode"])
print("list_buckets Buckets:", r["Buckets"])
bucket = "blog-emulator-demo-20261117"
key = "notes/demo.txt"
payload = b"local S3 emulator test, 2026-11-17\n"
s3.create_bucket(Bucket=bucket)
s3.put_object(Bucket=bucket, Key=key, Body=payload, ContentType="text/plain")
r = s3.get_object(Bucket=bucket, Key=key)
data = r["Body"].read()
print("get_object body:", repr(data))
print("content identical:", data == payload)

实测输出如下。新实例的桶列表为空;建桶、上传、下载的 HTTP 状态均为 200,ETag 一致,下载正文与上传内容相同:

PRTCL // TEXT
--- health check ---
ok
--- versions ---
Version: 1.0.485
Release date: 2026.11.17
Commit: a2568e8a8db45f44e1a9fea808f13b22373aab60
python 3.13.5 boto3 1.44.4 botocore 1.44.4
--- boto3 S3 calls ---
list_buckets HTTP: 200
list_buckets Buckets: []
list_buckets RequestId: 0000000000000000
create_bucket HTTP: 200
put_object HTTP: 200 ETag: "c73a07f11a398416a5569e4d2257bfe6"
get_object HTTP: 200 ETag: "c73a07f11a398416a5569e4d2257bfe6"
get_object body: b'local S3 emulator test, 2026-11-17\n'
content identical: True
list_objects_v2 keys: ['notes/demo.txt']
cleanup: deleted test object and bucket

边界#

本次结果只说明本机模拟器的 S3 接口按上述步骤返回了这些响应。模拟器状态保存在内存中,进程退出即丢失;默认遥测开启,需要显式关闭。它不能验证真实 AWS 的 IAM 身份、资源策略或账号权限,也不能证明与真实 AWS 完全等价;官方仓库保留了记录行为差异的目录。本篇只调用 S3,没有运行函数代码。

Comments

Copied
Copied to clipboard