分阶段无头部署的 CDN API

分阶段无头部署是一种使用 Storefront Reference Architecture (SFRA) 和可组合网店等多种网店技术提供单一购物体验的技术。

嵌入式 CDN (eCDN) 区域可以同时将流量路由到 SFRA 和 Managed Runtime，从而允许您逐步部署可组合网店。

本指南介绍如何使用 Commerce API CDN 区域将流量路由到 Managed Runtime。

1. 您要熟悉 Admin API 授权
2. 您必须拥有具有范围 sfcc.cdn-zones.rw 的 Account Manager API 客户端。
3. 您必须知道要与 Managed Runtime 一起使用的 eCDN 区域的区域 ID。要获取此信息，请使用 CDN 区域 API 的 getZonesInfo 端点。
4. 使用 updateSecuritySettings以在区域中启用 alwaysUseHttps。_ Managed Runtime 仅支持通过 HTTPS 的流量。_
5. 设置您的 SLAS API 客户端的 redirect_uri 以包含该区域。
6. 如果您 限制了允许访问 Managed Runtime 环境的 IP 集 ，请将 eCDN 使用的 CloudFlare IPs 添加到允许的 IP 集。

使用 createMrtRules 端点，您可以创建将流量路由到 Managed Runtime 环境的规则：

我们来检查一下请求正文中提供的数据。

mrtHostname 的值是用于流量路由的 Managed Runtime 环境的域。它必须引用 mobify-storefront.com 域上托管的 Managed Runtime 环境。如果现有规则使用提供的值，则请求将失败。

expressions 的值是 Cloudflare 规则表达式的数组，用于控制将哪些请求路由到 Managed Runtime。对于大多数实施，单个路由表达式便已足够。

除了提供的表达式之外，还使用以下默认路由规则：

路由更改会立即应用，导航到与表达式匹配的 URL 会返回从 Managed Runtime 检索的内容。

表达式根据以下标准进行验证：

• http.host 必须准确出现一次并且必须跟在 eq 运算符后面。值必须匹配区域。
• 支持以下字段：
  • http.host
  • http.request.uri.path
  • http.request.uri
  • http.cookie
• 表达式的最大长度为 3072 个字符。
• 一个区域最多可以关联 100 个表达式。

当您继续分阶段部署时，您可以将更多请求路由到 Managed Runtime。

要修改路由表达式，请使用 getMrtRule 获取与要更新的表达式关联的规则集和规则的 ID：

接下来使用 updateMrtRule 更新表达式：

要禁用路由，请使用 getMrtRule 获取规则集 ID：

然后，使用deleteMrtRuleset删除该规则集的 Managed Runtime 路由：

完成分阶段部署或启动新站点时，您可以选择使用单个表达式将区域的所有流量路由到 Managed Runtime：

在 eCDN 不可用的环境中，使用 composable-hybrid-dev-server 来模拟 eCDN 路由。