Создание навыка Алисы с помощью Terraform

Чтобы создать навык Алисы с помощью Terraform:

1. Подготовьте облако к работе.
2. Подготовьте код навыка.
3. Создайте инфраструктуру.
4. Добавьте ссылку на функцию в навык Алисы.
5. Протестируйте работу навыка.

Если созданные ресурсы вам больше не нужны, удалите их.

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

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

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

Подробнее об облаках и каталогах.

Подготовьте код для навыка АлисыПодготовьте код для навыка Алисы

Для создания версии функции вы можете воспользоваться одним из форматов загрузки кода. Для примера код будет загружен в формате ZIP-архива.

Создайте инфраструктуруСоздайте инфраструктуру

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

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

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

Чтобы создать инфраструктуру с помощью Terraform:

1. Установите Terraform, получите данные для аутентификации и укажите источник для установки провайдера Yandex Cloud (раздел Настройте провайдер, шаг 1).

2. Подготовьте файл с описанием инфраструктуры:

   Готовая конфигурация

   Вручную

   1. Склонируйте репозиторий с конфигурационными файлами:

      git clone https://github.com/yandex-cloud-examples/yc-serverless-alice-skill
      

   2. Перейдите в директорию с репозиторием. В ней должны появиться файлы:

      • alice-skill.tf — конфигурация создаваемой инфраструктуры.
      • alice-skill.auto.tfvars — пользовательские данные.

   1. Создайте папку для файла с описанием инфраструктуры.

   2. Создайте в папке конфигурационный файл alice-skill.tf:

      alice-skill.tf

      # Объявление переменных
      
      variable "folder_id" {
        type = string
      }
      
      variable "file_path" {
        type = string
      }
      
      variable "language" {
        type = string
      }
      
      # Настройка провайдера
      
      terraform {
        required_providers {
          yandex = {
            source = "yandex-cloud/yandex"
          }
        }
        required_version = ">= 0.13"
      }
      
      provider "yandex" {
        folder_id = var.folder_id
      }
      
      # Создание функции и версии функции
      
      resource "yandex_function" "alice_parrot" {
        name               = "alice-parrot"
        description        = "Yandex Alice skill: Parrot (repeats user input)"
        runtime            = var.language == "python" ? "python314" : "nodejs22"
        entrypoint         = var.language == "python" ? "parrot.handler" : "index.handler"
        memory             = 128
        execution_timeout  = 2
      
        content {
          zip_filename = var.file_path
        }
      
        user_hash = filesha256(var.file_path)
      }
      

   3. Создайте в папке файл с пользовательскими данными alice-skill.auto.tfvars:

      alice-skill.auto.tfvars

      folder_id         = "<идентификатор_каталога>"
      file_path         = "<локальный_путь_к_архиву_с_кодом_функции>"
      language          = "<язык_программирования>"
      

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

3. В файле alice-skill.auto.tfvars задайте пользовательские параметры:

   • folder_id — идентификатор каталога.

   • file_path — локальный путь к файлу с архивом, содержащим код функции. Например: /Users/myuser/Temp/parrot-py.zip.

   • language — в зависимости от используемого в коде функции языка программирования укажите:

     • python — если вы используете пример на Python;
     • nodejs — если вы используете пример на Node.js.

4. Создайте ресурсы:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

Добавьте ссылку на функцию в навык АлисыДобавьте ссылку на функцию в навык Алисы

Протестируйте работу навыкаПротестируйте работу навыка

Как удалить созданные ресурсыКак удалить созданные ресурсы

Чтобы перестать платить за созданные ресурсы:

1. Откройте конфигурационный файл alice-skill.tf и удалите описание создаваемой инфраструктуры из файла.

2. Примените изменения:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

Полезные ссылкиПолезные ссылки

• Создание навыка Алисы в консоли управления, с помощью Yandex Cloud CLI или API