Документация

Правила ресурса

На вкладке Правила задаются настройки кэширования для определённых типов файлов или путей, отличные от настроек на вкладке Кэширование.

Правила применяются для кэширования потоковой трансляции видео, передаваемого по протоколу HLS. Протокол HLS работает по принципу разбиения цельного потока видео на небольшие фрагменты, последовательно скачиваемые по HTTP. Поток непрерывен и может быть бесконечным.

В начале сессии скачивается плейлист в формате m3u8, содержащий данные о видеосегментах с расширением .ts, а затем поочерёдно скачиваются файлы с видеосегментами. Файлы .ts называют «чанками» (chunks). В конечной точке доставки переданные файлы формируются в полноценный поток, доступный для воспроизведения.

Для ресурса можно создать до 5 правил. Если требуется больше правил, обратитесь в службу технической поддержки по адресу support@t1.cloud.

Создание правила для видеосегментов

Чтобы создать правило для видеосегментов:

  1. В контексте проекта перейдите на страницу подключенного CDN. На странице продукта отображается список ресурсов, созданных в контексте проекта.
  2. Выберите ресурс из списка и нажмите на кнопку .
  3. Откроется страница с настройками ресурса, перейдите на вкладку Правила. Вкладка содержит правила кэширования файлов ресурса:
  4. Нажмите на кнопку  и выберите, какое правило нужно создать:
  5. В открывшейся форме заполните поля:

    Протокол взаимодействия с источником — протокол, по которому CDN будет обращаться за контентом:

    • Наследовать с ресурса — если файлы доступны по протоколу, который выбран в основных настройках CDN-ресурса;
    • HTTP — если файлы доступны только по протоколу HTTP;
    • HTTPS — если файлы доступны только по протоколу HTTPS;
    • Как у клиента — протокол подключения определяется автоматически. Контент источника должен быть доступен для CDN по HTTP и HTTPS.

    Группа источников — группа источников, из которой CDN будет забирать контент:

    • Наследовать из настроек ресурса — если файлы доступны в группе источников, выбранной в основных настройках CDN-ресурса;
    • созданная группа источников — если нужно использовать группу источников, отличную от выбранной в основных настройках CDN-ресурса.

    Кэширование в CDN — если переключатель неактивирован, то для файлов, указанных в правиле, применяются настройки со вкладки Кэширование. Если переключатель активирован, то для файлов применяются параметры:

    Настройки — способ получения параметров кэширования:

    • Как у источника — CDN при запросе контента с сервера-источника кэширует контент на время, указанное в заголовке Cache-Control источника. Если на сервере-источнике отсутствует заголовок Cache-Control, CDN использует время хранения, указанное в поле Время жизни кэша по умолчанию, для кодов ответов 200, 201, 204, 206, 301, 302, 303, 304, 307, 308. Если требуется хранить кэш для запросов с другими кодами ответа или переопределить время хранения кэша для кодов ответов 200, 201, 204, 206, 301, 302, 303, 304, 307, 308, выберите Свои настройки;
    • Свои настройки — CDN-серверы запрашивают контент с источника и кэшируют его на время, заданное в правиле. При выборе данного значения появится возможность добавить HTTP-код ответа и выбрать для него время хранения кэша:

      Если для одного HTTP-кода ответа указано разное время в полях Время жизни кэша по умолчанию и Время жизни кэша для кода с ответами, то будет учитываться только Время жизни кэша для кода с ответами.

    Время жизни кэша по умолчанию — время хранения кэша для запросов с кодами ответов 200, 206, 301, 302. Коды ответов 4xx и 5xx кэшироваться не будут.

    Допустим, вы выбрали Свои настройки, в поле Время жизни кэша по умолчанию указали «4 дня» и выбрали время для двух HTTP-кодов ответа:

    В результате настроек запросы будут кэшироваться следующим образом:

    • запросы с кодом ответа 200 - 1 минута;
    • запросы с кодом ответа 404 - 10 минут;
    • запросы с кодом ответа 206, 301, 302 - 4 дня;
    • 4хх (кроме 404), 5хх - кэшироваться не будут.

    Важно

    Независимо от значения поля Время жизни кэша по умолчанию контент удаляется из кэша CDN-серверов через 36 часов, если он не запрашивается конечными пользователями.

    По умолчанию время кэширования файлов видеосегментов (.ts) - 1 минута. Такое значение кэширования превышает продолжительность чанка и помогает справиться с проблемой медленного интернет-соединения пользователей. Пользователи могут получить устаревший плейлист со списком чанков от CDN, хотя на источнике, возможно, лежит новый плейлист с новыми чанками. Если установлено время кэширования чанков менее 1 минуты, браузер пользователя отправит запрос на устаревший чанк из устаревшего плейлиста и получит код ответа 404, потому что на источнике такого файла уже нет.

  6. Нажмите на кнопку Создать.

Создание правила для плейлистов

Плейлист представляет собой список видеосегментов (чанков) для воспроизведения. При подключении пользователя к просмотру видеотрансляции HLS, видеоплеер периодически запрашивает плейлист, содержащий ссылки на видеосегменты, и загружает их через CDN-серверы. Таким образом пользователю воспроизводится закэшированный видеопоток из этого плейлиста.

Форма создания правила для плейлистов аналогична форме для видеосегментов.

По умолчанию время кэширования плейлистов (.m3u8) - 2 секунды. Если установлен короткий период кэширования, пользователи не будут получать плейлисты со старыми чанками из кэша.

Редактирование правил ресурса

Список правил ресурса:

У ресурса статус Активно могут иметь только одно правило для видеосегментов и одно правило для плейлистов. Если уже есть правило для плейлистов и видеосегментов со статусом Активно, то, чтобы создать новое, выключите или удалите правило кнопкой . Чтобы выключить существующее правило:

  1. Нажмите на кнопку Редактировать.
  2. Деактивируйте переключатель Включить правило.
  3. Нажмите на кнопку Сохранить. Статус правила изменится на Приостановлено.

При выключении правила кэширование осуществляется по настройкам, заданным на вкладке Кэширование.

У первого правила в списке наибольший приоритет. Если изменить последовательность правил, то изменится и их приоритет.

Действия над правилами

Редактирование правила

Чтобы отредактировать правило:

  1. В главном меню портала перейдите в раздел Ресурсы → Cloud CDN.
  2. Выберите ресурс и откройте вкладку Правила.
  3. В строке с правилом, которое нужно отредактировать, нажмите на кнопку Редактировать.
  4. Измените правило:

5. Нажмите на кнопку Сохранить.

Активирование правила

Чтобы активировать правило:

  1. В главном меню портала перейдите в раздел Ресурсы → Cloud CDN.
  2. Выберите ресурс и откройте вкладку Правила.
  3. В строке с правилом, которое нужно активировать, нажмите на кнопку Редактировать.
  4. Активируйте переключатель Включить правило.
  5. Нажмите на кнопку Сохранить.

Важно

При деактивация переключателя Включить правило кэширование будет происходить по общим настройкам, заданным для ресурса. 

Статус активированного правила — Активно, неактивированного — Приостановлено.

Удаление правила

Чтобы удалить правило:

  1. В главном меню портала перейдите в раздел Ресурсы → Cloud CDN.
  2. Выберите ресурс и откройте вкладку Правила.
  3. В строке с правилом, которое нужно удалить, нажмите на кнопку .
  4. Нажмите на кнопку Удалить.

В этой статье

Мы ответили на ваш вопрос?