使用 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 設定檔。 請參閱建立 Front Door - CLI 以了解如何建立 Front Door。

設定快取清除

執行 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 設定檔。