Очистка кэша в Azure Front Door с помощью Azure CLI

  • Статья

Azure Front Door кэширует ресурсы до истечения их срока жизни. Всякий раз, когда клиент запрашивает ресурс с истекшим сроком жизни, среда Azure Front Door получает новую обновленную копию ресурса для выполнения запроса, а затем сохраняет обновленный кэш.

Мы рекомендуем всегда убеждаться в том, что ваши пользователи получают последнюю копию ресурсов. Для этого версионируйте ресурсы при каждом обновлении и публикуйте их как новые URL-адреса. Azure Front Door уровня "Стандартный" или "Премиум" будет незамедлительно получать ресурсы для следующих клиентских запросов. Иногда может потребоваться очистить кэшированное содержимое со всех пограничных узлов и сделать так, чтобы узлы получили новые обновленные ресурсы. Поводом для очистки кэшированного содержимого может быть внесение новых обновлений в приложение или обновление ресурсов, содержащих неверные данные.

Предварительные требования

  • Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье Краткое руководство по Bash в Azure Cloud Shell.

  • Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в разделе Запуск Azure CLI в контейнере Docker.

    • Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, приведены в статье Вход с помощью Azure CLI.

    • Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.

    • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Настройка очистки кэша

Выполните команду az afd endpoint purge для очистки кэша после ввода необходимых параметров, например:

  • имя группы ресурсов

  • Имя профиля Azure Front Door в группе ресурсов с ресурсами, которые требуется очистить

  • Конечные точки с ресурсами, которые требуется очистить

  • Домены или поддомены с ресурсами, которые требуется очистить

    Важно!

    Очистка кэша для доменов с подстановочными знаками не поддерживается. Необходимо указать поддомен для очистки кэша для домена с подстановочными знаками. Можно добавить неограниченное количество одноуровневых поддоменов домена с подстановочным знаком. Например, для домена *.afdxgatest.azfdtest.xyz с подстановочными знаками можно добавить поддомены в виде contoso.afdxgatest.azfdtest.xyz или cart.afdxgatest.azfdtest.xyz и т. д. Дополнительные сведения см. в разделе Домены-шаблоны в Azure Front Door.

  • Путь к содержимому для очистки.

    • В списках путей для очистки можно использовать следующие форматы.
      • Очистка одного пути. Удаление отдельных ресурсов путем указания полного пути (без протокола и домена) с расширением файла, например /pictures/strasbourg.png.
      • Очистка корневого домена. Очищает содержимое в корне конечной точки, в пути которой есть знак "/*".
az afd endpoint purge \
   --resource-group myRGFD \
   --profile-name contosoafd \
   --endpoint-name myendpoint \
   --domains www.contoso.com \
   --content-paths '/scripts/*'

При очистке в профиле Azure Front Door не учитывается регистр. Кроме того, они не зависят от строки запроса. Это означает, что при очистке URL-адреса будут очищены все его разновидности в строках запроса.

Примечание

Очистка кэша может занять до 10 минут для распространения по сети и во всех пограничных расположениях.

Дальнейшие действия

Узнайте, как создать профиль Azure Front Door.