Usa claves de caché

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 para un servicio de backend y personaliza las claves de caché

Con estas instrucciones, se activa 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 balanceo de cargas de HTTP(S) externo a fin de obtener instrucciones con el objetivo de crear uno.

Console

  1. En Google Cloud Console, ve a la página Cloud CDN.

    Ir a la página 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 habilitar CDN.
  5. 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.

  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 string 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 vuelven a agregar el protocolo, el host y la string de consulta a la clave de caché para un servicio de backend existente que ya tiene CDN habilitado.

Console

  1. En Google Cloud Console, ve a la página Cloud CDN.

    Ir a la página Cloud CDN

  2. En la fila del balanceador de cargas, haz clic en Menú  y, luego, en Editar.
  3. En la fila del servicio de backend que deseas modificar, haz clic en Configurar.
  4. En Clave de caché, selecciona Personalizar.
  5. Selecciona las casillas de verificación Protocolo, Host y String de consulta.
  6. Deja en blanco el campo Parámetros de la string de consulta.
  7. Haz clic en Guardar.
  8. 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 exclusiones de strings de consulta

Estas instrucciones configuran claves de caché de CDN para usar una lista de inclusiones o una lista de exclusiones con parámetros de string de consulta.

Console

  1. En Google Cloud Console, ve a la página Cloud CDN.

    Ir a la página Cloud CDN

  2. En la fila del balanceador de cargas, haz clic en Menú  y, luego, en Editar.
  3. En la fila del servicio de backend que deseas modificar, haz clic en Configurar.
  4. En Clave de caché, selecciona Personalizar.
  5. Confirma que la casilla de verificación String de consulta esté seleccionada.
  6. 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.

  7. Ingresa la lista separada por comas de las strings en el campo Parámetros de la string de consulta.

  8. Haz clic en Guardar.

  9. Haz clic en Actualizar.

gcloud

Usa este comando para establecer la string user en la lista de inclusiones.

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

Usa este comando para agregar la string user a la lista de exclusiones.

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

Próximos pasos

  • Para verificar si Cloud CDN entrega respuestas desde la caché, consulta Visualiza registros.