使用入门

本页面可帮助您开始使用 Cloud CDN 图片优化功能，其中介绍了如何配置图片优化功能，并列出了支持的操作及示例。

前提条件

如需使 Cloud CDN 图片优化功能正常运行，请确保满足以下前提条件：

  • 必须在网址路由或关联的后端服务/存储桶中启用 Cloud CDN 缓存政策，并且必须在该网址映射路由中启用图片优化功能。

  • 仅全球外部应用负载平衡器支持图片优化。经典版应用负载平衡器不支持图片优化。

  • 客户端请求必须包含一个 Accept 标头，指明它可以接收图片内容，例如 image/webp、image/avif、image/* 或 */*。

  • 源服务器必须使用 HTTP 200 状态代码和受支持的图片 Content-Type 标头进行响应。

  • 网址中必须包含 imop 查询参数，并且该参数必须包含一个或多个有效的转换操作。

配置图片优化

如需使用图片优化功能，您必须在相关路由、后端服务或后端存储桶上启用 Cloud CDN。

gcloud

您必须向 YAML 文件添加配置，并将其导入到网址映射中，因为图片优化政策是在 routeAction 对象内定义的。

将现有网址映射配置导出到本地 YAML 文件：

gcloud beta compute url-maps export YOUR_URL_MAP_NAME \
    --global \
    --destination my-url-map.yaml

在文本编辑器中修改 my-url-map.yaml 文件，并将 cachePolicy 字段添加到所选的 routeAction 或 defaultRouteAction 部分。

name: image-matcher
routeRules:
  --description: ImageOptimizationService
    matchRules:
       --prefixMatch: /images/
    priority: 1
    routeAction:
       imageOptimizationPolicy:
         queryParameterInterpretation: ENABLED

导入更新后的网址映射

gcloud beta compute url-maps import YOUR_URL_MAP_NAME \
    --global \
    --source my-url-map.yaml

支持的图片格式

Cloud CDN 图片优化功能支持特定的输入和输出格式，具体取决于请求配置和源内容类型标头。

支持的输入格式

支持以下格式作为来自源服务器的输入：

  • HEIF
  • ICO
  • BMP
  • JP2K (JPEG 2000)

支持的输出格式

Cloud CDN 边缘可以处理、缓存和提供以下格式的优化图片衍生版本：

  • JPEG
  • GIF
  • PNG
  • TIFF
  • WEBP
  • AVIF
  • BRUNSLI

支持的源内容类型

当源服务器返回以下 Content-Type 标头之一时，系统会尝试优化图片：

  • image/jpeg
  • image/png
  • image/webp
  • image/gif
  • image/bmp
  • image/tiff
  • image/avif
  • image/heif
  • image/jp2
  • image/x-j (brunsli)
  • text/ico、image/ico、image/icon、application/ico、image/x-icon 或 image/vnd.microsoft.icon

图片转换网址

如需执行动态图片转换，请将 imop 查询参数添加到图片网址。此形参包含一个转换字符串，该字符串由按顺序应用的一个或多个操作组成。

转换字符串使用以下格式规则：

  • 使用分号 (;) 分隔每项单独的操作。
  • 使用英文逗号 (,) 分隔每个操作中的内部参数。
  • 单个查询字符串中只能包含一种给定类型的操作。

基准语法使用以下结构：

?imop=[OPERATION_1];[OPERATION_2];...[OPERATION_N]

如需同时对图片执行多项操作，请将链式参数字符串附加到图片网址。例如，如需将图片调整为 800 像素宽，将压缩质量设置为 85，并将格式转换为 WebP，请附加参数字符串。

例如，

https://www.example.com/image.jpg?imop=Resize,width=800;Compress,quality=85;Convert,format=webp;

政策结构

图片优化政策充当核心配置封装容器，其中包含与图片优化功能相关的所有属性。

名称

说明

配置

queryParameterInterpretation

用于确定是否在数据平面中解读图片优化查询参数的枚举值。

必需。如果设置为 DISABLED，政策将忽略用于转换的查询参数，从而有效停用此功能。如果设置为 ENABLED，系统会启用此功能。

政策依赖关系和验证

图片优化政策依赖于 Cloud CDN 缓存。若要正常使用此功能，必须在以下两个位置之一明确设置缓存政策：

  • 正在配置图片优化政策的网址映射路由。

  • 与相应确切路由相关的后端服务或后端存储桶。

图片优化政策会与有效的底层缓存政策严格结合使用。

图片优化排序规则

imop 查询参数中列出的操作会从左到右依次处理，但以下绝对系统替换除外：

  • 元数据和缩放操作始终先执行。
  • 画布操作始终最后执行。

所有输入素材资源在执行这些转换之前都会经过自动归一化处理。EXIF 方向标记和 ICC 颜色配置文件会直接应用于图像像素，然后才会剥离任何元数据，从而确保坐标完整性在后续结构性操作中保持准确。

后续步骤