В репозитории aws-emulator я сразу обратил внимание на деталь, которую редко увидишь у облачного гиганта. Amazon, чей бизнес держится на оплате каждого вызова и ресурса, выложил локальный эмулятор собственных API в общественное достояние под лицензией CC0-1.0 — с 34 127 коммитами, 8,8 тысячи звёзд и откровенной папкой issues/things-that-do-not-work/, куда команда складывает операции, расходящиеся с реальным облаком. При этом README сразу предупреждает: пулл-реквесты проект не принимает, все правки приходят изнутри AWS.
Для разработчика за этим эпизодом стоит прямой практический вопрос: как гонять интеграционные тесты сервиса, который кладёт пользовательские медиаархивы в S3 и ставит задачи в очередь SQS, локально и в CI без облачного аккаунта и случайных счетов? Эмулятор перехватывает запросы стандартных SDK на локальный сокет, эмулируя поведение ключевых сервисов на собственном железе. Но за удобство приходится платить ограничениями — и лучше разобраться в них до переноса пайплайна.
Почему тесты на живом AWS буксуют и как устроен перехват на Smithy
Проверка облачных интеграций на живом тестовом аккаунте создаёт постоянное трение: нужно изолировать учётные данные в CI, убирать ресурсы после упавших прогонов, чтобы не накрутить трафик, и мириться с сетевыми задержками API. Долгое время эту боль снимал LocalStack, но в нём многие расширенные сервисы и функции закрыты платной Pro-лицензией.
В aws-emulator модель другая: весь код открыт как общественное достояние (лишь каталоги в vendor/ идут под Apache License 2.0) и написан на Rust поверх официальных моделей Smithy. Под каждый сервис выделен свой крейт services/service-<name>/ со схемой smithy-model/<name>.json, генератором build.rs, обработчиками в ops/ и состоянием в памяти в state.rs. Модуль core/router/ собирает всё это на едином локальном HTTPS-адресе 127.0.0.1:9297 с самоподписанным сертификатом. За счёт прямой генерации из Smithy-спецификаций эмулятор держит высокий уровень соответствия протоколам ключевых сервисов без подписки.
Серверный и встраиваемый режимы: запускаем S3 и SQS на локальном порту
У инструмента два режима работы — серверный для любых языков и встраиваемый для тестов на Rust. Если ты пишешь на Python, Node.js, Go или Java, проще всего поднять официальный контейнер Docker (на Linux также доступны пакеты RPM и DEB).
Запустим локальный эмулятор на порту 9297 с отключённой телеметрией, чтобы проверить наш сервис загрузки медиафайлов без выхода в сеть:
docker run -d --name aws-emulator -p 9297:9297 public.ecr.aws/aws-emulator/aws-emulator:latest --telemetry off
Контейнер поднимает локальный HTTPS-демон на 127.0.0.1:9297 без графического интерфейса. Флаг --telemetry off сразу после имени образа отключает отправку статистики, а все созданные бакеты и очереди живут в памяти контейнера.
Теперь направим AWS CLI на локальный порт, зададим фиктивные ключи и создадим бакет S3 с очередью SQS для приёма архивов:
export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_ACCESS_KEY_ID=dummy-test-key
export AWS_SECRET_ACCESS_KEY=dummy-test-secret
export AWS_DEFAULT_REGION=us-east-1
aws s3 mb s3://my-local-bucket --endpoint-url https://127.0.0.1:9297 --no-verify-ssl
aws sqs create-queue --queue-name local-tasks --endpoint-url https://127.0.0.1:9297 --no-verify-ssl
Эмулятор принимает любые непустые тестовые ключи, поэтому реальные секреты AWS в CI больше не нужны. Параметр --no-verify-ssl здесь обязателен: он разрешает клиенту принять самоподписанный сертификат локального сокета (в окружении для этого же можно сбросить AWS_CA_BUNDLE="").
Дальше подключим интеграционный тест на Python через boto3, который загружает в локальный бакет метаданные обработанного архива и проверяет чтение объекта:
import boto3
s3 = boto3.client(
"s3",
endpoint_url="https://127.0.0.1:9297",
aws_access_key_id="test",
aws_secret_access_key="test",
region_name="us-east-1",
verify=False,
)
s3.put_object(Bucket="my-local-bucket", Key="data.json", Body=b'{"status":"ok"}')
response = s3.get_object(Bucket="my-local-bucket", Key="data.json")
assert response["Body"].read() == b'{"status":"ok"}'
Бизнес-логика не меняется: меняется только endpoint_url и флаг verify=False для локального TLS. Точно такой же шаг с контейнером переносится в GitHub Actions. А если ты используешь кодинг-агентов (Claude Code, Cursor или Kiro) с AWS CLI 2.35.0 или новее, настройку окружения можно поручить агенту:
aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1
Команда ставит официальный навык из Agent Toolkit, после чего агент сам поднимает эмулятор и перенаправляет запросы при отладке.
Принципиально иначе устроен Embedded mode для проектов на Rust: эмулятор добавляется как dev-dependency и стартует прямо внутри тестового процесса.
use aws_emulator_embedded::{AwsEmulatorEmbedded, EmbeddedOptions, Telemetry};
fn main() {
let emulator = AwsEmulatorEmbedded::new(
EmbeddedOptions::default().telemetry(Telemetry::Off),
);
let _http_client = emulator.http_client();
}
Встраиваемый режим не занимает порт 9297, не требует сертификатов и переменных окружения: ты передаёшь emulator.http_client() в SDK-клиент и получаешь изолированный экземпляр эмулятора для каждого параллельного теста.
Цена удобства: 100 ГБ на сборку, телеметрия и границы эмуляции
За нулевые счета в AWS эмулятор просит вполне ощутимую плату ресурсами и вниманием к деталям. Из трёх ограничений, которые я бы проверил до переноса тестов в CI, первое — тяжёлая сборка из исходников: поскольку каждый сервис живёт в отдельном крейте Rust, холодная компиляция через cargo build -p aws-emulator-router или первый прогон cargo test во встраиваемом режиме требует компилятор C, многоядерный процессор и не менее 100 ГБ на диске под каталог target/. В повседневной работе проще брать Docker-образ или бинарный пакет, а в Rust-CI кешировать target/, выносить общий CARGO_TARGET_DIR, использовать sccache и пинить релизный коммит.
Второй нюанс — телеметрия по умолчанию. Эмулятор отправляет в AWS обезличенную статистику использования (без тел запросов, кода, ключей и персональных данных). Если политика безопасности команды запрещает такой трафик, его отключают флагом --telemetry off (-t off), переменной EMULATOR_TELEMETRY=off (или false, 0), параметром Telemetry::Off или файлом ~/.aws/emulator/config.toml с секцией [telemetry] и enabled = false.
Третье — границы точности. В руководстве AWS Emulator прямо запрещено использовать инструмент для продакшена и проверки безопасности вроде политик IAM. Прежде чем полагаться на эмулятор в сложном сценарии, стоит сверить оценки точности (fidelity scores) в релизах и заглянуть в issues/things-that-do-not-work/.
Волшебной кнопки, которая на сто процентов заменит живое облако, здесь нет — но теперь правила игры понятны. Быстрые интеграционные тесты S3, SQS и контрактов SDK выгодно перенести на локальный aws-emulator на 127.0.0.1:9297 с нулевым бюджетом, а реальный тестовый аккаунт AWS оставить для финальной проверки прав доступа перед релизом. Если хочешь сравнить этот подход с более компактной альтернативой, загляни в разбор эмулятора Kumo на Go и в обзор инструментов разработки с AWS Emulator.



