הגדרת מוצא

יש הרבה דרכים להגדיר מקורות ב-Media CDN. בדף הזה מוסבר איך להגדיר מקורות.

הגדרת קטגוריה של Cloud Storage כמקור

‫Media CDN תומך בקטגוריות של Cloud Storage כרכיבי backend לתוכן. כל שירות יכול להפנות לכמה קטגוריות על ידי הגדרת נתיבים למארח, לנתיבים ולמאפייני בקשה אחרים.

כדי להגדיר קטגוריות של Cloud Storage, משתמשים בכתובת ה-URL של הקטגוריה (למשל gs://my-bucket) בתור כתובת המקור כשיוצרים משאב מקור.

המסוף

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

    כניסה ל-Media CDN

  2. לוחצים על הכרטיסייה מקורות.

  3. ‫Create origin.

  4. מזינים שם למקור. לדוגמה: cloud-storage-origin.

  5. אופציונלי: מזינים תיאור.

  6. בשדה Origin address, בוחרים באפשרות Select a Google Cloud Storage bucket.

  7. עוברים לקטגוריה של Cloud Storage ובוחרים אותה.

  8. ב-Cloud Storage, משאירים את הגדרות ברירת המחדל של הפרוטוקול והיציאה.

  9. אופציונלי: כדי ששינויים בכותרת של בקשת המקור יקבלו קדימות על פני כותרות שנשלחות על ידי הלקוח או ששונו על ידי פעולות בכותרות ברמת הנתיב, מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות הפעלת שינוי מקור.
    2. בקטע Headers, מציינים כותרות על ידי הוספה של צמד אחד או יותר של שם-ערך.
  10. אופציונלי: בוחרים מקור ליתירות כשל כדי לנסות במקרה שלא ניתן להגיע למקור הזה. אפשר לעדכן את השדה הזה מאוחר יותר.

  11. בוחרים תנאי הפניה אוטומטית.

  12. בוחרים תנאים לניסיון חוזר.

  13. בקטע Max attempts, בוחרים את מספר הניסיונות המקסימלי למילוי המטמון מהמקור הזה.

  14. אופציונלי: מציינים את ערכי timeout הבאים:

    1. בשדה Connect timeout, בוחרים את משך הזמן המקסימלי להמתנה עד ליצירת החיבור למקור.
    2. בשדה Response timeout, בוחרים את משך הזמן המקסימלי להשלמת התגובה.
    3. בשדה Read timeout, בוחרים את משך הזמן המקסימלי להמתנה בין קריאות של חיבור HTTP או סטרימינג יחיד.
  15. אופציונלי: לוחצים על הוספת תווית ומציינים צמד מפתח/ערך אחד או יותר.

  16. לוחצים על Create origin.

gcloud

משתמשים בפקודה gcloud edge-cache origins create:

gcloud edge-cache origins create ORIGIN \
    --origin-address=ADDRESS

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ORIGIN: השם של המקור החדש
  • ‫ADDRESS: שם הקטגוריה, לדוגמה gs://my-bucket

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

כשמגדירים שירות, אפשר לנתב את תוכן הווידאו על פי דרישה (VOD) לקטגוריה אחת ואת תוכן הסטרימינג בשידור חי לקטגוריה שנייה. האפשרות הזו שימושית אם יש לכם צוותים שונים שמנהלים כל תהליך עבודה. כדי לצמצם את זמן האחזור של מילוי המטמון, אפשר לנתב באופן דומה את האזור eu-media.example.com לקטגוריה של Cloud Storage במספר אזורים שנמצאת באיחוד האירופי, ואת האזור us-media.example.com (או להתאים לפי נתיב, כותרת או פרמטר של שאילתה) לקטגוריית אחסון שנמצאת בארה"ב.

קטגוריות של Media CDN.
קטגוריות של Media CDN (לחצו כדי להגדיל).

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

אימות בקשות

כדי לוודא שבקשה מגיעה מ-Media CDN, אתם יכולים להשתמש באחת מהשיטות הנתמכות הבאות:

  • מוודאים שכתובת ה-IP המתחברת היא מטווחים למילוי המטמון של Media CDN. הטווחים האלה משותפים לכל הלקוחות, אבל משאבי EdgeCacheService תמיד משתמשים בהם כשהם מתחברים למקור.
  • מוסיפים request header בהתאמה אישית עם ערך אסימון שמאמתים במקור (לדוגמה, ערך אקראי של 16 בייטים). לאחר מכן, המקור יכול לדחות בקשות שלא כוללות את הערך הזה.

הגדרת פרוטוקול מקור

אם המקור תומך ב-HTTP/2, לא צריך להגדיר את הפרוטוקול באופן מפורש. במקורות שתומכים רק ב-HTTPS (‏HTTP/1.1 over TLS) או ב-HTTP/1.1 (בלי TLS), צריך להגדיר את השדה protocol באופן מפורש:

המסוף

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

    כניסה ל-Media CDN

  2. לוחצים על הכרטיסייה מקורות.

  3. בוחרים את המקור ולוחצים על עריכה.

  4. בוחרים את הפרוטוקול HTTPS או HTTP. בשביל HTTP, מציינים גם את היציאה 80.

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

gcloud

משתמשים בפקודה gcloud edge-cache origins update:

gcloud edge-cache origins update LEGACY_ORIGIN \
    --protocol=HTTPS

מחליפים את LEGACY_ORIGIN בשם של נקודת המוצא.

הגדרת קטגוריות פרטיות של Cloud Storage

‫Media CDN יכול לשלוף תוכן מכל נקודת קצה (endpoint) של HTTP או HTTPS שאפשר להגיע אליה דרך האינטרנט. במקרים מסוימים, יכול להיות שתרצו לדרוש אימות כדי לאפשר רק ל-Media CDN לשלוף תוכן, ולמנוע גישה לא מורשית. ב-Cloud Storage אפשר לעשות את זה באמצעות הרשאות IAM.

במקורות של Cloud Storage, מבצעים את הפעולות הבאות:

  • מקצים לחשבון השירות של Media CDN תפקיד שכולל את הרשאת ה-IAM‏ storage.objects.get בקטגוריות של Cloud Storage שמשמשות כמקורות. לדוגמה, אפשר להקצות את התפקיד roles/storage.legacyObjectReader (roles/storage.legacyObjectReader) או תפקיד בהתאמה אישית שכולל את ההרשאה storage.objects.get. התפקיד roles/storage.objectViewer (roles/storage.objectViewer) כולל את ההרשאה storage.objects.list, לכן אל תקצו אותו אלא אם אתם רוצים שהלקוחות יוכלו להציג את רשימת האובייקטים בקטגוריה.
  • מסירים את ההרשאה allUsers.
  • אופציונלי: מסירים את ההרשאה allAuthenticatedUsers.

כדי לשנות את ההרשאות של קטגוריה ב-Cloud Storage, צריך את התפקיד "אדמין של אחסון" (roles/storage.admin).

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

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

כדי לתת ל-Media CDN את ההרשאה storage.objects.get בקטגוריה, צריך להקצות לחשבון השירות את התפקיד roles/storage.legacyObjectReader או תפקיד בהתאמה אישית שכולל את ההרשאה הזו:

gcloud storage buckets add-iam-policy-binding gs://BUCKET \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-mediaedgefill. \
    --role=roles/storage.legacyObjectReader

מחליפים את מה שכתוב בשדות הבאים:

  • ‫BUCKET: שם הקטגוריה
  • ‫PROJECT_NUMBER: מספר הפרויקט שמכיל את משאבי Media CDN.

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

משתמשים בפקודה gcloud storage buckets remove-iam-policy-binding כדי להסיר את ההרשאות שניתנו לתפקיד allUsers בקטגוריה הנתונה. לדוגמה, אם הקטגוריה מעניקה ל-allUsers את התפקיד objectViewer, מסירים את ההרשאה באמצעות הפקודה הבאה:

gcloud storage buckets remove-iam-policy-binding gs://BUCKET \
    --member=allUsers --role=roles/storage.objectViewer

כדי לוודא שהגישה הציבורית הוסרה, פותחים חלון פרטי בדפדפן ומנסים לגשת לאובייקט בקטגוריה באמצעות https://storage.googleapis.com/BUCKET/object.ext.

כדי לאפשר למשאבי EdgeCacheService בפרויקט אחד לגשת לקטגוריה של Cloud Storage בפרויקט אחר, אתם יכולים לתת לחשבון השירות של Media CDN בפרויקט הזה גישה לקטגוריית האחסון.

כדי לעשות את זה, מוודאים שהערך של PROJECT_NUMBER ב-service-PROJECT_NUMBER@gcp-sa-mediaedgefill. הוא מספר הפרויקט עם משאבי ה-EdgeCacheService שצריכים גישה. אתם יכולים לחזור על הפעולה הזו בכמה פרויקטים, במיוחד אם בחלק מהם יש סביבות שונות של Media CDN (כמו פיתוח, Staging או ייצור) ובפרויקט נפרד נמצאים נכסי המדיה או הווידאו שלכם.

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

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

הגדרת מאזן עומסים חיצוני של אפליקציות (ALB) כמקור

אם אתם צריכים בדיקת תקינות פעילה, הקצאה בשיטת Round-Robin או ניתוב לפי עומס ב-Compute Engine, ב-GKE או במקורות מקומיים, אתם יכולים להגדיר מאזן עומסים חיצוני של אפליקציות (ALB) כמקור.

כך אפשר להגדיר (לדוגמה) את חבילות הסטרימינג בשידור חי מאחורי Media CDN או קבוצה של שרתי proxy של Envoy שמנוהלים על ידי Cloud Service Mesh כדי להתחבר חזרה לתשתית המקומית.

מאזני עומסים מאפשרים להגדיר קצוות עורפיים לפעולות הבאות:

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

‫ פריסת שמירה במטמון קצה.
פריסת שמירה במטמון קצה (לחצו כדי להגדיל).

כדי להגדיר מאזן עומסים חיצוני של אפליקציות (ALB) כמקור, צריך ליצור משאב מקור עם כתובת ה-IP או שם המארח הציבורי שמפנים לכללי ההעברה של מאזן העומסים. עדיף להשתמש בשם מארח ציבורי (שם דומיין), כי הוא נדרש לאישור SSL‏ (TLS) ולגרסאות HTTP מודרניות (HTTP/2 ו-HTTP/3).

בנוסף, צריך לאשר את הפרטים הבאים:

  • למאזן העומסים יש נתיב שתואם לשם המארח שמשמש למשאב EdgeCacheService, או שהגדרתם urlRewrite.hostRewrite לנתיבים שבהם מאזן העומסים מוגדר כמקור.
  • למאזן העומסים יש אישור SSL (TLS)‎ מהימן שמוגדר באופן ציבורי לשמות המארחים האלה.

לדוגמה, אם שם הדומיין הציבורי שמצביע על כלל ההעברה של מאזן העומסים הוא origin-packager.example.com, צריך ליצור מקור שבו originAddress מוגדר לשם הזה.

המסוף

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

    כניסה ל-Media CDN

  2. לוחצים על הכרטיסייה מקורות.

  3. ‫Create origin.

  4. מזינים שם למקור. לדוגמה: load-balancer-origin.

  5. אופציונלי: מזינים תיאור.

  6. בשדה Origin address, בוחרים באפשרות Specify a FQDN or כתובת IP.

  7. מזינים את ה-FQDN או את כתובת ה-IP של מאזן העומסים של Google Cloud .

  8. אופציונלי: בוחרים מקור ליתירות כשל כדי לנסות במקרה שלא ניתן להגיע למקור הזה. אפשר לעדכן את השדה הזה מאוחר יותר.

  9. בוחרים תנאים לניסיון חוזר.

  10. בקטע Max attempts, בוחרים את מספר הניסיונות המקסימלי למילוי המטמון מהמקור הזה.

  11. אופציונלי: מציינים את ערכי timeout הבאים:

    1. בשדה Connect timeout, בוחרים את משך הזמן המקסימלי להמתנה עד ליצירת החיבור למקור.
    2. בשדה Response timeout, בוחרים את משך הזמן המקסימלי להשלמת התגובה.
    3. בשדה Read timeout, בוחרים את משך הזמן המקסימלי להמתנה בין קריאות של חיבור HTTP או סטרימינג יחיד.
  12. אופציונלי: לוחצים על הוספת תווית ומציינים צמד מפתח/ערך אחד או יותר.

  13. לוחצים על Create origin.

gcloud

משתמשים בפקודה gcloud edge-cache origins create:

gcloud edge-cache origins create LB_ORIGIN \
    --origin-address=LB_ADDRESS

מחליפים את מה שכתוב בשדות הבאים:

  • ‫LB_ORIGIN: שם המקור
  • ‫LB_ADDRESS: ה-FQDN או כתובת ה-IP, לדוגמה origin-packager.example.com

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

הגדרת אזור ל-Flexible Shielding

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

המסוף

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

    כניסה ל-Media CDN

  2. לוחצים על הכרטיסייה מקורות.

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

  4. כדי לעבור למצב עריכה, לוחצים על הכפתור עריכה.

  5. בקטע Origin controls, בוחרים באפשרות Flexible shielding (custom) בשדה Origin shielding. האזור הקרוב ביותר נבחר באופן אוטומטי. אם האזור הכי קרוב לא מופיע ברשימה, בוחרים ידנית ערך מרשימת האזורים הזמינים. הערכים התקינים הם africa-south1,‏ europe-west3,‏ me-central1 ו-us-east5.

  6. כדי לשמור את השינויים, לוחצים על עדכון המקור.

כדי להחזיר את ההגנה להגנת ברירת המחדל, מעדכנים את המקור ובוחרים באפשרות Origin shielding (default).

gcloud

כדי להגדיר הגנה גמישה לאזור במקור קיים, משתמשים בפקודה gcloud edge-cache origins update:

gcloud edge-cache origins update ORIGIN \
    --origin-address=ADDRESS \
    --flex-shielding=REGION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ORIGIN: שם המקור
  • ‫ADDRESS: כתובת המקור
  • ‫REGION: האזור של הגנת המקור. הערכים התקינים הם africa-south1,‏ europe-west3,‏ me-central1 ו-us-east5. כדי להחזיר את ההגנה להגנת המקור שמוגדרת כברירת מחדל, מריצים את אותה פקודה אחרי שמגדירים את האפשרות flex-shielding כריקה.

yaml

כדי להגדיר הגנה על המקור לאזור במקור קיים, מוסיפים קטע flexShielding להגדרת המשאב EdgeCacheOrigin:

name: ORIGIN
originAddress: ADDRESS
# ... Other fields
flexShielding:
  flexShieldingRegions:
    - REGION
# ... Other fields

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ORIGIN: שם המקור
  • ‫ADDRESS: כתובת המקור
  • ‫REGION: האזור של הגנת המקור. הערכים התקינים הם africa-south1,‏ europe-west3,‏ me-central1 ו-us-east5.

כדי להחזיר את הגדרת ברירת המחדל של הגנת המקור, מסירים את הקטע flexShielding.

הגדרת יתירות כשל במקור

בקטעים הבאים מוסבר איך להגדיר את ההתנהגות של יתירות כשל במקור.

יתירות כשל במקור ללא מעקב אחרי הפניה אוטומטית

ההגדרה הבסיסית הבאה של EdgeCacheOrigin ליתירות כשל:

name: FAILOVER_ORIGIN
originAddress: FAILOVER_DOMAIN_NAME

‫Media CDN מנסה שוב את המקור הראשי של המסלול עד שלוש פעמים לפני שהוא מנסה את המקור ליתירות כשל. בהגדרה הזו, אחרי שלושה ניסיונות בשרת המקור הראשי, Media CDN מנסה לשלוח בקשה אחת אל FAILOVER_ORIGIN. אם גם המקור ליתירות כשל לא מגיב בהצלחה, Media CDN מחזיר את כל התגובה של המקור, או אם לא מתקבל קוד סטטוס, תגובת HTTP 502 Bad Gateway.

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

בדוגמה הבאה מוצגת הגדרה ששולחת בקשות מילוי אל MY_ORIGIN. ההגדרה הזו גורמת ל-Media CDN לנסות שוב במקרה של שגיאות בחיבור (כמו שגיאות DNS,‏ TCP או TLS), תגובות HTTP 5xx מהמקור או HTTP 404 Not Found. אחרי שני ניסיונות, הוא עובר ל-FAILOVER_ORIGIN.

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

name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2 # the number of attempts to make before trying the failoverOrigin
failoverOrigin: FAILOVER_ORIGIN
# what conditions trigger a retry or failover
retryConditions:
- CONNECT_FAILURE
- HTTP_5xx # any HTTP 5xx response
- NOT_FOUND # retry on a HTTP 404
timeout:
  maxAttemptsTimeout: 10s # set a deadline for all retries and failover

יתירות כשל במקור עם מעקב אחרי הפניות אוטומטיות

לדוגמה, נניח שהגדרתם את המשאבים הבאים של EdgeCacheOrigin, והמסלולים של המשאב EdgeCacheService מוגדרים להשתמש ב-PrimaryOrigin למילוי המטמון:

name: PrimaryOrigin
originAddress: "primary.example.com"
maxAttempts: 2
failoverOrigin: "SecondaryOrigin"
retryConditions: [CONNECT_FAILURE]
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]
name: SecondaryOrigin
originAddress: "secondary.example.com"
maxAttempts: 3
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]

