Developer Tools9 мин чтения

Какие тесты AWS можно перенести из облака на ноутбук?

AWS Emulator выполняет поддерживаемые вызовы облачных API локально. Пример записи и чтения в DynamoDB показывает, где это ускоряет обратную связь и зачем всё ещё нужен настоящий аккаунт AWS.

K
Ken Jo

Представьте, что изменение в коде выглядит совсем простым. Приложение должно записать заказ в DynamoDB и прочитать обратно тот же заказ. За несколько секунд можно проверить аргументы вызова подставного клиента. Можно также развернуть приложение в аккаунте разработки и проследить весь процесс. Между этими вариантами есть ещё один полезный тест, для которого AWS теперь предоставляет локальную конечную точку.

11 ноября 2026 года Amazon Web Services сделала AWS Emulator общедоступным. Инструмент с открытым исходным кодом позволяет AWS CLI и SDK отправлять запросы к поддерживаемым сервисам в эмулятор на вашем компьютере. AWS не взимает отдельной платы за эмулятор. Поведение зависит от конкретного API, и AWS по-прежнему рекомендует до выхода в продакшен проверить безопасность и работу всего приложения в реальной среде AWS. Объявление AWS о выпуске

Пример с DynamoDB хорошо показывает, как разделить проверки. При каждом изменении можно выяснять, правильно ли приложение записывает и читает данные. Меньший объём облачных тестов поможет понять, совпадают ли реальные права роли, ресурсы и поведение сервиса с вашими предположениями. Обе проверки остаются в процессе выпуска.

Интеграционный тест может начаться с одной записи

Начните с конкретного бизнес-требования. В тестовое приложение поступает заказ с идентификатором order-123 и статусом pending. Приложение записывает его через клиент DynamoDB. Новый запрос на чтение через слой доступа к данным возвращает те же идентификатор и статус. Тест обнаруживает, например, запись в одну таблицу и чтение из другой, сохранение атрибута под неверным именем или несовпадение структуры ключа. Мок тоже позволяет воспроизвести такие ошибки при явной настройке, если заранее известно, какие ошибки искать.

В публикации AWS о выпуске показана похожая последовательность. Пример создаёт таблицу со строковым ключом раздела, вставляет элемент и считывает его. В публикации есть вариант для CLI и пример с Rust SDK, где эмулятор работает внутри процесса. Обычный клиент позволяет проверить почти тот же интеграционный код, который уже использует приложение. Проверка возвращённого значения даёт больше информации, чем подтверждение вызова метода SDK. Примеры из объявления AWS

Интеграционный тест DynamoDB отправляет запросы на запись и чтение через SDK к локальной конечной точке

При записи и чтении локальный тест задействует тот же клиентский код. Иллюстрация Telli.sh.

Для Linux AWS предоставляет нативные пакеты RPM и Debian. Для Windows и macOS официальная инструкция описывает сборку и запуск Docker-образа. Автономный эмулятор по умолчанию запускает HTTPS на 127.0.0.1:9297 и создаёт локальную конфигурацию, сертификат и отдельные учётные данные. Проверки доступности и идентификатора вызывающей стороны помогают убедиться, что тестовая оболочка подключена к эмулятору, прежде чем создавать ресурсы. AWS также описывает встроенный режим в Rust SDK, который позволяет запустить отдельный экземпляр для теста внутри процесса. Руководство пользователя AWS Emulator

Храните настройки клиента в конфигурации теста. В тестовой оболочке должны быть конечная точка эмулятора, настройки сертификата и его учётные данные. Учётные данные реального AWS следует оставить за пределами этой оболочки. В реальном развёртывании используйте тот же код приложения. Так границу можно проверить. Если эмулятор недоступен, локальная задача должна завершиться явной ошибкой подключения или конфигурации. Если тест незаметно обратится к другой среде, результат может оказаться недействительным, а владелец аккаунта столкнётся с неожиданными вызовами.

По данным AWS, запросы, ответы и данные, сохранённые эмулятором, остаются на локальном компьютере. Автономный эмулятор по умолчанию отдельно отправляет анонимную статистику использования и ошибок. Эту телеметрию можно отключить в настройках эмулятора. Документация AWS к выпуску

От каждого теста ждите конкретного доказательства

