Usa las claves de caché

Descripción general

En esta página, se explica cómo personalizar las claves de caché de Cloud CDN.

Cambiar la configuración de la clave de caché puede provocar una caída repentina en la tasa de aciertos de caché si las solicitudes nuevas comienzan a utilizar las claves de caché que son diferentes de las entradas de las claves de caché antiguas. Del mismo modo, cambiar el creador de la clave de caché no invalida necesariamente las entradas almacenadas en caché si las solicitudes nuevas utilizan la misma clave que las claves de caché antiguas. Para invalidar las entradas almacenadas de caché existentes, consulta Invalida contenido almacenado en caché.

Antes de comenzar

En esta página, se da por sentado que existe un conocimiento de Cloud CDN, las claves de caché de Cloud CDN y los servicios de backend de balanceo de cargas. Revisa esas páginas antes de continuar.

Activa Cloud CDN para un servicio de backend y personaliza las claves de caché

Estas instrucciones activan CDN para un servicio de backend de balanceo de cargas y personalizan la clave de caché mediante la exclusión de uno o más componentes. Si aún no tienes un balanceador de cargas para utilizarlo como origen, consulta la documentación del balanceo de cargas de HTTP(S) a fin de obtener instrucciones sobre cómo crear uno.

Console

  1. Ve a la página de Cloud CDN de Google Cloud Platform Console.
    Ir a la página de Cloud CDN
  2. Haz clic en Agregar origen.
  3. En el menú desplegable Origen, haz clic en Seleccionar origen.
  4. Selecciona el origen para el que deseas activar CDN.
  5. Haz clic en Configurar en la fila del origen.
  6. 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.
  7. Haz clic en Guardar.
  8. Haz clic en Agregar.

gcloud

Especifica una o más de las marcas opcionales para excluir ese parámetro 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

Según la configuración predeterminada, Cloud CDN incluye todos los componentes del URI de solicitud en las claves de caché. Si anteriormente indicaste 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 CDN habilitado.

Console

  1. Ve a la página de Cloud CDN de Google Cloud Platform Console.
    Ir a la página de Cloud CDN
  2. Haz clic en el botón de menú de tres puntos en la fila del balanceador de cargas.
  3. Selecciona Editar en el menú.
  4. Haz clic en Configurar en la fila del servicio de backend que deseas modificar.
  5. Abre el menú Clave de caché y selecciona Personalizar.
  6. Selecciona las casillas de verificación Protocolo, Host y Cadena de consulta.
  7. Puedes dejar el campo Parámetros de la cadena de consulta en blanco.
  8. Haz clic en Guardar.
  9. Haz clic en Actualizar.

gcloud

Para volver a agregar un componente, solo especifica 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 utilizar una lista blanca o una lista negra de cadenas de consulta

Estas instrucciones configuran las claves de caché CDN para utilizar una lista blanca o una lista negra con parámetros de la cadena de consulta.

Console

  1. Ve a la página de Cloud CDN de Google Cloud Platform Console.
    Ir a la página de Cloud CDN
  2. Haz clic en el botón de menú de tres puntos en la fila del balanceador de cargas.
  3. Selecciona Editar en el menú.
  4. Haz clic en Configurar en la fila del servicio de backend que deseas modificar.
  5. Abre el menú Clave de caché y selecciona Personalizar.
  6. Confirma que la casilla de verificación Cadena de consulta esté seleccionada.
  7. Selecciona Solo estos parámetros (lista blanca) si deseas especificar los parámetros de la cadena de consulta que deberían formar parte de la clave de caché. Selecciona Todos los parámetros excepto estos (lista negra) si deseas especificar que todos los parámetros de la cadena de consulta, con excepción de los que enumeras, se incluyan en la clave de caché.
  8. Ingresa la lista separada por comas de las strings en el campo Parámetros de la cadena de consulta.
  9. Haz clic en Guardar.
  10. Haz clic en Actualizar.

gcloud

Utiliza este comando para establecer que la string user sea la lista blanca.

gcloud compute backend-services update [BACKEND_SERVICE] \
    --cache-key-include-query-string \
    --cache-key-query-string-whitelist user

Utiliza este comando para agregar la string user a la lista negra.

gcloud compute backend-services update [BACKEND_SERVICE] \
    --cache-key-include-query-string \
    --cache-key-query-string-blacklist user

Pasos siguientes