使用缓存模式

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

准备工作

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

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

  • 如有必要,请更新到 Cloud SDK 的最新版本:

    gcloud components update
    

设置缓存模式

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

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

缓存模式 行为
CACHE_ALL_STATIC 自动缓存不包含 no-storeprivate 指令的静态内容。设置有效缓存指令的源站响应也会进行缓存。

对于使用 gcloud 命令行工具或 REST API 创建的已启用 Cloud CDN 的后端,这是默认行为。

USE_ORIGIN_HEADERS 要求源站响应设置有效的缓存指令和有效的缓存标头。没有这些指令的响应会从源站进行转发。
FORCE_CACHE_ALL 无条件缓存成功响应,并跳过源站设置的任何缓存指令。如果后端为每个用户的专用内容(例如动态 HTML 或 API 响应)提供服务,则此模式不适用。

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

控制台

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

    转到“负载平衡”页面

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

gcloud

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

对于后端存储分区,请使用带有 --cache-mode 标志的 gcloud compute backend-buckets creategcloud 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 响应标头中的 privateno-store 指令)不会被缓存。为了缓存动态内容,内容必须具有有效的缓存标头

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

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

API

对于后端存储分区,请使用 Method: backendBuckets.insertMethod: backendBuckets.update API 调用。

对于后端服务,请使用 Method: backendServices.insertMethod: 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 响应标头中的 privateno-store 指令)不会被缓存。为了缓存动态内容,内容必须具有有效的缓存标头

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

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