Подключиться
Yandex Cloud Functions

Создание триггера для Yandex Container Registry

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

Создайте триггер для Container Registry, который будет вызывать функцию Cloud Functions при создании и удалении Docker-образов Yandex Container Registry или их тегов.

О том, как создать триггер для Container Registry, который будет вызывать контейнер, читайте в документации Yandex Serverless Containers.

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

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

  • Реестр, при событиях с Docker-образами в котором триггер будет запускаться. Если у вас нет реестра, создайте его.

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

Примечание

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

  1. В консоли управления перейдите в каталог, в котором хотите создать триггер.

  2. Выберите сервис Cloud Functions.

  3. На панели слева выберите Триггеры.

  4. Нажмите кнопку Создать триггер.

  5. В блоке Базовые параметры:

    • Введите имя и описание триггера.
    • В поле Тип выберите Container Registry.
    • В поле Запускаемый ресурс выберите Функция.

  6. В блоке Настройки Container Registry:

    • В поле Реестр выберите реестр, для событий с образами в котором необходимо создать триггер.
    • В поле Типы событий выберите события, после наступления которых триггер будет запускаться.
    • (опционально) В поле Имя Docker-образа введите имя образа для фильтрации. Чтобы узнать имя Docker-образа, получите список Docker-образов в реестре.
    • (опционально) В поле Тег Docker-образа введите тег образа для фильтрации.

  7. В блоке Настройки функции выберите функцию и укажите:

  8. (опционально) В блоке Настройки повторных запросов:

    • В поле Интервал укажите время, через которое будет сделан повторный вызов функции, если текущий завершился неуспешно. Допустимые значения — от 10 до 60 секунд, значение по умолчанию — 10 секунд.
    • В поле Количество попыток укажите количество повторных вызовов функции, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Допустимые значения — от 1 до 5, значение по умолчанию — 1.

  9. (опционально) В блоке Настройки Dead Letter Queue выберите очередь Dead Letter Queue и сервисный аккаунт с правами на запись в нее.

  10. Нажмите кнопку Создать триггер.

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

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

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

yc serverless trigger create container-registry \
  --name <имя триггера> \
  --registry-id <идентификатор реестра> \
  --events 'create-image', 'delete-image', 'create-image-tag', 'delete-image-tag' \
  --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 — идентификатор реестра.
  • --events — события, после наступления которых триггер запускается.
  • --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: a1s92agr8mpgeo3kjt48
folder_id: b1g88tflru0ek1omtsu0
created_at: "2020-09-08T06:26:22.651656Z"
name: registry-trigger
rule:
  container_registry:
    event_type:
    - CONTAINER_REGISTRY_EVENT_TYPE_CREATE_IMAGE
    - CONTAINER_REGISTRY_EVENT_TYPE_DELETE_IMAGE
    - CONTAINER_REGISTRY_EVENT_TYPE_CREATE_IMAGE_TAG
    - CONTAINER_REGISTRY_EVENT_TYPE_DELETE_IMAGE_TAG
    registry_id: crtlds4tdfg12kil77sdfg345ghj
    invoke_function:
      function_id: d4eofc7n0m03lmudsk7y
      function_tag: $latest
      service_account_id: aje3932acd0c5ur7drte
      retry_settings:
        retry_attempts: "1"
        interval: 10s
      dead_letter_queue:
        queue-id: yrn:yc:ymq:ru-central1:aoek49ghmknnpj1ll45e:dlq
        service-account-id: aje3932acd0c5ur7dagp
status: ACTIVE

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

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

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

Что дальше

В этой статье: