使用缓存模式

本页面介绍了如何将缓存模式与 Cloud CDN 结合使用。您可通过缓存模式配置 Cloud CDN 缓存内容的方式。

准备工作

• 了解缓存模式和静态内容。

• 确保已启用 Cloud CDN；如需了解相关说明，请参阅使用 Cloud CDN。

• 如有必要，请更新到 Cloud SDK 的最新版本：

  gcloud components update
  

  注意：请确保您使用的是 gcloud SDK 版本 309.0.0 或更高版本。

设置缓存模式

Cloud CDN 提供三种缓存模式，其中定义了响应的缓存方式、Cloud CDN 是否遵循源站发送的缓存指令，以及缓存 TTL 的应用方式。

下表显示了可用的缓存模式：

缓存模式	行为
CACHE_ALL_STATIC	自动缓存不包含 no-store 或 private 指令的静态内容。设置有效缓存指令的源站响应也会进行缓存。 对于使用 gcloud 命令行工具或 REST API 创建的已启用 Cloud CDN 的后端，这是默认行为。
USE_ORIGIN_HEADERS	要求源站响应设置有效的缓存指令和有效的缓存标头。没有这些指令的响应会从源站进行转发。
FORCE_CACHE_ALL	无条件缓存成功响应，并跳过源站设置的任何缓存指令。如果后端为每个用户的专用内容（例如动态 HTML 或 API 响应）提供服务，则此模式不适用。

注意：将缓存模式设置为 FORCE_CACHE_ALL 时，内容缓存的默认生存时间 (TTL) 为 3600 秒（1 小时），除非并明确设置其他 TTL。接受新的默认 TTL 的第 1 小时可能会导致某些先前被视为新鲜的条目（由于源头中的 TTL 较长）。

注意： FORCE_CACHE_ALL 模式会替换缓存指令（Cache-Control 和 Expires），但不会替换其他源响应标头。特别是，即使 Vary 标头存在 FORCE_CACHE_ALL，这些标头仍会接受，并且可能会禁止缓存。如需了解详情，请参阅 Vary 标头。

注意：FORCE_CACHE_ALL 模式会通过 Google Cloud Console 中的缓存条目最长存在时间设置或 gcloud --signed-url-cache-max-age 选项替换为任何签名网址或签名 Cookie 指定的最长存在时间。

如需为已启用 Cloud CDN 的后端配置缓存模式，请执行以下操作：

控制台

1. 在 Google Cloud Console 中，转到负载平衡页面。

   转到“负载平衡”页面

2. 点击外部 HTTP(S) 负载平衡器的名称。
3. 点击修改 。
4. 在后端配置中，选择一个后端，然后点击修改 。
5. 确保选择启用 Cloud CDN。
6. 在缓存模式下，选择以下选项之一：
   • 缓存静态内容（推荐）：静态内容是不会针对每位用户更改的 Web 资源。静态内容基于响应中的 Content-Type。如需了解详情，请参阅静态内容。
   • 使用基于 Cache-Control 标头的源站设置：缓存响应标头中含有有效缓存指令的响应。
   • 强制缓存所有内容：缓存由源站传送的所有成功内容，忽略任何 private 或 no-store 指令。
7. 点击保存。

gcloud

对于后端服务，请使用带有 --cache-mode 标志的 gcloud compute backend-services create 或 gcloud compute backend-services update 命令。

对于后端存储分区，请使用带有 --cache-mode 标志的 gcloud compute backend-buckets create 或 gcloud compute backend-buckets update 命令。

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --cache-mode=CACHE_MODE

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --cache-mode=CACHE_MODE

将 CACHE_MODE 替换为以下项之一：

• CACHE_ALL_STATIC（默认）：自动缓存静态内容。标记为不可缓存的响应（Cache-Control 响应标头中的 private 或 no-store 指令）不会被缓存。为了缓存动态内容，内容必须具有有效的缓存标头。

• USE_ORIGIN_HEADERS：要求源站设置有效缓存标头以缓存内容。不带这些标头的响应不会在 Google 边缘缓存，且需要根据每个请求完成访问源站的完整行程，这可能会影响源服务器性能并增加其负载。

• FORCE_CACHE_ALL：缓存所有内容（即成功响应），忽略 Cache-Control 响应标头中的任何 private 或 no-store 指令。这可能导致缓存特定于每位用户的（可识别用户个人身份信息的）非公开内容。请仅在不会提供非公开内容或动态内容的后端（比如 Cloud Storage 存储分区）中启用此项设置。请勿在提供专用或动态内容的后端中启用此功能。

API

对于后端存储分区，请使用 Method: backendBuckets.insert 或 Method: backendBuckets.update API 调用。

对于后端服务，请使用 Method: backendServices.insert 或 Method: backendServices.update API 调用。

使用以下 API 调用之一：

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

将以下代码段添加到 JSON 请求正文：

"cdnPolicy": {
  "cacheMode": (CACHE_ALL_STATIC | USE_ORIGIN_HEADERS | FORCE_CACHE_ALL)

将 CACHE_MODE 替换为以下项之一：

• CACHE_ALL_STATIC（默认）：自动缓存静态内容。标记为不可缓存的响应（Cache-Control 响应标头中的 private 或 no-store 指令）不会被缓存。为了缓存动态内容，内容必须具有有效的缓存标头。

• USE_ORIGIN_HEADERS：要求源站设置有效缓存标头以缓存内容。不带这些标头的响应不会在 Google 边缘缓存，且需要根据每个请求完成访问源站的完整行程，这可能会影响源服务器性能并增加其负载。

• FORCE_CACHE_ALL：缓存所有内容（即成功响应），忽略 Cache-Control 响应标头中的任何 private 或 no-store 指令。这可能导致缓存特定于每位用户的（可识别用户个人身份信息的）非公开内容。您应仅在不会提供非公开内容或动态内容的后端（比如 Cloud Storage 存储桶）中启用此项设置。