בדוגמה הזו, כש-Media CDN מבצע מילוי מטמון, הוא קורא את ההגדרות של PrimaryOrigin ומגיב בהתאם.

נניח ש-Media CDN מתחבר אל primary.example.com בניסיון הראשון ליצור קשר עם המקור. אם primary.example.com מחזיר תגובה מוצלחת, Media CDN משתמש בתגובה הזו למילוי המטמון.

נניח שעכשיו primary.example.com מחזיר HTTP 302 Found Redirect אל Location: b.example.com. בניסיון השני ליצור קשר עם המקור, Media CDN עוקב אחרי ההפניה האוטומטית אל b.example.com. במקרה כזה, Media CDN מבצע את הפעולות הבאות:

  • אם b.example.com מחזיר תגובה מוצלחת, Media CDN משתמש בתגובה הזו למילוי המטמון.
  • אם b.example.com מחזיר הפניה או תגובת כשל, Media CDN עובר ל-SecondaryOrigin שהוגדר. הסיבה לכך היא שבדוגמה הזו, PrimaryOrigin מוגדר לשני maxAttempts.

אם Media CDN עובר לגיבוי בעת כשל אל SecondaryOrigin, הוא משתמש בהגדרות של SecondaryOrigin ומנסה להתחבר אל secondary.example.com. זהו הניסיון הראשון ליצור קשר עם המקור, והניסיון השלישי בסך הכול.