Можно выделить три уровня. Первый — модульный тест для поведения, за которое отвечает ваш код. Например, приложение отклоняет неполный заказ, прежде чем вызывать сервис. Второй уровень проверяет одновременно настройки клиента, кодирование данных и поддерживаемую операцию сервиса. Третий подтверждает работу развёрнутых ресурсов, ролей и сервиса в настоящей среде AWS. Увидев, как выглядит сбой на каждом уровне, команда может пересмотреть распределение проверок.

УровеньПример утвержденияЧто подтверждает
Модульный тестЗаказ без идентификатора отклоняется до вызова клиентаПриложение соблюдает собственное правило
Локальный эмуляторКорректный заказ можно записать и прочитать через SDKЭтот клиент и эти поддерживаемые операции работают с эмулятором
Интеграция в AWSРоль развёрнутого приложения может обновить разрешённую таблицу и получает отказ для запрещённого ресурсаРеальная конфигурация соблюдает границу доступа

Начните с одного успешного локального случая и добавьте сбой, важный для команды. Если повторный запрос должен оставить сохранённый заказ без изменений, отправьте его второй раз и проверьте бизнес-результат. Если проблема связана с условной записью или транзакцией, проверьте, ведут ли себя конкретные операции так, как предполагает тест. Стоит убедиться, что эмулятор воспроизводит нужные вашему продукту операцию и семантику. Само наличие записи мало говорит о состоянии гонки, которое не воспроизводилось в тесте.

Пример с очередью показывает, где проходит граница. Воркер читает задание, записывает результат и подтверждает обработку. Если нужные операции поддерживаются, последовательность действий воркера можно проверить локально. Имитируйте сбой при записи результата и выясните, оставляет ли приложение задание доступным для повторной обработки согласно вашему контракту. Облачная среда нужна для проверки управляемой сервисом доставки событий, прав развёрнутой роли и задержек, существенных под нагрузкой. Локальный тест даёт основания судить о том сценарии, который он действительно прошёл.

Список операций говорит больше, чем название сервиса

AWS публикует результаты проверки совместимости по сервисам в виде числа пройденных тестов из общего количества. В объявлении для объяснения формата приведено 40 из 50. Команде всё равно нужно посмотреть тестовые случаи для вызовов, от которых она зависит. Оценка может снизиться, если в новой версии добавились более сложные тесты, даже когда поддержка прежних возможностей улучшилась. По данным AWS, эмулятор возвращает HTTP 501 для операции, которую он пока не реализует. Набор проверок AWS

Если команда использует три вызова DynamoDB, стоит перечислить операции и значимые особенности каждой. Это могут быть запись, чтение со строгой согласованностью и условное обновление, которое не позволяет одному действию пользователя перезаписать другое. Укажите, где проверяется каждое поведение: в наборе AWS, тесте команды, облачной проверке или сразу в нескольких местах. При обновлении эмулятора снова проверяйте необходимые операции. Тогда совместимость можно оценивать для каждой версии зависимости.

План тестирования разделяет локальную проверку поддерживаемых запросов и проверку прав развёрнутой системы в настоящей среде AWS

Две среды отвечают на разные вопросы об одном приложении. Иллюстрация Telli.sh.

Если тест получил HTTP 501, сначала выясните, какой именно вызов его вызвал. Перенос такого случая в облачную задачу позволяет сохранить проверку требования. Если API доступен, а локальный ответ отличается от ответа AWS, найдите минимальный набор синтетических данных, на котором видна разница, и при необходимости сообщите о ней в проект. Расхождение может также выявить ошибочное предположение в клиентском коде. Оставьте сбой видимым, пока не станет ясно, где его исправлять.

В объявлении говорится, что разработчики используют ИИ-агентов для сравнения поведения эмулятора с реальными ответами сервисов и опубликованными моделями API. Изменения проходят проверку и контроль в конвейере релиза. Благодаря процессу сопровождения команды могут изучать общедоступные результаты. Для операции вашего приложения, которую пока никто не проверил, по-прежнему нужен собственный результат. Объявление AWS и описание процесса разработки

Права и развёртывание проверяйте в реальном аккаунте

Локальный инструмент использует подпись запросов и отдельные учётные данные эмулятора. Эти проверки решают иную задачу, чем полная оценка политик AWS. AWS указывает, что эмулятор не вычисляет эффект политик IAM и политик ресурсов так, как это делает настоящая среда. На момент запуска он также моделирует один аккаунт без межаккаунтного и межрегионального взаимодействия. Успешный ответ эмулятора подтверждает результат функционального теста. Облачная проверка с реальной ролью подтверждает решение о доступе. Ограничения при запуске AWS

