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 bucket o 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 HTTP(S) externo a fin de obtener instrucciones para crear uno.
Consola
- En Google Cloud Console, 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.
Haga clic en Agregar.
gcloud
Especifica una o más de las marcas opcionales a fin de excluir ese parámetro de las claves de caché para este servicio o bucket de backend.
gcloud compute backend-services update BACKEND_SERVICE \
--enable-cdn
gcloud compute backend-buckets update BACKEND_BUCKET \
--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 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.
Consola
- En Google Cloud Console, 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
gcloud compute backend-buckets update BACKEND_BUCKET \
--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.
Consola
- En Google Cloud Console, 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 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
Actualiza claves de caché para usar encabezados HTTP
En estas instrucciones, se configuran las claves de caché de Cloud CDN para usar encabezados HTTP.
Consola
Actualmente, 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.
Consola
Actualmente, 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 Visualiza registros.