Configuración de la invalidación push para la CDN de producción BYO

La invalidación push purga automáticamente el contenido en la CDN de producción del cliente (por ejemplo, www.yourdomain.com), cada vez que un autor publica cambios de contenido.

El contenido se purga mediante la dirección URL y la clave/etiqueta de caché.

La configuración de la invalidación push requiere dos pasos:

Configuración

Actualmente, la invalidación push es compatible con las CDN de los siguientes proveedores:

La invalidación push se habilita añadiendo propiedades específicas a la configuración del proyecto (un libro de Excel denominado .helix/config.xlsx en SharePoint o en una hoja de Google denominada .helix/config en Google Drive).

Las secciones siguientes describen las propiedades específicas del proveedor necesarias para configurar la invalidación push.

Rápido

Propiedades de configuración:

key
valor
comentario
cdn.prod.host
<Production Host>
Nombre del host del sitio de producción, p. ej.,. www.yourdomain.com
cdn.prod.type
fastly
cdn.prod.serviceId
<Fastly Service ID>
ID de servicio del servicio de producción
cdn.prod.authToken
<Fastly API Token>

Crear un token de API de Fastly

  • ir a Tokens de API personales,
  • haga clic en "Crear token",
  • introduzca un nombre (por ejemplo, "Production Site Purge Token"),
  • seleccione "Un servicio específico" y su servicio de producción de la lista desplegable,
  • marque la casilla de verificación "Purgar contenido seleccionado (purge_select) — Purgar por URL o clave de sustitución",
  • seleccione "No caducar nunca",
  • haga clic en "Crear token",
  • copie el valor de token generado que se muestra en la ventana emergente.

Puede validar las credenciales con esto herramienta.

Akamai

Propiedades de configuración

key
valor
comentario
cdn.prod.host
<Production Host>
Nombre del host del sitio de producción, p. ej.,. www.yourdomain.com
cdn.prod.type
akamai
cdn.prod.endpoint
<host>
Credenciales de API de purga rápida
cdn.prod.clientSecret
<client_secret>
Credenciales de API de purga rápida
cdn.prod.clientToken
<client_token>
Credenciales de API de purga rápida
cdn.prod.accessToken
<access_token>
Credenciales de API de purga rápida

La invalidación push utiliza el API de purga rápida de Akamai, específicamente Eliminar por dirección URL y Eliminar por etiqueta de caché.

Las credenciales de la API de purga rápida constan de

host = akaa-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.luna.akamaiapis.net
client_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX
client_secret = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
access_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX

Se pueden generar siguiendo las instrucciones en Creación de un cliente de API con permisos personalizados.

Administración de identidad y acceso

Crear cliente de API



Permisos de grupo/función requeridos:

Puede validar las credenciales con esto herramienta.

Cloudflare

Propiedades de configuración

key
valor
comentario
cdn.prod.host
<Production Host>
Nombre del host del sitio de producción, p. ej.,. www.yourdomain.com
cdn.prod.type
cloudflare
cdn.prod.plan
e.g. free

valores: free, pro, business, enterprise

valor predeterminado: free

solo el plan empresarial admite la depuración por etiqueta

cdn.prod.zoneId
<Cloudflare Zone ID>
ID de zona de producción
cdn.prod.apiToken
<Cloudflare API Token>

Creación de un token de API

  • ir a Tokens de API
  • haga clic en "Crear token",
  • vaya a "Crear token personalizado" en la parte inferior y haga clic en "Comenzar"
  • introduzca un nombre de token (por ejemplo, "Production Site Purge Token"),
  • Permisos: "Zone", "Cache Purge", "Purge"
  • Recursos de zona: "Incluir", "Zona específica", "&lt;your production="" zone="">"
  • Haga clic en "Continuar a resumen"
  • haga clic en "Crear token",
  • copie el valor de token generado.

Tenga en cuenta que solo los sitios del plan empresarial se purgarán quirúrgicamente mediante la dirección URL y la clave de caché. A Purgar todo se realizará en sitios que no sean de empresa cada vez que un autor publique un cambio de contenido.

Puede validar las credenciales con esto herramienta.

CloudFront

NB: CloudFront NO admite la depuración por etiqueta/clave de caché. Purgar por clave/etiqueta de caché siempre almacena en déclencheur una purga de todo.

Propiedades de configuración

key
valor
comentario
cdn.prod.host
<Production Host>
Nombre del host del sitio de producción, p. ej.,. www.yourdomain.com
cdn.prod.type
cloudfront
cdn.prod.distributionId
<Cloudfront Distribution ID>
cdn.prod.accessKeyId
<AWS Access key ID>
Credenciales de AWS
cdn.prod.secretAccessKey
<AWS Secret access key>
Credenciales de AWS

Crear las credenciales de AWS

En la consola de AWS, abra el panel de IAM:

Seleccione Usuarios -> Añadir usuarios:

Introduzca un nombre de usuario y marque "Access key - Programmatic access":

En el panel "Establecer permisos", haga clic en "Crear grupo":

Escriba un nombre de grupo y seleccione la directiva CloudFrontFullAccess:

Cree el usuario:

Finalmente, copie los valores Access key ID y Secret access key:

Puede validar las credenciales con esto herramienta.

Encabezado de solicitud de inclusión

La CDN de producción debe enviar el siguiente encabezado de inclusión al origen para habilitar los TTL de caché larga:

X-Push-Invalidation: enabled

recommendation-more-help
10a6ce9d-c5c5-48d9-8ce1-9797d2f0f3ec