Продолжим пример с заказом. Воркер в продакшене должен обновлять только определённую таблицу. В аккаунте разработки AWS запустите его с фактически используемой ролью и проверьте операцию над разрешённой таблицей. Повторите операцию на контролируемом ресурсе, куда роль не должна иметь права записи. Отрицательный сценарий важен, потому что тест только разрешённых записей может пройти даже при избыточных правах. Используйте синтетические ресурсы и удаляйте их согласно действующим правилам среды вашей команды.

В другом сценарии приложение читает файлы, загруженные в корзину хранения отдельного аккаунта. Развёртывание может зависеть от роли приложения, политики корзины и связи между ресурсами. Выполните узкую облачную проверку этой связи для нужного сочетания аккаунтов и регионов. Эмулятор пригодится для проверки входных данных, имён объектов и шагов, которые опираются на поддерживаемые вызовы в одном локальном экземпляре. Так разработчики могут быстро продолжать работу, а контракт реального подключения остаётся под проверкой.

Запускайте быстрые тесты в ветке и измеряйте весь цикл

Эмулятор может сократить время обратной связи, но результат зависит от того, что сейчас отнимает время. Трёхминутное развёртывание ради одного изменения API — одна ситуация. Долгий набор тестов в уже недорогой общей среде — другая. Измерьте время подготовки, выполнения и очистки в текущем процессе. Затем проверьте то же типичное изменение локальной интеграционной задачей и запишите, какие облачные проверки остаются и когда вы их запускаете.

Измеряйте время от начала изменения до первого результата, по которому можно действовать. Быстрый тест всё равно может затормозить работу, если разработчики потом десять минут разбираются с отсутствующим сертификатом или конфликтом общего состояния. Зафиксируйте версию эмулятора в CI, изолируйте тестовые данные и ждите готовности перед запуском набора проверок. В журналах различайте ошибки запуска и ошибки проверяемых утверждений. AWS описывает изолированные встроенные экземпляры для тестов Rust. При использовании автономного сервиса отдельные воркеры или уникальные имена ресурсов помогут предотвратить пересечение данных параллельных тестов.

  1. Выберите воспроизводимый тест, который вызывает один сервис AWS и записывает синтетические данные.
  2. Зафиксируйте версию эмулятора и запустите одноразовый экземпляр или изолированную локальную среду.
  3. Укажите тестовые учётные данные и конечную точку. Перед записью проверьте идентификатор и готовность сервиса.
  4. Проверьте ожидаемое поведение и один отрицательный сценарий. Для упавших проверок сохраните входные данные и наблюдения.
  5. Сохраните короткую проверку развёрнутой интеграции и политик IAM в настоящем AWS. Запишите, почему для неё нужна облачная среда.

В этом цикле агент для программирования может помочь доработать приложение. Для быстрого эксперимента ему достаточно тестовой конечной точки и небольшого проверяемого утверждения, без развёртывания множества облачных ресурсов. Попросите показать падающий тест для дефекта и проходящий тест после исправления. Применяйте те же правила человеческой проверки покрытия и прав, что и для остальных изменений. Быстрый запуск полезен, когда агент возвращает конкретный результат.

Если стоимость влияет на решение, отслеживайте фактическое использование облачных ресурсов. У AWS Emulator нет отдельной платы за сервис, однако локальный CI использует вычислительные ресурсы. Проверки в развёрнутой среде AWS по-прежнему могут стоить денег в зависимости от ресурсов. Сравнивайте затраты команды на надёжное покрытие в течение всего цикла выпуска. Локальная задача, которая рано выявляет ошибки контракта, и компактная облачная проверка могут уменьшить число повторных развёртываний, сохранив надёжность выпуска.

Хорошее разделение подсказывает, где исправлять сбой

Если локальный тест не может записать и прочитать заказ, разработчик может начать с запроса и слоя доступа к данным. Если падает облачный тест прав, владелец системы может сначала изучить конфигурацию развёртывания и политику. В этом и состоит польза двух конечных точек в тестовом цикле. Быстрая обратная связь особенно ценна, когда сразу указывает, за какое изменение браться дальше.

Источники


Чтобы хранить решения об интеграции и заметки о тестах вместе и находить их поиском, создайте аккаунт Telli.sh.


← Вернуться в блог