Настроить локационные правила Yandex Cloud CDN
Локационные правила — это механизм точечного переопределения настроек CDN-ресурса для запросов, пути которых соответствуют заданному шаблону.
Например, в настройках CDN-ресурса включено кеширование контента, а время жизни кеша составляет 4 дня. Для большей части контента этого достаточно, однако для некоторых специфичных файлов нужно уменьшить время жизни кеша до нескольких секунд. Для решения подобных задач применяются локационные правила.
Подробнее о локационных правилах
Чтобы настроить локационное правило:
Создать локационное правило
-
В консоли управления выберите каталог, в котором расположен ресурс.
-
Перейдите в сервис Cloud CDN.
-
Нажмите на имя нужного CDN-ресурса.
-
Выберите вкладку Локационные правила.
-
В правом верхнем углу нажмите Добавить правило.
-
В блоке Обзор задайте основные параметры локационного правила:
-
Имя.
В имени правила можно использовать строчные латинские буквы, цифры, подчеркивание, дефис и пробел; максимальная длина — 50 символов.
-
Вес правила — приоритет срабатывания правила. Чем меньше вес правила, тем выше его приоритет в конфигурации ресурса пользователя. Если у нескольких правил будет одинаковый вес, то они будут применяться в произвольном порядке.
Например, задаются следующие локационные правила:
Правило Вес Регулярное выражение Время жизни кеша А 1^/path/.+1 часБ 2\.txt$4 часаПри такой конфигурации запрос
/path/file.txtбудет попадать под правило А (меньше вес — выше приоритет) и не доходить до правила Б, поэтому файл будет закеширован на 1 час.Чтобы закешировать файл
/path/file.txtна 4 часа, вес правила Б должен быть меньше веса правила А.
-
-
В блоке Условие применения задайте Регулярное выражение — шаблон пути URI, на соответствие которому проверяются запросы. При успешном совпадении применяются настройки, специфичные именно для этого локационного правила.
Совет
Чтобы в регулярном выражении явно обозначить начало или конец строки, по которым должно быть совпадение, используйте якорные символы
^и$. -
Задайте настройки CDN-ресурса, которые вы хотите переопределить с помощью локационного правила:
- Кеширование в CDN — временное хранение копий файлов из источников. Подробнее на странице Настройка кеширования ресурса.
- Перенаправление запросов — перенастройка пути запросов к контенту. Полезно при изменении структуры файлов и папок на источнике. Кроме того, перенаправление запросов можно использовать, если при переезде ресурса на новый адрес вы хотите сохранить ранжирование вашего контента в поисковых системах. Подробнее на странице Настройка перенаправления запросов.
- Доступ по защищённому токену — ограничение прямого доступа к контенту. Доступ к файлам будет осуществляться по подписанным ссылкам с ограниченным сроком действия. Подробнее на странице Настройка доступа по защищенному токену.
- Доступ по IP-адресам — ограничение доступа к контенту с помощью разрешающей или блокирующей политики. Подробнее на странице Изменение основных настроек ресурса.
Примечание
Настройки HTTP-заголовков и методов, CORS, сжатия и сегментации контента, а также дополнительных параметров кеширования контента доступны после создания локационного правила. Подробнее в разделе Задать дополнительные параметры.
-
Нажмите Создать.
Воспользуйтесь методом REST API create для ресурса ResourceRules или вызовом gRPC API ResourceRulesService/Create.
Задать дополнительные параметры
После создания правила вы можете задать для него дополнительные параметры:
-
В консоли управления выберите каталог, в котором расположен ресурс.
-
Перейдите в сервис Cloud CDN.
-
Нажмите на имя нужного CDN-ресурса.
-
Выберите вкладку Локационные правила.
-
Нажмите на имя нужного локационного правила.
-
Задайте дополнительные параметры правила:
- Чтобы настроить дополнительные параметры кеширования контента, перейдите на вкладку Кеширование и нажмите Редактировать. Подробнее на странице Настройка кеширования ресурса.
- Чтобы настроить HTTP-заголовки запросов и ответов, CORS при ответах клиентам и разрешенные HTTP-методы запросов от клиентов, перейдите на вкладку HTTP-заголовки и методы и нажмите Редактировать. Подробнее на страницах:
- Чтобы настроить сжатие и сегментацию файлов, перейдите на вкладку Контент и нажмите Редактировать. Подробнее на страницах:
Отредактируйте параметры на нужной вкладке и нажмите Сохранить.
Воспользуйтесь методом REST API update для ресурса ResourceRules или вызовом gRPC API ResourceRulesService/Update.