用於混合實施的 CDN API

分階段無頭式部署用到多種 Storefront 技術，例如 Storefront Reference Architecture (SFRA) 和 Composable Storefront，來提供單一購物體驗。

嵌入式 CDN (eCDN) 區域可將流量同時路由至 SFRA 和 Managed Runtime，讓您逐步部署出 Composable Storefront。

本指南說明如何使用 Commerce API CDN 區域將流量路由至 Managed Runtime。您還可以使用 Business Manager 將流量路由到 Managed Runtime。在 Business Manager 中設定 MRT 路由規則

在執行本指南的命令之前，請以實際值取代預留位置。預留位置的格式為：$PLACEHOLDER

在本指南中，我們使用帶有生產URL https://www.example.com的示例網店。

只有現有客戶才能存取此頁面上的某些連結。造訪 Salesforce Commerce Cloud GitHub 存放庫和存取，以瞭解有關如何存取 Commerce Cloud 存放庫的資訊。
  1. 熟悉 Admin API 的授權
  2. 您必須擁有 sfcc.cdn-zones.rw 範圍的 Account Manager API 用戶端。
  3. 您必須知道要搭配 Managed Runtime 使用的 eCDN 區域的區域 ID。若要取得此資訊，請使用 CDN Zones API 的 getZonesInfo 端點。
  4. 使用 updateSecuritySettings 啟用該區域的 alwaysUseHttps。Managed Runtime 僅支援 HTTPS 流量。
  5. 設定您 SLAS API 用戶端的 redirect_uri 以納入該區域。
  6. 如果您已限制某些 IP 才能存取您的 Managed Runtime 環境，請將 eCDN 使用的 Cloudflare IP 加入那些允許的 IP 之中。

藉由 createMrtRules 端點，您可以建立規則，將流量路由至 Managed Runtime 環境：

讓我們檢驗一下要求本文中提供的資料。

mrtHostname 的值為 Managed Runtime 環境的網域，用於流量路由。它必須參照到裝載於 mobify-storefront.com 網域的 Managed Runtime 環境。如果提供的值已被現有的規則所使用，則要求會失敗。

Managed Runtime 是唯一受支援的路由目的地。

expressions 的值是 Cloudflare 規則表達式的陣列，控制要將哪些要求路由至 Managed Runtime。對大多數實作而言，單一路由表達式已經足夠了。

除了所提供的表達式，也會使用下列預設的路由規則：

路由變更會立即套用，瀏覽至符合表達式的 URL 時，會傳回從 Managed Runtime 擷取的內容。

  • 支援以下路由方案：

    • 映射到單個 MRT 環境的單個主機名稱：

      • 例如， http.host eq \"www.example.com\" → example-production.mobify-storefront.com

    • 多個主機名映射到單個 MRT 環境：

      • 例如， http.host in {\"www.example.com\" \"prod.example.com\" \"us.example.com\"}→ example-production.mobify-storefront.com

  • 目前 不支援 以下路由方案：

    • 根據不同路徑映射到多個MRT環境的單個主機名

表達式根據以下準則進行驗證：

  • http.host 必須恰好出現一次，並且後面必須跟著 eq OR in 運算子。有關使用範例，請參閱上文。
  • 主機名必須與區域匹配。換言之，eCDN 區域必須具有涵蓋所提供主機名的有效證書。
  • 支援下列欄位：
    • http.host
    • http.request.uri.path
    • http.request.uri
    • http.cookie
  • 表達式的最大長度為 3072 個字元。
  • 一個區域最多可以有 100 個表達式與其相關聯。

當您繼續分階段部署時，您可以將更多要求路由至 Managed Runtime。

若要修改路由表達式，請使用 getMrtRule 取得與您欲更新的表達式相關聯的規則集和規則的 ID。

接下來，使用 updateMrtRule 更新表達式：

若要向 現有 託管運行時環境添加更多路由規則，請使用 updateMrtRuleset 並提供 mrtHostname 和其他路由表達式：

若要為 新的 託管運行時環境添加路由規則，請使用 createMrtRules 端點並提供新 mrtHostname 值：

若要更新現有規則以路由到其他託管運行時環境，請使用 updateMrtRuleset 並提供 oldMrtHostname 要路由到的 和 （new）： mrtHostname

如果您要切換到第三方 CDN，或者您不想再將特定路徑從 eCDN 路由到 MRT，您可以禁用路由。

若要禁用路由，請使用 getMrtRules 獲取要刪除的配置的 ID：

然後，若要刪除Managed Runtime 路由規則，請使用 deleteMrtRule 並傳入 getMrtRules 傳回的適用 ID：

如果要刪除所有託管運行時路由規則，請使用 deleteMrtRuleset：

當您完成分階段部署，或如果您要推出新網站，您可以選擇使用單一表達式，將一個區域的所有流量路由至 Managed Runtime：

在 eCDN 不可用的環境中，請使用 composable-hybrid-dev-server 來模擬 eCDN 路由。