Локальное тестирование облачной инфраструктуры: официальный эмулятор API от AWS без облачных счетовСтатья · дайджест за 17 ноября
Макроснимок компактного аппаратного сервера с локальным портом 9297 и индикатором автономной эмуляции AWS.
Статья3 раздела≈ 6 мин

Локальное тестирование облачной инфраструктуры: официальный эмулятор API от AWS без облачных счетов

В репозитории 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.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2