התאמה אישית של מפתחות מטמון

בדף הזה מוסבר איך להתאים אישית את מפתחות המטמון של Cloud CDN.

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

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

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

לפני שמתחילים

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

הפעלת Cloud CDN והתאמה אישית של מפתחות המטמון

ההוראות האלה מפעילות את Cloud CDN לשירות קצה עורפי עם איזון עומסים ומבצעות התאמה אישית של מפתח המטמון. אם עדיין אין לכם מאזן עומסים שאפשר להשתמש בו כמקור, תוכלו לקרוא את ההוראות ליצירת מאזן עומסים חיצוני של אפליקציות (ALB) במאמר בנושא מאזן עומסים חיצוני של אפליקציות.

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

המסוף

1. נכנסים לדף Cloud CDN במסוף Google Cloud .

   מעבר אל Cloud CDN

2. לוחצים על שם המקור שרוצים לעדכן.

3. לוחצים על Edit.

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

4. כדי להרחיב את הקטע ביצועי מטמון, לוחצים על הבא.

5. בשדה מפתח מטמון, בוחרים באפשרות בהתאמה אישית.

6. בקטע Cache key components (רכיבי מפתח המטמון), כל הרכיבים מסומנים כברירת מחדל. מבטלים את הסימון של תיבות הסימון שליד כל רכיב שרוצים להחריג ממפתח המטמון.

7. לוחצים על סיום.

gcloud

כדי להחריג רכיב אחד או יותר ממפתחות המטמון של שירות קצה עורפי, משתמשים בפקודה gcloud compute backend-services update.

gcloud compute backend-services update BACKEND_SERVICE \
    --no-cache-key-include-protocol \
    --no-cache-key-include-host \
    --no-cache-key-include-query-string

כדי להשתמש בקטגוריות של שרתים עורפיים, מפעילים את הפקודה gcloud compute backend-buckets update.

API

כדי להחריג רכיב אחד או יותר ממפתח המטמון, צריך לציין אפשרויות הגדרה בקטע cacheKeyPolicy של cdnPolicy עבור משאב backendServices.

בשירותי קצה עורפי, משתמשים בקריאה ל-API של method‏ backendServices.update.

PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

כדי להשתמש בקטגוריות של קצה עורפי, משתמשים בקריאה ל-API של method ‏backendBuckets.update.

PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET

מוסיפים את הקטע הבא לגוף בקשת ה-JSON:

"cdnPolicy": {
  "cacheKeyPolicy": [
    {
      "includeProtocol": false,
      "includeHost": false,
      "includeQueryString": false
    }
  ]
}

עדכון מפתחות מטמון כדי להוסיף את הפרוטוקול, המארח ומחרוזת השאילתה

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

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

המסוף

1. נכנסים לדף Cloud CDN במסוף Google Cloud .

   מעבר אל Cloud CDN

2. לוחצים על שם המקור שרוצים לעדכן.

3. לוחצים על Edit.

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

4. כדי להרחיב את הקטע ביצועי מטמון, לוחצים על הבא.

5. בשדה מפתח מטמון, בוחרים באפשרות בהתאמה אישית.

6. בקטע Cache key components (רכיבי מפתח המטמון), מסמנים את תיבות הסימון Protocol (פרוטוקול), Host (מארח) ו-Query string (מחרוזת שאילתה).

7. לוחצים על סיום.

gcloud

כדי להוסיף רכיב אחד או יותר למפתחות המטמון של שירות קצה עורפי, משתמשים בפקודה gcloud compute backend-services update.

סימונים לא מוגדרים לא ישתנו.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-protocol \
    --cache-key-include-host \
    --cache-key-include-query-string

API

כדי להוסיף רכיב אחד או יותר למפתח המטמון, מציינים אפשרויות הגדרה בקטע cacheKeyPolicy של cdnPolicy עבור המשאב backendServices.

מוסיפים את הקטע הבא לגוף בקשת ה-JSON:

"cdnPolicy": {
  "cacheKeyPolicy": [
    {
      "includeProtocol": true,
      "includeHost": true,
      "includeQueryString": true
    }
  ]
}

עדכון מפתחות מטמון לשימוש ברשימת הכללה או החרגה של פרמטרים של מחרוזת שאילתה

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

המסוף

1. נכנסים לדף Cloud CDN במסוף Google Cloud .

   מעבר אל Cloud CDN

2. לוחצים על שם המקור שרוצים לעדכן.

3. לוחצים על Edit.

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

4. כדי להרחיב את הקטע ביצועי מטמון, לוחצים על הבא.

5. בשדה מפתח מטמון, בוחרים באפשרות בהתאמה אישית.

6. בקטע Cache key components, מסמנים את התיבה Query string. לאחר מכן, בוחרים באחת מהאפשרויות הבאות:

   • אם רוצים לציין פרמטרים של מחרוזת שאילתה שחייבים להיות חלק ממפתח המטמון, בוחרים באפשרות כולל רק את הפרמטרים שנבחרו.

   • אם רוצים לציין שכל הפרמטרים של מחרוזת השאילתה, חוץ מאלה שמפורטים, ייכללו במפתח המטמון, בוחרים באפשרות Include all but selected (כולל הכול חוץ מהפריטים שנבחרו).

7. לוחצים על Add parameter (הוספת פרמטר) ומציינים את הפרמטרים.

8. לוחצים על סיום.

gcloud

כדי לציין רשימת הכללה או רשימת החרגה לשירות קצה עורפי, מציינים פרמטרים של מחרוזת שאילתה באמצעות הפקודה gcloud compute backend-services update.

