Создание триггера для бюджетов, который вызывает функцию Cloud Functions для остановки ВМ

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Создайте сервисный аккаунт service-account-for-budget:

   yc iam service-account create --name service-account-for-budget
   

   Результат:

   id: ajersamh4sjq********
   folder_id: b1gc1t4cb638********
   created_at: "2022-12-07T10:36:29.726397755Z"
   name: service-account-for-budget
   

2. Получите список каталогов в облаке:

   yc resource-manager folder list
   

   Результат:

   +----------------------+----------------------+--------+--------+
   |          ID          |         NAME         | LABELS | STATUS |
   +----------------------+----------------------+--------+--------+
   | b1gp7arme3nn******** | my-folder            |        | ACTIVE |
   | b1g0itj57rbj******** | test-folder          |        | ACTIVE |
   +----------------------+----------------------+--------+--------+
   

   Сохраните идентификатор каталога, в котором хотите создать сервисный аккаунт.

3. Получите список сервисных аккаунтов в каталоге:

   yc iam service-account list
   

   Результат:

   +----------------------+------------------------------+
   |          ID          |             NAME             |
   +----------------------+------------------------------+
   | aje07l4q4vmo******** | test-sa                      |
   | ajersamh4sjq******** | service-account-for-budget   |
   +----------------------+------------------------------+
   

   Сохраните идентификатор сервисного аккаунта service-account-for-budget.

4. Назначьте сервисному аккаунту роли compute.admin, iam.serviceAccounts.user и functions.functionInvoker на каталог:

   yc resource-manager folder add-access-binding <идентификатор_каталога> \
      --role compute.admin \
      --subject serviceAccount:<идентификатор_сервисного_аккаунта>
   
   yc resource-manager folder add-access-binding <идентификатор_каталога> \
      --role iam.serviceAccounts.user \
      --subject serviceAccount:<идентификатор_сервисного_аккаунта>
   
   yc resource-manager folder add-access-binding <идентификатор_каталога> \
      --role functions.functionInvoker \
      --subject serviceAccount:<идентификатор_сервисного_аккаунта>
   

   Результат:

   done (1s)
   

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

Чтобы назначить сервисному аккаунта роли compute.admin, iam.serviceAccounts.user и functions.functionInvoker на каталог, воспользуйтесь методом setAccessBindings для ресурса ServiceAccount.

1. Создайте функцию function-for-budget:

   yc serverless function create --name function-for-budget
   

   Результат:

   done (1s)
   id: d4eiqjdbqt7s********
   folder_id: b1gc1t4cb638********
   created_at: "2022-12-07T10:44:13.156Z"
   name: function-for-budget
   log_group_id: ckg6bie2rtgd********
   http_invoke_url: https://functions.yandexcloud.net/d4eiqjdbqt7s********
   status: ACTIVE
   

2. Создайте версию функции function-for-budget:

   yc serverless function version create \
     --function-name function-for-budget \
     --memory=512m \
     --execution-timeout=5s \
     --runtime=golang119 \
     --entrypoint=index.StopComputeInstances \
     --service-account-id=<идентификатор_сервисного_аккаунта> \
     --environment FOLDER_ID=<идентификатор_каталога> \
     --environment TAG=target-for-stop \
     --source-path=./src.zip
   

   Где:

   • --function-name — имя функции, версия которой создается.
   • --memory — объем RAM.
   • --execution-timeout — максимальное время выполнения функции до достижения таймаута.
   • --runtime — среда выполнения.
   • --entrypoint — точка входа.
   • --service-account-id — идентификатор сервисного аккаунта service-account-for-budget.
   • --environment — переменные окружения. FOLDER_ID — идентификатор каталога, в котором вы хотите останавливать виртуальные машины.
   • --source-path — путь до ZIP-архива src.zip.

   Результат:

   done (2m7s)
   id: d4ev38dddr41********
   function_id: d4eiqjdbqt7s********
   created_at: "2022-12-07T11:14:07.802Z"
   runtime: golang119
   entrypoint: index.StopComputeInstances
   resources:
     memory: "536870912"
   execution_timeout: 5s
   service_account_id: ajersamh4sjq********
   image_size: "19587072"
   status: ACTIVE
   tags:
     - $latest
   log_group_id: ckg6bie2rtgd********
   environment:
     FOLDER_ID: b1gc1t4cb638********
     TAG: target-for-stop
   log_options:
     folder_id: b1gc1t4cb638********
   

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

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

Чтобы создать бюджет, воспользуйтесь методом create для ресурса Budget или вызовом gRPC API BudgetService/Create.

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

yc serverless trigger create billing-budget \
  --name vm-stop-trigger \
  --billing-account-id <идентификатор_платежного_аккаунта> \
  --budget-id <идентификатор_бюджета> \
  --invoke-function-id <идентификатор_функции> \
  --invoke-function-service-account-id <идентификатор_сервисного_аккаунта>

Где:

• --name — имя триггера.
• --billing-account-id — идентификатор платежного аккаунта.
• --budget-id — идентификатор бюджета vm-budget.
• --invoke-function-id — идентификатор функции function-for-budget.
• --invoke-function-service-account-id — идентификатор сервисного аккаунта service-account-for-budget.

Результат:

id: a1sfe084v4**********
folder_id: b1g88tflru**********
created_at: "2022-12-04T08:45:31.131391Z"
name: vm-stop-trigger
rule:
  billing-budget:
    billing-account-id: dn2char50j**********
    budget-id: dn2jnshmdlc1********
    invoke_function:
      function_id: d4eofc7n0m03********
      function_tag: $latest
      service_account_id: aje3932acd0c********
status: ACTIVE

Чтобы создать триггер для бюджетов, воспользуйтесь методом create для ресурса Trigger.

Чтобы создать виртуальную машину, воспользуйтесь методом create для ресурса Instance.