AWS опубликовала AWS Emulator: локальный эмулятор для тестов

AWS Emulator, локальный эмулятор API AWS. Он нужен, чтобы тестировать программы, не обращаясь к самой AWS: на своём компьютере, на сервере разработки или в системе непрерывной интеграции (CI). Аккаунт AWS не требуется: запросы уходят в эмулятор, а не в облако, поэтому вы работаете с эмулированными ресурсами. Отдельной платы за сам эмулятор нет; платить приходится только за настоящие ресурсы AWS, когда вы разворачиваете систему в облаке.
Эмулятор, это локальная программа без графического интерфейса, которая поднимает конечную точку (endpoint) AWS API. После запуска нужно задать переменные окружения, чтобы AWS CLI или SDK обращались к ней, и затем запускать код как обычно. Есть и встроенный режим (embedded mode): эмулятор подключается как dev-зависимость и работает внутри процесса теста, по одному изолированному экземпляру на каждый тест. Адрес, сертификат и переменные окружения не нужны: тест передаёт HTTP-клиент эмулятора прямо в клиент SDK.
Установка. Можно поставить навык aws-emulator и попросить ИИ-агента настроить эмулятор (командой aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1; нужен AWS CLI версии 2.35.0 или новее). В Linux доступны пакеты RPM и Debian, после установки запускается aws-emulator. В Windows и macOS эмулятор запускают в контейнере, собранном из короткого Dockerfile.
Назначение и границы. README прямо говорит: эмулятор предназначен для разработки и тестирования, его нельзя использовать для рабочей нагрузки (production) и для проверки безопасности. О том, насколько каждый сервис совпадает с настоящей AWS, говорят оценки точности (fidelity scores), которые публикуются с каждым релизом на странице релизов. Известные пробелы ведутся в каталоге issues/: то, что пока не работает, лежит в issues/things-that-do-not-work/, а исправленное переносится в issues/things-that-now-work/.
Сборка из исходников нужна тем, кто меняет сам эмулятор, запускает его из репозитория или использует встроенный режим (он компилирует эмулятор в тестовый бинарник). Поддерживаются Linux x86_64 и aarch64; на Windows и macOS предлагается путь через Docker. Требуются Rust с Cargo, компилятор C (GCC или clang), многоядерная машина и не менее 100 ГБ свободного места под target/: в рабочем пространстве по одному крейту на каждый сервис AWS, поэтому отладочная сборка всего набора велика и растёт с добавлением сервисов. Первая холодная сборка долгая, дальнейшие пересборки после правки одного сервиса заметно быстрее. Запущенный из исходников эмулятор отдаёт HTTPS на 127.0.0.1:9297 с самоподписанным сертификатом. Для встроенного режима рекомендуют общий CARGO_TARGET_DIR на несколько проектов, кэш target/ (или sccache) в CI и фиксацию версии эмулятора на релизном коммите, чтобы он не пересобирался при каждом изменении.
Телеметрия. Эмулятор настроен собирать и отправлять в AWS данные об использовании, и по умолчанию она включена. По заявлению README, сбор устроен с жёсткой минимизацией: данные не позволяют установить пользователя, аккаунт или организацию, в записи не попадают содержимое запросов и ответов, код, учётные данные и персональные данные, а третьим лицам телеметрия не передаётся. Что именно собирается, описано на отдельной странице «Telemetry in AWS Emulator». Отключить можно несколькими способами: ключом --telemetry off (короткая форма -t) для одного процесса; в контейнере, добавив --telemetry off после имени образа в docker run; переменной EMULATOR_TELEMETRY (значения on/true/1 включают, off/false/0 выключают, регистр не важен, любое другое значение выключает телеметрию и показывает предупреждение при запуске); строкой enabled = false в разделе [telemetry] файла config.toml (~/.aws/emulator/config.toml в Linux и macOS, %USERPROFILE%.aws\emulator\config.toml в Windows; другой путь задаётся переменной EMULATOR_CONFIG); а во встроенном режиме, опцией Telemetry::Off при создании эмулятора. Тем, кто встраивает эмулятор в свой инструмент, например в тестовый фреймворк, README советует сообщать пользователям о телеметрии и давать способ её отключить или поставлять инструмент с выключенной телеметрией.
Участие и лицензия. Об ошибках и расхождениях с настоящей AWS предлагается сообщать в GitHub Issues: полезнее всего указать сервис, операцию, SDK и его версию, отправленный запрос и чем ответ отличался от реальной AWS. Репозиторий не принимает pull request-ы. Лицензия, CC0 1.0 Universal, кроме каталога vendor/ (каркасные крейты, их не правят), где действует Apache License 2.0.
Ключевые факты
- AWS Emulator, локальная программа без графического интерфейса, имитирующая API AWS: работает без аккаунта AWS, запросы идут в эмулятор, отдельной платы за него нет.
- Запуск: пакеты RPM/Debian в Linux, контейнер из короткого Dockerfile в Windows и macOS, установка через навык для ИИ-агента (нужен AWS CLI 2.35.0 или новее) и встроенный режим с изолированным экземпляром на каждый тест.
- Только для разработки и тестов: README запрещает использовать эмулятор для рабочей нагрузки и проверки безопасности; пробелы в точности ведутся в каталоге issues/.
- Сборка из исходников (и встроенный режим) требует Rust, компилятор C и не менее 100 ГБ свободного места под target/; из исходников эмулятор отдаёт HTTPS на 127.0.0.1:9297 с самоподписанным сертификатом.
- Телеметрия об использовании уходит в AWS и включена по умолчанию; отключается ключом --telemetry off, переменной EMULATOR_TELEMETRY, настройкой в config.toml или опцией во встроенном режиме. Лицензия CC0 1.0, pull request-ы не принимаются.
Почему это важно
Разработчикам облачных приложений обычно приходится тестировать код либо на настоящей AWS (аккаунт, ресурсы, расходы), либо на сторонних имитациях. Здесь локальный эмулятор лежит в репозитории aws/aws-emulator, то есть в организации самой AWS на GitHub. Он позволяет прогонять тесты на своей машине и в CI без аккаунта и без обращений к облаку. Отдельной платы за сам эмулятор нет, а встроенный режим даёт изолированный экземпляр на каждый тест.
Кому это важно
Разработчикам, чей код работает с AWS SDK и AWS CLI и кто хочет тестировать его без аккаунта и расходов. Командам, которые настраивают CI. Авторам тестовых фреймворков и других инструментов, которые могут включить эмулятор в свой состав: им README отдельно советует рассказывать пользователям о телеметрии. Тем, кто использует ИИ-агентов для настройки окружения: предусмотрен готовый навык aws-emulator.
Как это применить
Самый короткий путь: в Linux поставить пакет RPM или Debian и запустить aws-emulator, затем задать переменные окружения, чтобы AWS CLI или SDK смотрели на его адрес, и запускать код как обычно. В Windows и macOS эмулятор запускают в контейнере из короткого Dockerfile. Альтернатива, установить навык командой aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1 (нужен AWS CLI 2.35.0 или новее) и попросить агента настроить эмулятор. Для встроенного режима добавьте эмулятор как dev-зависимость и передайте его HTTP-клиент в клиент SDK. Заранее заложите ресурсы: не менее 100 ГБ под target/ и долгую первую сборку; рекомендации README, общий CARGO_TARGET_DIR, кэш target/ или sccache в CI и фиксация релизного коммита. Чтобы отключить телеметрию, используйте --telemetry off, переменную EMULATOR_TELEMETRY=off или enabled = false в config.toml. Проверить, насколько нужные сервисы совпадают с AWS, можно по оценкам точности на странице релизов и по каталогу issues/. Лицензия CC0 1.0 (vendor/, Apache 2.0).
Можно ли доверять
Источник, первичный: README самого репозитория aws/aws-emulator, и пересказ опирается только на него. В тексте нет даты выпуска, номера версии и статуса зрелости, нет перечня поддерживаемых сервисов и самих значений оценок точности, нет сравнений с другими эмуляторами. Утверждения о минимизации данных телеметрии, заявления самой AWS; перечень собираемых полей вынесен на отдельную страницу, которой в этом тексте нет. Сроков закрытия пробелов и добавления сервисов README не называет.
Риски и подводные камни
Эмулятор не заменяет настоящую AWS: README запрещает использовать его для рабочей нагрузки и для проверки безопасности, а точность по сервисам неполная, часть API и поведения пока не работает. Телеметрия включена по умолчанию и отправляет данные об использовании в AWS, поэтому тем, кто работает в закрытом контуре или встраивает эмулятор в чужой инструмент, нужно отключить её явно. Любое значение EMULATOR_TELEMETRY, кроме распознаваемых, тоже выключает телеметрию (с предупреждением при запуске). Сборка из исходников и встроенный режим тяжёлые: не менее 100 ГБ диска, компилятор C, многоядерная машина, долгая холодная сборка, а размер растёт с числом сервисов. Сборка из исходников поддерживается только в Linux (x86_64 и aarch64). Из исходников эмулятор отдаёт HTTPS с самоподписанным сертификатом. Репозиторий не принимает pull request-ы, так что исправления идут только через Issues.