Memulai

Halaman ini membantu Anda memulai pengoptimalan gambar Cloud CDN, dengan menjelaskan cara mengonfigurasi pengoptimalan gambar dan daftar operasi yang didukung dengan contoh.

Prasyarat

Agar pengoptimalan gambar Cloud CDN berfungsi, pastikan prasyarat berikut terpenuhi:

  • Kebijakan cache Cloud CDN harus diaktifkan di rute URL atau layanan backend atau bucket terkait, dan fitur pengoptimalan gambar harus aktif di rute peta URL tersebut.

  • Pengoptimalan gambar hanya didukung untuk Load Balancer Aplikasi Eksternal Global. Load Balancer Aplikasi klasik tidak didukung.

  • Permintaan klien harus menyertakan header Accept yang menunjukkan bahwa klien dapat menerima konten gambar, seperti image/webp, image/avif, image/*, atau */*.

  • Server asal harus merespons dengan kode status HTTP 200 dan header Content-Type gambar yang didukung.

  • Parameter kueri imop harus disertakan dalam URL dan berisi satu atau beberapa operasi transformasi yang valid.

Mengonfigurasi pengoptimalan gambar

Untuk menggunakan pengoptimalan gambar, Anda harus mengaktifkan Cloud CDN di rute, layanan backend, atau bucket backend yang relevan.

gcloud

Anda harus menambahkan konfigurasi ke file YAML dan mengimpornya ke peta URL karena kebijakan pengoptimalan gambar ditentukan di dalam objek routeAction.

Ekspor konfigurasi peta URL yang ada ke file YAML lokal:

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

Edit file my-url-map.yaml di editor teks dan tambahkan kolom cachePolicy ke bagian routeAction atau defaultRouteAction yang dipilih.

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

Mengimpor peta URL yang diupdate

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

Format gambar yang didukung

Pengoptimalan gambar Cloud CDN mendukung format input dan output tertentu berdasarkan konfigurasi permintaan dan header jenis konten asal.

Format input yang didukung

Format berikut didukung sebagai input dari server asal Anda:

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

Format output yang didukung

Edge Cloud CDN dapat memproses, menyimpan dalam cache, dan menyajikan turunan gambar yang dioptimalkan dalam format berikut:

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

Jenis konten asal yang didukung

Pengoptimalan gambar dicoba saat server asal Anda merespons dengan salah satu header Content-Type berikut:

  • 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, atau image/vnd.microsoft.icon

URL transformasi gambar

Untuk melakukan transformasi gambar dinamis, tambahkan parameter kueri imop ke URL gambar Anda. Parameter ini menyimpan string transformasi, yang terdiri dari satu atau beberapa operasi yang diterapkan secara berurutan.

String transformasi menggunakan aturan format berikut:

  • Gunakan titik koma (;) untuk memisahkan setiap operasi.
  • Gunakan koma (,) untuk memisahkan parameter internal dalam setiap operasi.
  • Hanya satu operasi dari jenis tertentu yang dapat disertakan dalam satu string kueri.

Sintaksis dasar menggunakan struktur berikut:

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

Untuk melakukan beberapa tindakan pada gambar secara bersamaan, tambahkan string parameter yang dirangkai ke URL gambar. Misalnya, untuk mengubah ukuran gambar menjadi lebar 800 piksel, tetapkan kualitas kompresi ke 85, dan konversi format ke WebP, tambahkan string parameter.

Misalnya,

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

Struktur kebijakan

Kebijakan pengoptimalan gambar berfungsi sebagai wrapper konfigurasi inti yang berisi setiap properti yang relevan dengan fungsi fitur pengoptimalan gambar.

Nama

Deskripsi

Konfigurasi

queryParameterInterpretation

Nilai enum yang menentukan apakah parameter kueri untuk pengoptimalan gambar akan ditafsirkan di bidang data.

Wajib diisi. Jika disetel ke DISABLED, parameter kueri untuk transformasi akan diabaikan oleh kebijakan, sehingga menonaktifkan fitur ini. Jika disetel ke DIAKTIFKAN, fitur ini akan diaktifkan.

Dependensi dan validasi kebijakan

Kebijakan pengoptimalan gambar memiliki dependensi pada caching Cloud CDN. Agar fitur ini berfungsi, Kebijakan Cache harus ditetapkan secara eksplisit di salah satu dari dua lokasi:

  • Rute peta URL yang sama tempat kebijakan Pengoptimalan gambar dikonfigurasi.

  • Layanan backend atau bucket backend yang terkait dengan rute tersebut.

Kebijakan pengoptimalan gambar diterapkan secara ketat bersama dengan Kebijakan Cache yang aktif dan mendasarinya.

Aturan pengurutan pengoptimalan gambar

Operasi yang tercantum dalam parameter kueri imop diproses dari kiri ke kanan, dengan pengecualian penggantian sistem absolut berikut:

  • Operasi metadata dan skala selalu dijalankan terlebih dahulu.
  • Operasi canvas selalu dijalankan terakhir.

Semua aset input mengalami normalisasi otomatis sebelum transformasi ini dijalankan. Penanda orientasi EXIF dan profil warna ICC diterapkan langsung ke piksel gambar sebelum metadata dihapus, sehingga memastikan integritas koordinat tetap akurat untuk tindakan struktural berikutnya.

Langkah berikutnya