במקרה כזה, Media CDN מבצע את הפעולות הבאות:

  • אם secondary.example.com מחזיר תגובה מוצלחת, Media CDN משתמש בתגובה הזו למילוי המטמון.
  • אם secondary.example.com מחזיר HTTP 302 Found Redirect ל-Location: c.example.com, ‏Media CDN מנסה ליצור קשר עם c.example.com. בדוגמה הזו, זהו הניסיון השני של SecondaryOrigin והניסיון הרביעי בסך הכול.

אם הניסיון ליצור קשר עם c.example.com מחזיר תגובה מוצלחת, Media CDN משתמש בתגובה הזו למילוי המטמון. אם הניסיון מחזיר הפניה אוטומטית ש-Media CDN מוגדר לעקוב אחריה, Media CDN מחזיר קוד סטטוס HTTP 502 Bad Gateway כי הוא מיצה את מספר הניסיונות המקסימלי ליצירת קשר עם מקור. ב-Media CDN מתבצעים לכל היותר ארבעה ניסיונות בכל המקורות, בלי קשר להגדרות של EdgeCacheOrigin. לבסוף, אם Media CDN לא מצליח ליצור קשר עם c.example.com, הוא מחזיר תגובה מסוג 504 Gateway Timeout או 502 Bad Gateway.

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

