Добавить настройки масштабирования функции

Чтобы задать настройки масштабирования, выполните команду:

yc serverless function set-scaling-policy \
  --id=<идентификатор_функции> \
  --tag=\$latest \
  --zone-instances-limit=1 \
  --zone-requests-limit=2 \
  --provisioned-instances-count=3

Где:

• --id — идентификатор функции. Чтобы узнать его, получите список функций.
• --tag — тег версии функции.
• --zone-instances-limit — количество экземпляров функции.
• --zone-requests-limit — количество выполняемых вызовов.
• --provisioned-instances-count — количество подготовленных экземпляров.

Результат:

function_id: d4eokpuol55h********
tag: $latest
zone_instances_limit: "1"
zone_requests_limit: "2"
provisioned_instances_count: "3"

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

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

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

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

Чтобы добавить настройки масштабирования:

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

   • yandex_function — описание создаваемой функции и ее исходный код.
     • name — имя функции.
     • user_hash — произвольная строка, определяющая версию функции. При изменениях функции необходимо менять и эту строку. Функция обновится при изменении этой строки.
     • runtime — среда выполнения функции.
     • entrypoint — точка входа, указывается в формате <имя_файла_без_расширения>.<имя_обработчика>.
     • memory — объем памяти в мегабайтах, отведенный для выполнения функции.
     • execution_timeout — максимальное время выполнения функции до таймаута.
     • service_account_id — идентификатор сервисного аккаунта, от имени которого будет запускаться функция.
     • content — исходный код функции.
       • content.0.zip_filename — имя ZIP-архива, содержащего исходный код функции.
   • yandex_function_scaling_policy — описание настроек масштабирования функции.
     • function_id — идентификатор функции.
     • policy — настройки масштабирования:
       • policy.0.tag — тег версии функции.
       • policy.0.zone_instances_limit — количество экземпляров функции.
       • policy.0.zone_requests_limit — количество выполняемых вызовов.

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

   provider "yandex" {
       token     = "<OAuth-токен_или_статический_ключ_сервисного_аккаунта>"
       folder_id = "<идентификатор_каталога>"
       zone      = "ru-central1-a"
   }
   
   resource "yandex_function" "test-function" {
       name               = "<имя_функции>"
       user_hash          = "<хеш>"
       runtime            = "<среда_выполнения>"
       entrypoint         = "<точка_входа>"
       memory             = "128"
       execution_timeout  = "10"
       service_account_id = "<идентификатор_сервисного_аккаунта>"
       content {
           zip_filename = "<путь_к_ZIP-архиву>"
       }
   }
   
   resource "yandex_function_scaling_policy" "my_scaling_policy" {
       function_id = "<идентификатор_функции>"
       policy {
           tag = "$latest"
           zone_instances_limit = 2
           zone_requests_limit  = 1
       }
   }
   

   Подробнее о параметрах ресурсов см. yandex_function_scaling_policy.

2. Проверьте конфигурацию командой:

   terraform validate
   

   Если конфигурация является корректной, появится сообщение:

   Success! The configuration is valid.
   

3. Выполните команду:

   terraform plan
   

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

4. Примените изменения конфигурации:

   terraform apply
   

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

Проверить добавление настроек масштабирования можно в консоли управления или с помощью команды CLI:

yc serverless function list-scaling-policies <имя_или_идентификатор_функции>

Чтобы задать настройки масштабирования, воспользуйтесь методом REST API setScalingPolicy для ресурса Function или вызовом gRPC API FunctionService/SetScalingPolicy.