En esta página, se explica cómo personalizar las claves de caché de Cloud CDN.
Cambiar la configuración de las claves de caché puede provocar una caída repentina en la tasa de aciertos de caché si las solicitudes nuevas comienzan a usar las claves de caché que son diferentes de las entradas de claves de caché anteriores. Del mismo modo, cambiar el creador de claves de caché no siempre invalida las entradas almacenadas en caché si las solicitudes nuevas usan la misma clave que las claves de caché anteriores. Para invalidar las entradas almacenadas en caché existentes, consulta Invalida contenido almacenado en caché.
Antes de comenzar
En esta página, se supone que conoces Cloud CDN, las claves de caché de Cloud CDN y los servicios de backend con balanceo de cargas. Te recomendamos que revises estas páginas antes de continuar.
Habilita Cloud CDN y personaliza las claves de caché
Con estas instrucciones, se activa Cloud CDN para un servicio de backend con balanceo de cargas y se personaliza la clave de caché mediante la exclusión de uno o más componentes. Si aún no tienes un balanceador de cargas para usar como origen, consulta la documentación del balanceador de cargas de aplicaciones externo para obtener instrucciones y crear uno.
Los buckets de backend no incluyen el protocolo ni el host en la clave de caché, ya que estos no influyen en la forma en la que se hace referencia a los objetos dentro de un bucket de Cloud Storage. Sin embargo, incluyen un conjunto de parámetros de cadena de consulta específicos de Cloud Storage, que podrían afectar la respuesta y extenderse con una lista personalizable de nombres de parámetros.
Console
- En la consola de Google Cloud, ve a la página Cloud CDN.
- Haz clic en Agregar origen.
- En el menú desplegable Origen, haz clic en Seleccionar origen.
- Selecciona el origen para el que deseas habilitar CDN.
Haz clic en Configurar en la fila del origen.
Si Cloud CDN ya está habilitado en este origen, primero haz clic en el menú , selecciona Editar y, luego, haz clic en Configurar.
Anula la selección de las casillas de verificación de los campos que desees omitir de la clave de caché para este servicio de backend.
Haz clic en Guardar.
Haz clic en Agregar.
gcloud
Especifica una o más de las marcas opcionales para excluir el componente de las claves de caché para este servicio de backend.
gcloud compute backend-services update BACKEND_SERVICE \
--enable-cdn
Marcas opcionales:
--no-cache-key-include-protocol--no-cache-key-include-host--no-cache-key-include-query-string
Actualiza claves de caché para volver a agregar un protocolo, un host y una cadena de consulta
De forma predeterminada, los servicios de backend configurados para usar Cloud CDN incluyen todos los componentes del URI de solicitud en las claves de caché. Si indicaste con anterioridad que uno o más componentes deberían excluirse, puedes usar los siguientes pasos para incluirlos de nuevo.
Estas instrucciones agregan de nuevo el protocolo, el host y la cadena de consulta a la clave de caché para un servicio de backend existente que ya tiene habilitado Cloud CDN.
Console
- En la consola de Google Cloud, ve a la página Cloud CDN.
- En la fila del balanceador de cargas, haz clic en Menú y, luego, en Editar.
- En la fila del servicio de backend o bucket de backend que deseas modificar, haz clic en Configurar.
- En Clave de caché, selecciona Personalizar.
- Selecciona las casillas de verificación Protocolo, Host y String de consulta.
- Deja en blanco el campo Parámetros de la string de consulta.
- Haz clic en Guardar.
- Haz clic en Actualizar.
gcloud
Para volver a agregar un componente, especifica solo esa marca. Las marcas que no se especifican permanecen sin cambios.
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-protocol \
--cache-key-include-host \
--cache-key-include-query-string
Actualiza claves de caché para usar una lista de inclusiones o exclusiones de parámetros de cadenas de consulta
Estas instrucciones configuran claves de caché de Cloud CDN para usar una lista de inclusiones o una lista de exclusiones con parámetros de cadena de consulta.
Console
- En la consola de Google Cloud, ve a la página Cloud CDN.
- En la fila del balanceador de cargas, haz clic en Menú y, luego, en Editar.
- En la fila del servicio de backend que deseas modificar, haz clic en Configurar.
- En Clave de caché, selecciona Personalizar.
- Confirma que la casilla de verificación String de consulta esté seleccionada.
Si deseas especificar los parámetros de la string de consulta que deberían formar parte de la clave de caché, selecciona Incluir solo los seleccionados.
Si deseas especificar que todos los parámetros de la string de consulta, con excepción de los que enumeras, se incluyan en la clave de caché, selecciona Incluir todos excepto los seleccionados.
Ingresa la lista separada por comas de las strings en el campo Parámetros de la string de consulta.
Haz clic en Guardar.
Haz clic en Actualizar.
gcloud
Usa este comando para establecer el parámetro de cadena de consulta user en la lista de inclusiones de un servicio de backend.
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-query-string \
--cache-key-query-string-whitelist user
Usa este comando para establecer el parámetro de cadena de consulta user en la lista de exclusiones de un servicio de backend.
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-query-string \
--cache-key-query-string-blacklist user
Usa este comando para establecer el parámetro de cadena de consulta user en la lista de inclusiones de un bucket de backend.
gcloud compute backend-buckets update BACKEND_BUCKET \
--cache-key-query-string-whitelist user
Actualiza las claves de caché para usar encabezados HTTP
En estas instrucciones, se configuran las claves de caché de Cloud CDN para usar encabezados HTTP.
Console
La consola de Google Cloud no es compatible con esta función.
gcloud
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-http-header=[HEADER_FIELD_NAME,...]
gcloud compute backend-buckets update BACKEND_BUCKET \
--cache-key-include-http-header=[HEADER_FIELD_NAME,...]
Actualiza claves de caché para usar cookies con nombre
En estas instrucciones, se configuran las claves de caché de Cloud CDN para usar cookies HTTP.
Console
La consola de Google Cloud no es compatible con esta función.
gcloud
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-named-cookie=[NAMED_COOKIE,...]
¿Qué sigue?
- Para verificar si Cloud CDN entrega respuestas desde la caché, consulta Registros y métricas para el almacenamiento en caché.