הגדרת הפניות אוטומטיות למקור

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

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

כדי לאפשר הפניות אוטומטיות למקור, מוסיפים את ההגדרה הבאה למשאב EdgeCacheOrigin:

name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]

‫Media CDN משתמש בפרוטוקול שצוין בהפניות האוטומטיות כדי להגיע לכל השרתים. מוודאים שכל השרתים שאליהם Media CDN עשוי להפנות תומכים בפרוטוקולים הנדרשים. באופן ספציפי, אם הפרוטוקול מוגדר ל-HTTPS, ל-HTTP/2 או ל-HTTP/3,‏ Media CDN לא חוזר לחיבורי HTTP/1.1 כדי לעקוב אחרי הפניות לא מאובטחות. כותרת המארח שנשלחה למקור שאליו הופניתם תואמת לכתובת ה-URL שאליה הופניתם. ב-Media CDN מתבצעת הפניה אוטומטית אחת לכל ניסיון של EdgeCacheOrigin לפני החזרת התגובה הסופית או הערכת התנאים לניסיון חוזר או ליתירות כשל.

ההגדרה redirectConditions מציינת אילו קודי תגובת HTTP גורמים ל-Media CDN לבצע הפניה אוטומטית לכל מקור.

תנאי תיאור
MOVED_PERMANENTLY מעקב אחרי הפניה אוטומטית לקוד התגובה HTTP 301
FOUND מעקב אחרי הפניה אוטומטית לקוד התגובה HTTP 302
SEE_OTHER מעקב אחרי הפניה אוטומטית לקוד התגובה HTTP 303
TEMPORARY_REDIRECT מעקב אחרי הפניה אוטומטית לקוד התגובה HTTP 307
PERMANENT_REDIRECT מעקב אחרי הפניה אוטומטית לקוד התגובה HTTP 308

