Создание триггера для Message Queue

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

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

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

yc serverless trigger create message-queue \
  --name <имя триггера> \
  --queue <идентификатор очереди> \
  --queue-service-account-id <идентификатор сервисного аккаунта> \
  --invoke-function-id <идентификатор функции> \
  --invoke-function-service-account-id <идентификатор сервисного аккаунта> \
  --batch-size 1 \
  --batch-cutoff 10s

Где:

• --name — имя триггера.

• --queue — идентификатор очереди.

  Чтобы узнать идентификатор очереди:

  1. В консоли управления перейдите в каталог, в котором находится очередь.
  2. Выберите сервис Message Queue.
  3. Выберите очередь.
  4. Идентификатор очереди будет в блоке Общая информация, в поле ARN.

• --invoke-function-id — идентификатор функции.

• --queue-service-account-name — сервисный аккаунт с правами на чтение из очереди сообщений.

• --invoke-function-service-account-id — сервисный аккаунт с правами на вызов функции.

• --batch-size — размер группы сообщений. Необязательный параметр. Допустимые значения от 1 до 10, значение по умолчанию — 1.

• --batch-cutoff — максимальное время ожидания. Необязательный параметр. Допустимые значения от 0 до 20 секунд, значение по умолчанию — 10 секунд. Триггер группирует сообщения не дольше batch-cutoff и отправляет их в функцию. Число сообщений при этом не превышает batch-size.

Результат:

id: dd0cspdch6dslu9n3i5g
folder_id: aoek49ghmknnpj1ll45e
created_at: "2019-08-28T12:14:45.762915Z"
name: ymq-trigger
rule:
  message_queue:
    queue_id: yrn:yc:ymq:ru-central1:aoek49ghmknnpj1ll45e:my-mq
    service_account_id: bfbqqeo6jkpls2tse5o6
    batch_settings:
      size: "1"
      cutoff: 10s
    invoke_function:
      function_id: b09e5lu91ta21vdrrgma
      function_tag: $latest
      service_account_id: bfbqqeo6jkpls2tse5o6
status: ACTIVE

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

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). Terraform и его провайдеры распространяются под лицензией Mozilla Public License.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Если у вас ещё нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы создать триггер для очереди сообщений:

1. Опишите в конфигурационном файле параметры триггера:

   • name — имя таймера. Формат имени:

     • Длина — от 3 до 63 символов.
     • Может содержать строчные буквы латинского алфавита, цифры и дефисы.
     • Первый символ — буква. Последний символ — не дефис.

   • description — описание триггера.

   • message_queue — параметры очереди сообщений:

     • queue_id — идентификатор очереди.

       Чтобы узнать идентификатор очереди:

       1. В консоли управления перейдите в каталог, в котором находится очередь.
       2. Выберите сервис Message Queue.
       3. Выберите очередь.
       4. Идентификатор очереди будет в блоке Общая информация, в поле ARN.

     • service_account_id — идентификатор сервисного аккаунта с правами на вызов функции.

     • batch_size — размер группы сообщений. Необязательный параметр. Допустимые значения от 1 до 10, значение по умолчанию — 1.

     • batch_cutoff — максимальное время ожидания. Необязательный параметр. Допустимые значения от 0 до 20 секунд, значение по умолчанию — 10 секунд. Таймер группирует сообщения не дольше batch-cutoff и отправляет их в функцию или контейнер. Число сообщений при этом не превышает batch-size.

   • function — настройки функции, которую будет запускать триггер:

     • id — идентификатор функции.

   Пример структуры конфигурационного файла:

   resource "yandex_function_trigger" "my_trigger" {
     name        = "<имя таймера>"
     description = "<описание триггера>"
     message_queue {
       queue_id           = "<идентификатор очереди>"
       service_account_id = "<идентификатор сервисного аккаунта>"
       batch_size         = "1"
       batch_cutoff       = "10"
     }
     function {
       id = "<идентификатор функции>"
     }
   }
   

   Более подробную информацию о параметрах ресурсов в Terraform см. в документации провайдера.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.

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

      yc serverless trigger get <идентификатор триггера>
      

Проверьте, что количество сообщений в очереди уменьшается. Для этого посмотрите статистику очереди:

1. В консоли управления выберите сервис Message Queue.
2. Выберите очередь, для которой создали триггер.
3. Перейдите в раздел Мониторинг. Посмотрите график Сообщений в очереди.