תחילת העבודה

בדף הזה מוסבר איך להתחיל להשתמש באופטימיזציה של תמונות ב-Cloud CDN. תוכלו לקרוא כאן על הגדרת האופטימיזציה של תמונות ועל רשימת הפעולות הנתמכות, עם דוגמאות.

דרישות מוקדמות

כדי שאופטימיזציה של תמונות ב-Cloud CDN תפעל, צריך לוודא שמתקיימים התנאים המוקדמים הבאים:

  • צריך להפעיל את מדיניות המטמון של Cloud CDN בנתיב של כתובת ה-URL או בשירות לקצה העורפי או בקטגוריה המשויכים, ולהפעיל את תכונת אופטימיזציית התמונות במפת URL זו.

  • אפשר לבצע אופטימיזציה של תמונות רק במאזני עומסים גלובליים חיצוניים של אפליקציות (ALB). אי אפשר לבצע אופטימיזציה במאזני עומסים קלאסיים של אפליקציות.

  • בקשת הלקוח חייבת לכלול כותרת Accept שמציינת שהלקוח יכול לקבל תוכן תמונה, כמו image/webp, image/avif, image/* או */*.

  • שרת המקור צריך להגיב עם HTTP 200 קוד סטטוס וכותרת של תמונה נתמכתContent-Type.

  • פרמטר השאילתה imop צריך להיכלל בכתובת ה-URL ולהכיל פעולת טרנספורמציה אחת או יותר.

הגדרת אופטימיזציה של תמונות

כדי להשתמש באופטימיזציה של תמונות, צריך להפעיל את Cloud CDN בנתיב הרלוונטי, בשירות הקצה העורפי או בקטגוריית הקצה העורפי.

gcloud

צריך להוסיף הגדרות לקובץ ה-YAML ולייבא אותו למפת URL, כי מדיניות האופטימיזציה של התמונות מוגדרת בתוך האובייקט routeAction.

מייצאים את ההגדרה הקיימת של מפת URL לקובץ 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

ייבוא של מפת ה-URL המעודכנת

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

כתובת URL של טרנספורמציה של תמונה

כדי לבצע שינויים בתמונה דינמית, מוסיפים את פרמטר השאילתה imop לכתובת ה-URL של התמונה. הפרמטר הזה מכיל מחרוזת של טרנספורמציה, שמורכבת מפעולה אחת או יותר שמוחלות ברצף.

מחרוזת ההמרה מבוססת על כללי הפורמט הבאים:

  • משתמשים בנקודה-פסיק (;) כדי להפריד בין כל פעולה בנפרד.
  • כדי להפריד בין הפרמטרים הפנימיים בכל פעולה, משתמשים בפסיק (,).
  • מחרוזת שאילתה יכולה לכלול רק פעולה אחת מסוג מסוים.

התחביר של תנאי הבסיס הוא:

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

כדי לבצע כמה פעולות על תמונה בו-זמנית, מוסיפים לכתובת ה-URL של התמונה מחרוזת של פרמטרים מחוברים. לדוגמה, כדי לשנות את גודל התמונה לרוחב של 800 פיקסלים, להגדיר את איכות הדחיסה ל-85 ולהמיר את הפורמט ל-WebP, מוסיפים את מחרוזת הפרמטרים.

לדוגמה,

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

מבנה המדיניות

מדיניות אופטימיזציית התמונות פועלת כעטיפת הגדרה מרכזית שמכילה כל נכס שרלוונטי לפונקציונליות של התכונה 'אופטימיזציית תמונות'.

שם

תיאור

Configuration

queryParameterInterpretation

ערך Enum שקובע אם פרמטר השאילתה לאופטימיזציה של תמונות יפורש במישור הנתונים.

חובה. אם המדיניות מוגדרת כ-DISABLED, המערכת תתעלם מפרמטרים של שאילתות לצורך שינוי, וכך התכונה הזו תושבת. אם המדיניות מוגדרת לערך ENABLED, התכונה הזו תופעל.

תלות במדיניות ואימות

מדיניות האופטימיזציה של התמונות תלויה בשמירה במטמון של Cloud CDN. כדי שהתכונה הזו תפעל, צריך להגדיר במפורש מדיניות מטמון באחד משני המיקומים הבאים:

  • אותו מסלול של מיפוי כתובות URL שבו מוגדרת מדיניות האופטימיזציה של התמונות.

  • שירות לקצה העורפי או קטגוריית קצה עורפי שקשורים למסלול הספציפי הזה.

המדיניות בנושא אופטימיזציה של תמונות חלה באופן מחמיר בשילוב עם מדיניות המטמון הפעילה והבסיסית.

כללי סדר לאופטימיזציה של תמונות

הפעולות שמפורטות בפרמטר השאילתה imop מעובדות משמאל לימין, למעט חריגים של שינויים מוחלטים במערכת:

  • פעולות שקשורות למטא-נתונים ולקנה מידה תמיד מבוצעות קודם.
  • פעולות canvas תמיד מבוצעות אחרונות.

כל נכסי הקלט עוברים נורמליזציה אוטומטית לפני שההמרות האלה מבוצעות. סמני הכיוון של EXIF ופרופילי הצבע של ICC מוחלים ישירות על הפיקסלים של התמונה לפני הסרת המטא-נתונים, כדי להבטיח ששלמות הקואורדינטות תישאר מדויקת לפעולות מבניות עתידיות.

המאמרים הבאים