Поделиться через

Очистка кэша в 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.