Создание ресурса

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

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

1. Если вы создаете первый ресурс, сначала подключитесь к провайдеру:

   yc cdn provider activate --type gcore
   

2. Посмотрите описание команды CLI для создания ресурсов:

   yc cdn resource create --help
   

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

   yc cdn origin-group list --format yaml
   

   Результат:

   - id: "90209"
     folder_id: somefolder7p3l5eobbd
     name: test-group-1
     use_next: true
     origins:
     - id: "561547"
       origin_group_id: "90209"
       source: www.example2.com
       enabled: true
       backup: true
     - id: "561546"
       origin_group_id: "90209"
       source: www.example1.com
       enabled: true
   - id: "90208"
     folder_id: b1g86q4m5vej8lkljme5
     name: test-group
     use_next: true
     origins:
     - id: "561545"
       origin_group_id: "90208"
       source: www.a2.com
       enabled: true
       backup: true
     - id: "561544"
       origin_group_id: "90208"
       source: www.a1.com
       enabled: true
   

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

   yc cdn resource create <доменное имя ресурса> \
     --origin-group-id <идентификатор группы источников> \
     --origin-protocol <протокол для источников>
   

   • Вместо группы источников --origin-group-id можно указать доменное имя источника, используя флаг --origin-custom-source.
   • Для --origin-protocol доступны значения HTTP, HTTPS и MATCH (как у клиента).

   Подробнее о команде yc cdn resource create см. в справочнике CLI.

Поставщик CDN должен быть активирован до использования ресурсов CDN. Сделать это можно в консоли управления или с помощью команды YC CLI:

yc cdn provider activate --folder-id <идентификатор каталога> --type gcore

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

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

   • cname — основное доменное имя для раздачи контента. Обязательный параметр.
   • active — флаг, указывающий на доступ к контенту для конечных пользователей. True — контент из CDN будет доступен клиентам. Необязательный параметр, значение по умолчанию: true.
   • origin_protocol — протокол для источников. Необязательный параметр, значение по умолчанию: http.
   • secondary_hostnames — дополнительные доменные имена. Необязательный параметр.
   • origin_group_id — идентификатор группы источников. Обязательный параметр. Используйте идентификатор из описания группы источников в ресурсе yandex_cdn_origin_group.

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

   terraform {
     required_providers {
       yandex = {
         source  = "yandex-cloud/yandex"
         version = "0.69.0"
       }
     }
   }
   
   provider "yandex" {
     token     = "<OAuth>"
     cloud_id  = "<идентификатор облака>"
     folder_id = "<идентификатор каталога>"
     zone      = "<зона доступности>"
   }
   
   resource "yandex_cdn_resource" "my_resource" {
       cname               = "cdn1.yandex-example.ru"
       active              = false
       origin_protocol     = "https"
       secondary_hostnames = ["cdn-example-1.yandex.ru", "cdn-example-2.yandex.ru"]
       origin_group_id     = yandex_cdn_origin_group.my_group.id
   }
   

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

2. В командной строке перейдите в папку, где расположен конфигурационный файл Terraform.

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

   terraform validate
   

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

   Success! The configuration is valid.
   

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

   terraform plan
   

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

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

   terraform apply
   

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

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

   yc cdn resource list