Создание таймера
Создайте таймер — триггер, который будет вызывать функцию Cloud Functions или контейнер Serverless Containers по расписанию.
Перед началом работы
Для создания триггера вам понадобятся:
-
Функция или контейнер, которые триггер будет запускать.
-
Если у вас нет функции:
-
Если у вас нет контейнера:
-
-
(опционально) Очередь Dead Letter Queue, куда будут перенаправляться сообщения, которые не смогли обработать функция или контейнер. Если у вас нет очереди, создайте ее.
-
Сервисные аккаунты с правами на вызов функции или контейнера и (опционально) запись в очередь Dead Letter Queue. Вы можете использовать один и тот же сервисный аккаунт или разные. Если у вас нет сервисного аккаунта, создайте его.
Создать триггер
Примечание
Триггер начинает работать в течение 5 минут после создания.
-
В консоли управления перейдите в каталог, в котором хотите создать триггер.
-
Откройте сервис Cloud Functions.
-
На панели слева выберите Триггеры.
-
Нажмите кнопку Создать триггер.
-
В блоке Базовые параметры:
- Введите имя и описание триггера.
- В поле Тип выберите Таймер.
- Выберите, что будет запускать триггер — функцию или контейнер.
-
В блоке Настройки таймера укажите расписание вызова функции или контейнера в формате cron-выражения.
-
Если триггер будет запускать:
-
функцию, в блоке Настройки функции выберите ее и укажите:
- тег версии функции;
- сервисный аккаунт, от имени которого будет вызываться функция.
-
контейнер, в блоке Настройки контейнера выберите его и укажите:
- ревизию контейнера;
- сервисный аккаунт, от имени которого будет вызываться контейнер.
-
-
(опционально) В блоке Настройки повторных запросов:
- В поле Интервал укажите время, через которое будет сделан повторный вызов функции или контейнера, если текущий завершился неуспешно. Допустимые значения — от 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 timer \
--name <имя таймера> \
--cron-expression '<cron-выражение>' \
--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
— имя таймера.--cron-expression
— расписание вызова функции в формате cron-выражения.--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: a1sfe084v4se4morbu2i
folder_id: b1g88tflru0ek1omtsu0
created_at: "2019-12-04T08:45:31.131391Z"
name: timer
rule:
timer:
cron_expression: 5 12 * * ? *
invoke_function_with_retry:
function_id: d4eofc7n0m03lmudse8l
function_tag: $latest
service_account_id: aje3932acd0c5ur7dagp
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
Создать таймер можно с помощью метода API create.
Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). Terraform и его провайдеры распространяются под лицензией Mozilla Public License.
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.
При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.
Если у вас ещё нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы создать триггер, который запускает функцию:
-
Опишите в конфигурационном файле параметры триггера:
-
name
— имя таймера. Формат имени:- Длина — от 3 до 63 символов.
- Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Первый символ — буква. Последний символ — не дефис.
-
description
— описание триггера. -
timer
— настройки триггера:cron_expression
— расписание вызова функции в формате cron-выражения.
-
function
— настройки функции, которую будет запускать триггер:id
— идентификатор функции.
Пример структуры конфигурационного файла:
resource "yandex_function_trigger" "my_trigger" { name = "<имя таймера>" description = "<описание триггера>" timer { cron_expression = "* * * * ? *" } function { id = "<идентификатор функции>" } }
Более подробную информацию о параметрах ресурсов в Terraform см. в документации провайдера.
-
-
Проверьте корректность конфигурационных файлов.
-
В командной строке перейдите в папку, где вы создали конфигурационный файл.
-
Выполните проверку с помощью команды:
terraform plan
Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
-
-
Разверните облачные ресурсы.
-
Если в конфигурации нет ошибок, выполните команду:
terraform apply
-
Подтвердите создание ресурсов: введите в терминал слово
yes
и нажмите Enter.После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления или с помощью команд CLI:
yc serverless trigger get <идентификатор триггера>
-
Проверить результат
Проверьте, что триггер работает корректно. Для этого посмотрите логи функции или логи контейнера, в них отображается информация о вызовах.