Cambiar la configuración y las anulaciones de TTL

En esta página, se describe cómo cambiar las anulaciones de TTL con Cloud CDN. Las anulaciones de TTL te brindan un control detallado sobre la cantidad de tiempo que Cloud CDN almacena en caché tu contenido antes de volver a validarlo.

La configuración de TTL se resume en la siguiente tabla.

Antes de comenzar

• Lee sobre los modos de almacenamiento en caché.

• Asegúrate de que Cloud CDN esté habilitado. Para obtener instrucciones, consulta Usa Cloud CDN.

• Si es necesario, actualiza a la última versión de Google Cloud CLI:

  gcloud components update
  

Establece el TTL predeterminado

Con el fin de mejorar las tasas de aciertos de caché en el contenido que no cambia con frecuencia, puedes anular el TTL predeterminado para que Cloud CDN vuelva a validar el contenido en el origen con menos frecuencia. Ten en cuenta que los objetos a los que se accede con poca frecuencia podrían expulsarse de la caché antes del TTL definido.

Cuando el modo de almacenamiento en caché es FORCE_CACHE_ALL, el TTL predeterminado reemplaza al TTL establecido en todas las respuestas (incluidas las que tienen un TTL establecido por encabezados de origen). En este modo, los clientes ven el TTL predeterminado, ya que Cloud CDN establece los atributos public y max-age de las respuestas que se entregan a los clientes.

Con el modo CACHE_ALL_STATIC, el TTL predeterminado se aplica al contenido almacenado en caché que un origen entrega para respuestas que no tienen un TTL válido existente (encabezado max-age, s-maxage o Expires). En el modo CACHE_ALL_STATIC, el TTL predeterminado no modifica el encabezado Cache-Control que se entrega a los clientes. Para modificar el encabezado Cache-Control en el modo CACHE_ALL_STATIC, debes establecer el TTL del cliente.

Cuando configuras el modo de caché para usar encabezados de origen (USE_ORIGIN_HEADERS), el valor de TTL predeterminado no se aplica y no se puede establecer porque Cloud CDN usa la directiva de origen max-age o s-maxage, o el encabezado Expires.

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --default-ttl=DEFAULT_TTL

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --default-ttl=DEFAULT_TTL

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

"cdnPolicy": {
  "defaultTtl": DEFAULT_TTL
}

Establece el TTL máximo

El TTL máximo (máx.) especifica el TTL máximo permitido dentro de Cloud CDN para el contenido almacenado en caché que entrega un origen.

El TTL de una respuesta se limita al TTL máx. si se cumple una de las siguientes condiciones:

• La respuesta intenta establecer un valor max-age o s-maxage más alto que el valor máximo de TTL.
• La respuesta tiene un encabezado Expires de más de cdnPolicy.maxTtl segundos en el futuro.

El parámetro de configuración de TTL máx. no cambia el valor max-age que se envió al cliente. Para obtener más información, consulta Anula el TTL máximo de cliente. El parámetro de configuración de TTL máx. solo afecta por cuánto tiempo Cloud CDN intenta almacenar en caché el contenido.

Este parámetro de configuración solo se usa cuando el modo de almacenamiento en caché es CACHE_ALL_STATIC. El valor máximo permitido es de 31,622,400 segundos (1 año). Ten en cuenta que los objetos a los que se accede con poca frecuencia podrían expulsarse de la caché antes del TTL definido.

Con FORCE_CACHE_ALL, el TTL siempre está configurado en el TTL predeterminado. No puedes establecer un TTL máx.

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --max-ttl=MAX_TTL

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --max-ttl=MAX_TTL

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

"cdnPolicy": {
  "maxTtl": MAX_TTL
}

Anula el TTL del cliente

En todos los modos de almacenamiento en caché, Cloud CDN pasa los encabezados Cache-Control al cliente.

El TTL del cliente te permite establecer un TTL máximo para lo que se envía a navegadores o clientes, de modo que los clientes vuelvan a validar el contenido en Cloud CDN con mayor frecuencia, sin necesidad de una revalidación en el origen. De esta manera, el contenido se puede invalidar dentro de Cloud CDN cuando sea necesario, y los navegadores pueden descubrir que el contenido se invalida en cuanto vence el TTL de cliente.

En el modo FORCE_CACHE_ALL, Cloud CDN suele pasar el mismo max-age al cliente que usa de forma interna para el almacenamiento en caché del proxy. Sin embargo, si se especifica un TTL de cliente y es un valor más pequeño, el TTL del cliente se pasa al cliente en la directiva max-age en su lugar. De la misma forma, en el modo CACHE_ALL_STATIC, el TTL del cliente es una fijación para cualquier valor max-age que especifique el servidor de origen a fin de que el valor max-age que se envía al navegador o al cliente no sea más grande que el TTL de cliente configurado. Si el origen no especifica un valor max-age, el menor de los TTL de Cloud CDN y el valor de TTL del cliente se usa como el max-age enviado al navegador o al cliente.

Si hay un encabezado Expires en la respuesta de origen, se quita y se reemplaza por una directiva Cache-Control: max-age con el TTL adecuado. Para las respuestas de error, si no se establece ningún TTL de almacenamiento en caché negativo, también se quita el encabezado Cache-Control.

Debido a que el TTL de cliente se trata como un valor máximo para lo que se envía a los navegadores o clientes, no se puede usar a fin de aumentar el valor max-age que se enviaría de otra manera. Si el valor max-age que se envía a los navegadores y clientes es menor que lo que deseas, debes aumentar el valor de la directiva max-age en la respuesta que muestra el origen o ajustar la configuración del TTL predeterminado o del almacenamiento en caché negativo de forma adecuada.

Por lo general, una configuración de TTL del cliente de alrededor de un día es un buen límite superior práctico. Una configuración de un día significa que los navegadores se verifican con al menos esa frecuencia y pueden obtener información sobre las invalidaciones de caché que pueden haber ocurrido en Cloud CDN. Puedes configurar el TTL del cliente con un valor mucho más alto (hasta un año) como una forma de permitir que el origen y los TTL configurados controlen por completo lo que se envía al cliente. Esto puede ser útil si no deseas que el navegador realice validaciones más frecuentes en Cloud CDN.

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --client-ttl=CLIENT_TTL

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --client-ttl=CLIENT_TTL

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

"cdnPolicy": {
  "clientTtl": CLIENT_TTL
}

¿Qué sigue?

• Para conocer los motivos por los que se entrega contenido inactivo y vencido, consulta Cómo entregar contenido inactivo.