משתמשים בפקודה הזו כדי להגדיר את הפרמטר user של מחרוזת השאילתה לרשימת ההכללה של שירות לקצה העורפי.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-whitelist user

משתמשים בפקודה הזו כדי להגדיר את פרמטר מחרוזת השאילתה user לרשימת ההחרגות של שירות קצה עורפי.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-blacklist user

משתמשים בפקודה הזו כדי להגדיר את הפרמטר user של מחרוזת השאילתה לרשימת ההכללה של קטגוריית קצה עורפי.

gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-query-string-whitelist user

API

כדי לציין רשימת הכללה או רשימת החרגה לשירות קצה עורפי, צריך לציין פרמטרים של מחרוזת שאילתה בקטע cacheKeyPolicy של cdnPolicy עבור משאב backendServices.

כדי לציין רשימת הכללה, מוסיפים את קטע הקוד הבא לגוף הבקשה ב-JSON:

"cdnPolicy": {
  "cacheKeyPolicy": [
    {
      "queryStringWhitelist": [QUERY_STRINGS]
    }
  ]
}

מחליפים את QUERY_STRINGS ברשימה מופרדת בפסיקים של פרמטרים של מחרוזת שאילתה.

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

"cdnPolicy": {
  "cacheKeyPolicy": [
    {
      "queryStringBlacklist": [QUERY_STRINGS]
    }
  ]
}

עדכון מפתחות המטמון לשימוש בכותרות HTTP

הערה: חשוב לוודא שאתם משתמשים בגרסה 369.0.0 ואילך של ה-CLI של gcloud.

בהוראות האלה מוגדרים מפתחות מטמון של Cloud CDN לשימוש בכותרות HTTP, שיכולות לכלול משתנים מותאמים אישית מותרים.

המסוף

1. נכנסים לדף Cloud CDN במסוף Google Cloud .

   מעבר אל Cloud CDN

2. לוחצים על שם המקור שרוצים לעדכן.

3. לוחצים על Edit.

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

4. כדי להרחיב את הקטע ביצועי מטמון, לוחצים על הבא.

5. בשדה מפתח מטמון, בוחרים באפשרות בהתאמה אישית.

6. בקטע Cache key components, מסמנים את התיבה HTTP headers.

7. כדי לציין כותרת HTTP אחת או יותר, לוחצים על הוספת כותרת HTTP.

8. לוחצים על סיום.

gcloud

משתמשים בפקודה gcloud compute backend-services update עם האפשרות cache-key-include-http-header.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-http-header=[HEADER_FIELD_NAMES,...]

מחליפים את HEADER_FIELD_NAMES ברשימה מופרדת בפסיקים של שמות כותרות.

API

מציינים כותרות HTTP למפתחות מטמון בקטע cacheKeyPolicy של cdnPolicy עבור המשאב backendServices.

מוסיפים את הקטע הבא לגוף בקשת ה-JSON:

"cdnPolicy": {
  "cacheKeyPolicy": [
    {
      "includeHttpHeaders": [HEADER_FIELD_NAMES]
    }
  ]
}

מחליפים את HEADER_FIELD_NAMES ברשימה מופרדת בפסיקים של שמות כותרות.

אם כותרת מפתח המטמון שצוינה מוגדרת גם ככותרת בקשה מותאמת אישית, אי אפשר להשתמש בטווח המלא של המשתנים.

מידע נוסף זמין במאמר שימוש במשתנים מותאמים אישית עם כותרות של בקשות.

עדכון מפתחות מטמון לשימוש בקובצי Cookie עם שמות

הערה: חשוב לוודא שאתם משתמשים בגרסה 369.0.0 ואילך של ה-CLI של gcloud.

ההוראות האלה מגדירות את מפתחות המטמון של Cloud CDN לשימוש בקובצי Cookie של HTTP.

המסוף

1. נכנסים לדף Cloud CDN במסוף Google Cloud .

   מעבר אל Cloud CDN

2. לוחצים על שם המקור שרוצים לעדכן.

3. לוחצים על Edit.

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

4. כדי להרחיב את הקטע ביצועי מטמון, לוחצים על הבא.

5. בשדה מפתח מטמון, בוחרים באפשרות בהתאמה אישית.

6. בקטע Cache key components (רכיבי מפתח מטמון), מסמנים את התיבה Named cookies (קובצי Cookie עם שם).

7. כדי לציין קובץ Cookie אחד או יותר, לוחצים על הוספת קובץ Cookie עם שם.

8. לוחצים על סיום.

gcloud

משתמשים בפקודה gcloud compute backend-services update עם האפשרות cache-key-include-named-cookie.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-named-cookie=[NAMED_COOKIES,...]

מחליפים את NAMED_COOKIES ברשימה מופרדת בפסיקים של קובצי Cookie עם שמות.

API

כדי לציין רשימת הכללה או רשימת החרגה לשירות קצה עורפי, צריך לציין פרמטרים של מחרוזת שאילתה בקטע cacheKeyPolicy של cdnPolicy עבור משאב backendServices.

כדי לציין רשימת הכללה, מוסיפים את קטע הקוד הבא לגוף הבקשה ב-JSON:

"cdnPolicy": {
  "cacheKeyPolicy": [
    {
      "includeNamedCookies": [NAMED_COOKIES]
    }
  ]
}

מחליפים את NAMED_COOKIES ברשימה מופרדת בפסיקים של פרמטרים של מחרוזת שאילתה.

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

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