Общие сведения об эмуляторе Центров событий Azure

2025-07-28

Эмулятор Центров событий Azure — это локальное средство разработки, предназначенное для тестирования и прототипа приложений Центров событий в автономной, экономичной и изолированной среде. Эмулятор имитирует службу Центров событий локально, что обеспечивает более быстрые циклы разработки, устраняет затраты, связанные с облаком, и предоставляет управляемое тестовое окружение. В этой статье приведен обзор преимуществ, функций, ограничений и рекомендаций по использованию эмулятора, которые помогут вам приступить к работе.

Benefits

Основными преимуществами использования эмулятора являются:

Локальная разработка: эмулятор предоставляет локальный интерфейс разработки, поэтому вы можете работать в автономном режиме и избегать задержки в сети.
Экономичность. С помощью эмулятора вы можете протестировать приложения без каких-либо затрат на использование облака.
Изолированная среда тестирования. Вы можете протестировать код в изоляции, чтобы убедиться, что другие действия в облаке не влияют на тесты.
Оптимизированный внутренний цикл разработки: вы можете использовать эмулятор для быстрого прототипа и тестирования приложений перед развертыванием в облаке.

Features

Эмулятор предоставляет следующие функции:

Контейнерное развертывание: оно выполняется как контейнер Docker (на основе Linux).
Кроссплатформенная совместимость: ее можно использовать на любой платформе, включая Windows, macOS и Linux.
Настройка. Вы можете управлять количеством центров событий, секций и других сущностей с помощью предоставленной конфигурации JSON.
Поддержка потоковой передачи: она поддерживает потоковую передачу событий с помощью Kafka и расширенного протокола очереди сообщений (AMQP).
Наблюдаемость. Она предоставляет функции наблюдения, включая ведение журнала консоли и файлов.

Known limitations

Текущая версия эмулятора имеет следующие ограничения:

При использовании Kafka совместимы только API-интерфейсы производителя и потребителя с эмулятором Центров событий.
В конфигурации securityProtocol Kafka могут saslmechanism быть только следующие значения:
```
  SecurityProtocol = SecurityProtocol.SaslPlaintext,
  SaslMechanism = SaslMechanism.Plain
```
Он не поддерживает операции управления на борту с помощью клиентского пакета SDK.

Note

После перезапуска контейнера данные и сущности не сохраняются в эмуляторе.

Различия между эмулятором и облачной службой

Так как эмулятор Центров событий предназначен только для разработки и тестирования, существуют функциональные различия между эмулятором и облачной службой.

Эмулятор не поддерживает эти высокоуровневые функции:

Функции Azure, такие как интеграция виртуальной сети, интеграция идентификатора Microsoft Entra, журналы действий и портал пользовательского интерфейса
Функция "Сбор" в Центрах событий
Функции управления ресурсами, такие как группы приложений
Autoscale capabilities
Возможности геокатастрофного восстановления
Интеграция реестра схем
Визуальные метрики и оповещения

Note

Эмулятор предназначен исключительно для сценариев разработки и тестирования. Мы не рекомендуем использовать любую рабочую среду. Мы не предоставляем официальную поддержку эмулятора.

Сообщите о любых проблемах или предложениях в репозитории установщика GitHub эмулятора.

Usage quotas

Как и Центры событий в Azure, эмулятор предоставляет следующие квоты для использования:

Property	Value	Пользователь, настраиваемый в пределах ограничений
Количество поддерживаемых пространств имен	1	No
Максимальное количество центров событий в пространстве имен	10	Yes
Максимальное количество групп потребителей в концентраторе событий	20	Yes
Максимальное количество секций в концентраторе событий	32	Yes
Максимальный размер события, публикуемого в концентраторе событий (пакетная или небатная версия)	1 MB	No
Минимальное время хранения событий	1 hr	No

Эмулятор применяет эти ограничения. Хотя некоторые значения настраиваются с помощью config.json, вы не можете превышать указанные максимумы. Перед запуском эмулятора необходимо вносить любые изменения конфигурации.

Изменения конфигурации квоты

По умолчанию эмулятор запускается с файлом конфигурации config.json . Квоты, связанные с Центрами событий, можно настроить, изменив этот файл следующим образом в зависимости от ваших потребностей:

Сущности. Вы можете добавить дополнительные сущности (центры событий) с настраиваемым количеством секций и групп потребителей в соответствии с поддерживаемыми квотами.
Ведение журнала. Эмулятор поддерживает ведение журнала в консоли, в файле или обоих. Вы можете выбрать в соответствии с вашими личными предпочтениями.

Important

Перед запуском эмулятора необходимо указать любые изменения в конфигурации JSON. Изменения не учитываются на лету. Чтобы изменения вступили в силу, необходимо перезапустить контейнер.

Невозможно переименовать предварительно заданное пространство имен (name) в файле конфигурации.

Журналы для отладки

Во время тестирования консоль или журналы файлов помогают отлаживать непредвиденные сбои. Чтобы просмотреть журналы, выполните следующие действия.

Журналы консоли: в пользовательском интерфейсе рабочего стола Docker выберите имя контейнера.
Журналы файлов: в контейнере перейдите в раздел /home/app/EmulatorLogs.

Тестирование локально с помощью эмулятора Центры событий Azure

Поделиться через