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

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

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

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

   yc cdn resource create --help
   

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

   yc cdn origin-group list --format yaml
   

   Результат:

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

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

   Чтобы настроить TLS-сертификат для CDN-ресурса, используйте параметры:

   • --dont-use-ssl-cert — не использовать сертификат. Ресурс будет доступен только по протоколу HTTP.

   • --cert-manager-ssl-cert-id — идентификатор сертификата. Ресурс будет доступен по протоколам HTTP и HTTPS.

     Поддерживаются сертификаты из Yandex Certificate Manager. Вы можете выпустить новый сертификат Let's Encrypt® или загрузить собственный.

     Сертификат должен находиться в том же каталоге, в котором расположен ваш CDN-ресурс.

   Чтобы включить перенаправление запросов на CDN-ресурсе, используйте параметры:

   • --rewrite-body – правило Rewrite. Например: --rewrite-body '/(.*) /new-folder/$1'.

     Правило Rewrite должно содержать две разделенные пробелом директивы: исходный путь, который требуется заменить, и измененный путь — то, на что меняется исходный путь.

     В правиле вы можете использовать регулярные выражения.

     Подробнее см. в разделе Правило Rewrite.

   • --rewrite-flag – флаг. Возможные значения:

     • break — завершает обработку текущего набора директив.
     • last — завершает обработку текущего набора директив и начинает поиск нового CDN-сервера, соответствующего новому URI.
     • redirect — возвращает пользователю временный redirect с кодом 302. Флаг используется, если заменяющая строка не начинается с http://, https:// или $scheme.
     • permanent — возвращает пользователю постоянный redirect с кодом 301.

   • Чтобы добавить метки, используйте параметр --add-labels. Например: --add-labels key1=value1.

   Если вы хотите ограничить доступ к контенту ресурса с помощью защищенных токенов используйте параметры:

   • --secure-key — секретный ключ — произвольная строка длиной от 6 до 32 символов.
   • --enable-ip-url-signing — (опционально) параметр, который включает ограничение доступа к CDN-ресурсу по IP-адресу. Сам доверенный IP-адрес задается вне CDN-ресурса и указывается в качестве параметра при формировании MD5-хэша для подписанной ссылки. Если параметр не задан, доступ к файлам будет разрешен с любых IP-адресов.

   См. также Настройка доступа по защищенному токену.

   Если вы хотите ограничить доступ к контенту ресурса с помощью политики доступа по IP-адресам, используйте параметры:

   • --acl-excepted-values — IP-адрес, для которого будет разрешен или запрещен доступ к контенту. Для адреса укажите префикс подсети в нотации CIDR, например: 192.168.3.2/32 или 2a03:d000:2980:7::8/128.

     В параметре --acl-excepted-values можно передать только один IP-адрес. Чтобы передать больше адресов, задайте параметр --acl-excepted-values несколько раз.

   • --policy-type — тип политики. Возможные значения:

     • allow — разрешающая политика. Доступ к контенту ресурса будет разрешен для любых IP-адресов, кроме адресов, заданных в параметре --acl-excepted-values.
     • deny — блокирующая политика. Доступ к контенту ресурса будет запрещен для любых IP-адресов, кроме адресов, заданных в параметре --acl-excepted-values.

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

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

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

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

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

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

   resource "yandex_cdn_resource" "my_resource" {
       cname               = "<имя_домена>"
       active              = true
       origin_protocol     = "https"
       origin_group_id     = <идентификатор_группы_источников>
       secondary_hostnames = ["<дополнительное_доменное_имя_1>", "дополнительное_доменное_имя_2"]
       provider_type       = "<CDN-провайдер>"
       ssl_certificate {
         type = "certificate_manager"
         certificate_manager_id = "<идентификатор_сертификата>"
       }
       options {
         redirect_http_to_https = true
         secure_key             = "<секретный_ключ>"
         enable_ip_url_signing  = true
         ip_address_acl {
           excepted_values = ["<IP-адрес_1>", "<IP-адрес_2>", ..., "<IP-адрес_n>"]
           policy_type     = "<тип_политики>"
         }
       }
   }
   

   Где:

   • cname — основное доменное имя для раздачи контента. Обязательный параметр.

   • active — флаг, указывающий на доступ к контенту для конечных пользователей: true — контент из CDN доступен клиентам, false — доступ к контенту отключен. Значение по умолчанию: true. Необязательный параметр.

   • origin_protocol — протокол для источников. Значение по умолчанию: http. Необязательный параметр.

   • origin_group_id — идентификатор группы источников. Обязательный параметр. Используйте идентификатор из описания группы источников в ресурсе yandex_cdn_origin_group.

   • secondary_hostnames — дополнительные доменные имена. Необязательный параметр.

   • provider_type — провайдер CDN, должен совпадать с провайдером CDN у группы источников. Необязательный параметр. Возможные значения:

     • ourcdn (значение по умолчанию) — провайдер Yandex Cloud CDN.

     • gcore — EdgeCDN-провайдер.

       Важно

       При создании каждого CDN-ресурса и каждой группы источников за ними закрепляется конкретный провайдер. Изменить закрепленного провайдера нельзя.

   • ssl_certificate — параметры SSL-сертификата. Необязательный параметр. Возможные значения:

     • type — тип сертификата:

       • not_used — без сертификата. Значение по умолчанию.

       • certificate_manager — пользовательский сертификат. Укажите идентификатор сертификата в параметре certificate_manager_id.

         Поддерживаются сертификаты из Yandex Certificate Manager. Вы можете выпустить новый сертификат Let's Encrypt® или загрузить собственный.

         Сертификат должен находиться в том же каталоге, в котором расположен ваш CDN-ресурс.

     • certificate_manager_id — идентификатор пользовательского сертификата в Certificate Manager.

   • options — дополнительные параметры CDN-ресурса. Необязательный параметр. Возможные значения:

     • redirect_http_to_https — параметр для переадресации клиентов с HTTP на HTTPS, возможные значения: true или false. Доступно при использовании SSL-сертификата.

     • secure_key — секретный ключ. Произвольная строка длиной от 6 до 32 символов. Необходим, чтобы ограничить доступ к ресурсу с помощью защищенных токенов.

     • enable_ip_url_signing — опциональный параметр, который включает ограничение доступа к CDN-ресурсу по IP-адресу с помощью защищенных токенов. Сам доверенный IP-адрес задается вне CDN-ресурса и указывается в качестве параметра при формировании MD5-хэша для подписанной ссылки. Если параметр не задан, доступ к файлам будет разрешен с любых IP-адресов.

     • ip_address_acl — параметры политики доступа по IP-адресам:

       • excepted_values — список IP-адресов, для которых будет разрешен или запрещен доступ к контенту ресурса. IP-адреса указываются через запятую. Для каждого адреса укажите префикс подсети в нотации CIDR, например: 192.168.3.2/32 или 2a03:d000:2980:7::8/128.

       • policy_type — тип политики. Возможные значения:

         • allow — разрешающая политика. Доступ к контенту ресурса будет разрешен для любых IP-адресов, кроме адресов, заданных в параметре ip_address_acl.excepted_values.
         • deny — блокирующая политика. Доступ к контенту ресурса будет запрещен для любых IP-адресов, кроме адресов, заданных в параметре ip_address_acl.excepted_values.

     Примечание

     Если в конфигурационном файле удалить параметры secure_key и ip_address_acl, эти опции не отключатся автоматически. Чтобы отключить опции secure_key и ip_address_acl, используйте CLI или API.

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

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

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

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

   yc cdn resource list
   

Воспользуйтесь методом REST API create для ресурса Resource или вызовом gRPC API ResourceService/Create.

Вы можете ограничить доступ к ресурсу с помощью защищенных токенов и политики доступа по IP-адресам.