צירוף פלאגין לנתיב Media CDN

בדף הזה מוסבר איך להגדיר פלאגינים של Service Extensions בנתיבי Media CDN.

אפשר להשתמש ב-Media CDN עם Service Extensions כדי להוסיף קוד מותאם אישית לנתיב העיבוד של בקשות ותשובות. התאמה אישית כזו מאפשרת מגוון רחב של תרחישי שימוש קלים.

למידע נוסף על תוספים ל-Media CDN

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

1. יצירת מקור של Media CDN
2. יצירת שירות Media CDN
3. יצירת פלאגין באמצעות Service Extensions

יצירת פעולת Wasm לתוסף

כשיוצרים פעולת Wasm, אי אפשר להשתמש בתוסף שכבר נמצא בשימוש בתוסף Cloud Load Balancing.

כדי ליצור פעולת Wasm עבור הפלאגין Service Extensions, מריצים את הפקודה gcloud alpha service-extensions wasm-actions create:

gcloud alpha service-extensions wasm-actions create WASM_ACTION \
    --wasm-plugin=WASM_PLUGIN \
    --supported-events=[EVENT,...]

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

• ‫WASM_ACTION: המזהה או השם המוגדר במלואו של פעולת ה-Wasm
• ‫WASM_PLUGIN: שם הפלאגין שאליו רוצים לצרף את הפעולה
• ‫EVENT: החלק של מטען הייעודי (payload) שיעובד על ידי הפלאגין, כפי שמצוין על ידי אחד מהערכים הבאים או שניהם: request-headers או response-headers. אם לא מציינים את הפרמטר הזה, המערכת מעבדת את שני ההידרים.

יכול להיות שיעבור זמן מה עד שפעולת ה-Wasm תיצור את עצמה.

צירוף פלאגין למסלול

כדי לצרף פלאגין לנתיב ב-Media CDN, פועלים לפי השלבים הבאים:

1. כדי לייצא את התצורה הנוכחית של השירות לקובץ YAML, מריצים את הפקודה gcloud edge-cache services export:

     gcloud edge-cache services export SERVICE_NAME \
         --destination=FILENAME.yaml
   

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

   • ‫SERVICE_NAME: השם של שירות Media CDN
   • ‫FILENAME: השם של קובץ ה-YAML

2. משתמשים בכלי לעריכת טקסט כדי לערוך את קובץ ה-YAML.

3. מעדכנים את הנתיבים בקובץ כדי להוסיף את הכותרת wasmAction, כמו בדוגמה הבאה:

     name: SERVICE_NAME
     routing:
       hostRules:
       - hosts:
         - DOMAIN_NAME 
         pathMatcher: routes
       pathMatchers:
       - name: routes
         routeRules:
         - priority: '1'
           description: Route 1
           matchRules:
           - prefixMatch: /plugins
           origin: projects/PROJECT_NUMBER/locations/global/edgeCacheOrigins/ORIGIN_NAME
           routeAction:
             wasmAction: projects/PROJECT_NUMBER/locations/global/wasmActions/WASM_ACTION
   

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

   • ‫SERVICE_NAME: השם של שירות Media CDN
   • ‫DOMAIN_NAME: הדומיין של שירות Media CDN
   • ‫PROJECT_NUMBER: מספר הפרויקט
   • ‫ORIGIN_NAME: המקור של התוכן
   • WASM_ACTION: הפעולה Service Extensions Wasm

4. שומרים את קובץ ה-YAML.

5. מריצים את הפקודה gcloud edge-cache services import:

     gcloud edge-cache services import SERVICE_NAME \
         --source=FILENAME.yaml
   

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

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

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