הגדרת שכתובים של מארחים או שינויים של כותרות ספציפיים למקור

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

name: FAILOVER_ORIGIN
originAddress: FAILOVER_ORIGIN_HOST"
originOverrideAction:
  urlRewrite:
    hostRewrite: FAILOVER_ORIGIN_HOST"
  headerAction:
    requestHeadersToAdd:
    - headerName: "Authorization"
      headerValue: "AUTH-KEY"
      replace: true

ההגדרה originOverrideAction.hostRewrite מקבלת עדיפות על פני כל כתיבה מחדש של כותרות שמוגדרת בנתיבים שמפנים למקור הזה.

אפשר להשתמש ב-requestHeadersToAdd כותרות ייחודיות לכל מקור, שמתבקשות על ידי המקור הספציפי הזה. תרחיש נפוץ לדוגמה הוא הוספת כותרות Authorization סטטיות. מכיוון שהשינויים האלה בכותרות פועלים במהלך בקשת המקור, כותרות שנוספות לכל מקור מחליפות כותרות קיימות עם אותו שם שדה או מתווספות אליהן. כברירת מחדל, Media CDN מוסיף לכותרות הקיימות. כדי להחליף כותרות קיימות, מגדירים את headerAction.replace ל-true.

שינויים בכותרות ספציפיות למקור משתמשים רק בערכי כותרות סטטיים. משתני כותרת דינמיים כמו {client_region} לא נתמכים.

במאמר הגדרת כותרות בהתאמה אישית מוסבר איך מגדירים כותרות של בקשות לכל נתיב.

פתרון בעיות במקורות

אם מקור מסוים לא פועל כמו שצריך, אפשר לעיין במאמר פתרון בעיות במקורות.

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