Создание триггера для Yandex IoT Core

Статья создана

Перед началом работы
Создать триггер
Проверить результат
Что дальше

Создайте триггер для топика устройства или реестра сервиса Yandex IoT Core и обрабатывайте копии сообщений с помощью функции Cloud Functions или контейнера Serverless Containers.

Важно

Триггер должен находиться в одном облаке с реестром или устройством, из топика которого он читает сообщения.

Перед началом работы

Для создания триггера вам понадобятся:

Функция или контейнер, которые триггер будет запускать.
- Если у вас нет функции:
  - Создайте функцию.
  - Создайте версию функции.
- Если у вас нет контейнера:
  - Создайте контейнер.
  - Создайте ревизию контейнера.
Реестр или устройство, из топиков которых триггер будет принимать копии сообщений. Если у вас их нет:
- Создайте реестр.
- Создайте устройство.
(опционально) Очередь Dead Letter Queue, куда будут перенаправляться сообщения, которые не смогли обработать функция или контейнер. Если у вас нет очереди, создайте ее.
Сервисные аккаунты с правами на вызов функции или контейнера и (опционально) запись в очередь Dead Letter Queue. Вы можете использовать один и тот же сервисный аккаунт или разные. Если у вас нет сервисного аккаунта, создайте его.

Создать триггер

Примечание

Триггер начинает работать в течение 5 минут после создания.

Консоль управления

CLI

API

В консоли управления перейдите в каталог, в котором хотите создать триггер.
Откройте сервис Cloud Functions.
На панели слева выберите Триггеры.
Нажмите кнопку Создать триггер.
В блоке Базовые параметры:
- Введите имя и описание триггера.
- В поле Тип выберите Yandex IoT Core.
- Выберите, что будет запускать триггер — функцию или контейнер.
В блоке Настройки сообщений Yandex IoT Core укажите реестр, устройство и MQTT-топик, для которого хотите создать триггер. Если вы создаете триггер для топика реестра, устройство и MQTT-топик можно не указывать.
Если триггер будет запускать:
- функцию, в блоке Настройки функции выберите ее и укажите:
  - тег версии функции;
  - сервисный аккаунт, от имени которого будет вызываться функция.
- контейнер, в блоке Настройки контейнера выберите его и укажите:
  - ревизию контейнера;
  - сервисный аккаунт, от имени которого будет вызываться контейнер.
(опционально) В блоке Настройки повторных запросов:
- В поле Интервал укажите время, через которое будет сделан повторный вызов функции или контейнера, если текущий завершился неуспешно. Допустимые значения — от 10 до 60 секунд, значение по умолчанию — 10 секунд.
- В поле Количество попыток укажите количество повторных вызовов функции или контейнера, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Допустимые значения — от 1 до 5, значение по умолчанию — 1.
(опционально) В блоке Настройки Dead Letter Queue выберите очередь Dead Letter Queue и сервисный аккаунт с правами на запись в нее.
Нажмите кнопку Создать триггер.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы создать триггер, который запускает функцию, выполните команду:

yc serverless trigger create internet-of-things \
  --name <имя триггера> \
  --registry-id <идентификатор реестра> \
  --device-id <идентификатор устройства> \
  --mqtt-topic '$devices/<идентификатор устройства>/events' \
  --invoke-function-id <идентификатор функции> \
  --invoke-function-service-account-id <идентификатор сервисного аккаунта> \
  --retry-attempts 1 \
  --retry-interval 10s \
  --dlq-queue-id <идентификатор очереди Dead Letter Queue> \
  --dlq-service-account-id <идентификатор сервисного аккаунта>

Где:

--name — имя триггера.
--registry-id — идентификатор реестра.
--device-id — идентификатор устройства. Если вы создаете триггер для топика реестра, этот параметр можно не указывать.
--mqtt-topic — топик, для которого вы хотите создать триггер.
--invoke-function-id — идентификатор функции.
--invoke-function-service-account-id — сервисный аккаунт с правами на вызов функции.
--retry-attempts — время, через которое будет сделан повторный вызов функции, если текущий завершился неуспешно. Необязательный параметр. Допустимые значения — от 10 до 60 секунд, значение по умолчанию — 10 секунд.
--retry-interval — количество повторных вызовов, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Необязательный параметр. Допустимые значения — от 1 до 5, значение по умолчанию — 1.
--dlq-queue-id — идентификатор очереди Dead Letter Queue. Необязательный параметр.
--dlq-service-account-id — сервисный аккаунт с правами на запись в очередь Dead Letter Queue. Необязательный параметр.

Результат:

id: a1sl0mkmimfj3uv52fr8
folder_id: b1g88tflru0ek1omtsu0
created_at: "2019-09-25T13:54:35.654935Z"
name: iot-trigger
rule:
  iot_message:
    registry_id: arenou2oj4ct42eq8g3n
    device_id: areqjd6un3afc3cefcvm
    mqtt_topic: $devices/areqjd6un3afc3cefcvm/events
    invoke_function:
      function_id: d4eofc7n0m03lmudse8l
      function_tag: $latest
      service_account_id: aje3932acd0c5ur7dagp
      retry_settings:
        retry_attempts: "1"
        interval: 10s
status: ACTIVE

Создать триггер для Yandex IoT Core можно с помощью метода API create.

Проверить результат

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

Что дальше

Ознакомьтесь с концепциями триггеров.
Прочитайте подробнее о триггере для Yandex IoT Core.
Посмотрите, что можно делать с триггерами в пошаговых инструкциях.
Ознакомьтесь с концепциями Yandex IoT Core.

Создание триггера для Yandex IoT Core

Перед началом работы

Создать триггер

Проверить результат

Что дальше

Была ли статья полезна?