API de CDN para lanzamiento por fases

Un lanzamiento por fases es una técnica para brindar una única experiencia de compra utilizando varias tecnologías de storefront, como Storefront Reference Architecture (SFRA) y Composable Storefront.

Una CDN integrada (eCDN) puede enrutar el tráfico tanto a SFRA como a Managed Runtime al mismo tiempo, lo que le permite lanzar gradualmente un Composable Storefront.

Esta guía describe cómo utilizar Zonas de CDN de la API de Commerce para enrutar tráfico a Managed Runtime.

1. Familiarícese con los API de autorización para administradores.
2. Debe tener un cliente de API de Account Manager con el alcance sfcc.cdn-zones.rw.
3. Debe conocer la identificación de la zona eCDN que se utilizará con Managed Runtime. Para obtener esta información, utilice el punto de conexión getZonesInfo de la API de zonas de CDN.
4. Utilice updateSecuritySettings para habilitar alwaysUseHttps en la zona. Managed Runtime solo admite tráfico a través de HTTPS.
5. Configure su redirect_uri de cliente de API de SLAS para que incluya la zona.
6. Si restringió el conjunto de IP permitidas para acceder a su entorno de Managed Runtime, agregue las IP de CloudFlare utilizadas por eCDN al conjunto de IP permitidas.

Con el punto de conexión createMrtRules, puede crear reglas que enruten el tráfico a un entorno de Managed Runtime:

Examinemos los datos proporcionados en el cuerpo de la solicitud.

El valor de mrtHostname es el dominio del entorno de Managed Runtime para el enrutamiento de tráfico. Debe hacer referencia a un entorno de Managed Runtime alojado en el dominio mobify-storefront.com. Si el valor proporcionado está siendo utilizado por una regla existente, la solicitud falla.

El valor de expressions es una variedad de expresiones de reglas de Cloudflare que controla qué solicitudes se enrutan a Managed Runtime. Para la mayoría de las implementaciones, una única expresión de enrutamiento es suficiente.

Además de las expresiones proporcionadas, se utilizan las siguientes reglas de enrutamiento predeterminadas:

Los cambios de enrutamiento se aplican de inmediato, y navegar a una URL que coincide con una expresión devuelve contenido recuperado de Managed Runtime.

Las expresiones se validan con respecto a los siguientes criterios:

• http.host debe ocurrir exactamente una vez y debe ser seguida por el operador eq. El valor debe coincidir con la zona.
• Se admiten los siguientes campos:
  • http.host
  • http.request.uri.path
  • http.request.uri
  • http.cookie
• La longitud máxima de una expresión es 3072 caracteres.
• Se puede asociar un máximo de 100 expresiones a una zona.

Mientras continúa con su lanzamiento por fases, puede enrutar más solicitudes a Managed Runtime.

Para modificar una expresión de enrutamiento, utilice getMrtRule para obtener las identificaciones del conjunto de reglas y la regla asociados con la expresión que desea actualizar:

Luego, utilice updateMrtRule para actualizar la expresión:

Para deshabilitar el enrutamiento, utilice getMrtRule para obtener la identificación del conjunto de reglas:

Luego, utilice deleteMrtRuleset para eliminar el enrutamiento a Managed Runtime para dicho conjunto de reglas:

Cuando complete su lanzamiento por fases, o si lanzará un sitio nuevo, puede elegir enrutar todo el tráfico para una zona a Managed Runtime usando una única expresión:

En los entornos en los que eCDN no está disponible, utilice composable-hybrid-dev-server para simular el enrutamiento de eCDN.