使用 Azure CLI 在 Azure Front Door 中快取清除

Azure Front Door 會快取資產，直到其存留時間 （TTL） 到期為止。 當用戶端要求具有過期 TTL 的資產時，Azure Front Door 會擷取資產的新複本、提供要求，以及更新快取。

為了確保使用者一律會取得最新的資產，請針對每個更新設定資產的版本，並使用新的URL發佈它們。 Azure Front Door 會擷取後續用戶端要求的新資產。 有時候，您可能需要清除所有邊緣節點的快取內容，以強制它們擷取更新的資產。 當您對應用程式進行更新或需要更正不正確的資訊時，此動作很有用。

必要條件

• 在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。

  

• 若要在本地執行 CLI 參考命令，請安裝 Azure CLI。 若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。

  • 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟，完成驗證程序。 如需其他登入選項，請參閱使用 Azure CLI 登入。

  • 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。

  • 執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。

• 請檢閱使用 Azure Front Door 進行快取，以了解快取的運作方式。
• 請確定您有運作中的 Azure Front Door 配置檔。 若要 瞭解如何建立 Azure Front Door - CLI，請參閱建立 Azure Front Door - CLI 。

設定快取清除

使用必要的參數執行 az afd endpoint purge ：

• 資源群組名稱
• 資源群組內的 Azure Front Door 配置檔名稱
• 具有要清除資產的端點
• 要清除資產的網域/子域

重要

不支援通配符網域的快取清除。 為通配符網域指定快取清除的子域。 您可以新增多個萬用字元網域的單一等級子網域。 例如，對於通配符網域*.afdxgatest.azfdtest.xyz，您可以新增 或 cart.afdxgatest.azfdtest.xyz等contoso.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 配置檔。