開始使用

本頁面說明如何開始使用 Cloud CDN 圖片最佳化功能，包括如何設定圖片最佳化功能，以及支援的作業清單和範例。

必要條件

如要使用 Cloud CDN 圖片最佳化功能，請確保符合下列必要條件：

  • 您必須在網址路徑或相關聯的後端服務/bucket 中啟用 Cloud CDN 快取政策，並在該網址對應路徑中啟用圖片最佳化功能。

  • 圖片最佳化功能僅支援全域外部應用程式負載平衡器，不支援傳統版應用程式負載平衡器。

  • 用戶端要求必須包含 Accept 標頭，指出可以接收圖片內容，例如 image/webp、image/avif、image/* 或 */*。

  • 原始伺服器必須傳回 HTTP 200 狀態碼和支援的圖片 Content-Type 標頭。

  • 網址中必須包含 imop 查詢參數，且該參數須包含一或多個有效的轉換作業。

設定圖片最佳化

如要使用圖片最佳化功能，請在相關路徑、後端服務或後端 bucket 上啟用 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 圖片最佳化功能支援特定輸入和輸出格式，具體取決於要求設定和來源 Content-Type 標頭。

支援的輸入格式

系統支援從原始伺服器輸入下列格式：

  • 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 快取。如要使用這項功能，必須在下列其中一個位置明確設定快取政策：

  • 設定圖片最佳化政策的網址對應路徑。

  • 與該確切路徑相關的後端服務或後端 bucket。

圖片最佳化政策會與有效的基礎快取政策一併嚴格套用。

圖片最佳化排序規則

系統會從左到右處理 imop 查詢參數中列出的作業，但下列絕對系統覆寫除外：

  • metadata 和 scale 作業一律會優先執行。
  • 畫布作業一律最後執行。

所有輸入資產都會先經過自動正規化，再執行這些轉換。系統會先將 EXIF 方向標記和 ICC 色彩設定檔直接套用至圖片像素，再移除任何中繼資料，確保後續結構動作的座標完整性維持準確。

後續步驟