Подключение группы источников к ресурсу

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

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

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

   yc cdn resource create --help
   

2. Получите список всех групп источников в каталоге по умолчанию:

   yc cdn origin-group list --format yaml
   

   Результат:

   - id: "90209"
     folder_id: b1g86q4m5vej********
     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: b1g86q4m5vej********
     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
   

3. Создайте ресурс с подключенной группой источников:

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

   Где:

   • --origin-group-id — идентификатор группы источников.
   • --origin-protocol — протокол для источников.

   Результат:

   id: bc855oumelrq********
   folder_id: b1g86q4m5vej********
   cname: res1.example.com
   created_at: "2022-01-15T15:13:42.827643Z"
   updated_at: "2022-01-15T15:13:42.827671Z"
   active: true
   options:
     edge_cache_settings:
       enabled: true
       default_value: "345600"
     cache_http_headers:
       value:
       - accept-ranges
       - cache-control
       - connection
       - content-encoding
       - content-length
       - content-type
       - date
       - etag
       - expires
       - keep-alive
       - last-modified
       - server
       - vary
     stale:
       enabled: true
       value:
       - error
       - updating
     allowed_http_methods:
       value:
       - GET
       - POST
       - HEAD
       - OPTIONS
   origin_group_id: "90208"
   origin_group_name: test-group-22
   origin_protocol: HTTPS
   ssl_certificate:
     type: DONT_USE
     status: READY
   

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

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

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

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

   provider "yandex" {
     token     = "<OAuth-токен>"
     cloud_id  = "<идентификатор_облака>"
     folder_id = "<идентификатор_каталога>"
     zone      = "<зона_доступности_по_умолчанию>"
   }
   
   resource "yandex_cdn_resource" "my_resource" {
     cname = "<доменное_имя_ресурса>"
     active = true
     origin_protocol = "https"
      origin_group_id = <идентификатор_группы_источников>
   }
   

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

2. Проверьте корректность настроек.

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

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

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

3. Создайте группу источников.

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

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

Чтобы подключить группу источников при создании ресурса, воспользуйтесь методом REST API create для ресурса Resource или вызовом gRPC API ResourceService/Create.

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

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

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

   yc cdn resource update --help
   

2. Получите список всех ресурсов в каталоге по умолчанию:

   yc cdn resource list --format yaml
   

   Результат:

   - id: bc82xll34xuc********
     folder_id: b1g86q4m5vej********
     cname: res1.example.com
     created_at: "2022-01-21T08:17:48.850086Z"
     updated_at: "2022-01-21T08:17:48.850125Z"
     active: true
     options:
       edge_cache_settings:
         enabled: true
         default_value: "345600"
       cache_http_headers:
         value:
         - accept-ranges
         - cache-control
         - connection
         - content-encoding
         - content-length
         - content-type
         - date
         - etag
         - expires
         - keep-alive
         - last-modified
         - server
         - vary
       stale:
         enabled: true
         value:
         - error
         - updating
       allowed_http_methods:
         value:
         - GET
         - POST
         - HEAD
         - OPTIONS
     origin_group_id: "90208"
     origin_group_name: test-group
     origin_protocol: HTTPS
     ssl_certificate:
       type: DONT_USE
       status: READY
   

3. Получите список всех групп источников в каталоге по умолчанию и выберите идентификатор (ID) нужной группы:

   yc cdn origin-group list --format yaml
   

   Результат:

   - id: "90209"
     folder_id: b1g86q4m5vej********
     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: b1g86q4m5vej********
     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 update \
     --id <идентификатор_ресурса> \
     --origin-group-id <идентификатор_группы_источников>
   

   Результат:

   id: bc8krsk72icw********
   folder_id: b1g86q4m5vej********
   cname: res2.example.com
   created_at: "2022-01-15T15:29:19.103653Z"
   updated_at: "2022-01-15T15:33:22.819916Z"
   active: true
   options:
     edge_cache_settings:
       enabled: true
       default_value: "345600"
     cache_http_headers:
       value:
       - accept-ranges
       - cache-control
       - connection
       - content-encoding
       - content-length
       - content-type
       - date
       - etag
       - expires
       - keep-alive
       - last-modified
       - server
       - vary
     stale:
       enabled: true
       value:
       - error
       - updating
     allowed_http_methods:
       value:
       - GET
       - POST
       - HEAD
       - OPTIONS
   origin_group_id: "90209"
   origin_group_name: test-group-1
   origin_protocol: HTTPS
   ssl_certificate:
     type: DONT_USE
     status: READY
   

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

Чтобы подключить группу источников при изменении настроек ресурса, воспользуйтесь методом REST API update для ресурса Resource или вызовом gRPC API ResourceService/Update.