ניהול תוספים

בדף הזה מוסבר איך להציג, לערוך ולמחוק פלאגינים שנוצרו באמצעות Service Extensions.

התכונה "פלאגינים" נמצאת בגרסת טרום-השקה (Preview) ב-Media CDN.

לסקירה כללית על המוצר, קראו את המאמר סקירה כללית על תוספי שירות.

הצגת הפלאגינים

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

הצגת רשימת הפלאגינים

כדי להציג את הפלאגינים בפרויקט:

המסוף

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

   כניסה לדף Service Extensions

2. לוחצים על הכרטיסייה Plugins (יישומי פלאגין).

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

   • סטטוס: הסטטוס של הפלאגין. אם לא מחובר שירות, הערך הוא Not attached. אם השירות מצורף לפלאגין, הערך הוא Attached.
   • ‫Name: שם הפלאגין.
   • גרסה ראשית: הגרסה הפעילה של הפלאגין.
   • מוצר: Google Cloud המוצר שאליו הפלאגין מצורף.
   • סוג: סוג התוסף.
   • ‫Scope: היקף הפלאגין.
   • ‫Region: האזור, כשהיקף הפלאגין הוא Regional.
   • בשימוש על ידי: תוסף אחד או יותר שהפלאגין משויך אליהם.
   • השינוי האחרון: הזמן שבו הפלאגין השתנה לאחרונה.
   • תוויות: התוויות שנוספו לפלאגין.

3. אופציונלי: כדי לסנן את הרשימה, מבצעים את הפעולות הבאות:

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

   2. בוחרים נכס מהרשימה.

      שם הנכס, ואחריו נקודתיים, מופיע לצד התווית Filter table.

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

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

4. אופציונלי: כדי לבצע פעולות אחרות בפלאגין שנבחר, לוחצים על More actions ובוחרים אפשרות:

   • כדי לערוך את הפלאגין, לוחצים על Edit.
   • כדי למחוק את הפלאגין, לוחצים על מחיקה.
   • כדי לפתוח את Logs Explorer, שבו אפשר לאחזר, להציג ולנתח נתוני יומן לגבי הפלאגין, לוחצים על View in Logs Explorer.
   • כדי לפתוח את הדף Service Extensions Monitoring, לוחצים על View Monitoring.

gcloud

מריצים את הפקודה gcloud service-extensions wasm-plugins list:

gcloud service-extensions wasm-plugins list \
    --location=LOCATION

מחליפים את LOCATION במיקום של הפלאגין, שהוא global או אזור.

הפלאגינים בפרויקט מופיעים בטבלה עם הפרטים הבאים:

• ‫Name: שם הפלאגין
• תיאור: תיאור הפלאגין
• הגרסה הראשית: הגרסה הפעילה של הפלאגין
• זמן העדכון: הזמן שבו הפלאגין שונה לאחרונה

הצגת הפרטים של פלאגין

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

המסוף

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

   כניסה לדף Service Extensions

2. לוחצים על הכרטיסייה Plugins (יישומי פלאגין).

3. לוחצים על שם הפלאגין שרוצים לראות את הפרטים שלו.

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

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

   • גרסאות: בקטע הזה מוצגים פרטים על גרסאות הפלאגין, כולל גרסת הפלאגין, חותמת הזמן של היצירה, התיאור שצוין, ה-URI והתקצירים של קובץ האימג', וקובץ התצורה או קובץ האימג' של הפלאגין והתקצירים הקשורים.

     אפשר ללחוץ על כתובת ה-URL של התמונה כדי לראות את הפרטים שלה.

gcloud

כדי לראות את הפרטים של פלאגין, מריצים את הפקודה gcloud service-extensions wasm-plugins describe:

 gcloud service-extensions wasm-plugins describe WASM_PLUGIN \
     --location=LOCATION

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

• ‫WASM_PLUGIN: שם הפלאגין
• ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור

הפרטים הבאים על הפלאגין מוצגים:

• שם הפלאגין
• חותמות הזמן של יצירת הפלאגין ושינוי הפלאגין
• התוויות
• תדירות הדגימה של היומן (אם הרישום ביומן מופעל)

כדי להציג את רשימת הגרסאות של פלאגין, משתמשים בפקודה gcloud service-extensions wasm-plugin-versions list:

 gcloud service-extensions wasm-plugin-versions list WASM_PLUGIN \
     --location=LOCATION

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

• ‫WASM_PLUGIN: שם הפלאגין
• ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור

הגרסאות של הפלאגין שצוין מופיעות בטבלה עם שם הפלאגין.

כדי לראות את הפרטים של גרסת הפלאגין, משתמשים בפקודה gcloud service-extensions wasm-plugin-versions describe:

 gcloud service-extensions wasm-plugin-versions describe WASM_PLUGIN_VERSION \
     --location=LOCATION

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

• ‫WASM_PLUGIN_VERSION: הגרסה הראשית של הפלאגין
• ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור

הפרטים הבאים על גרסת הפלאגין מוצגים:

• שם הגרסה
• חותמת הזמן של היצירה
• תיאור, אם הוזן כזה
• ה-URI והתקצירים של התמונה
• קובץ התצורה או קובץ האימג' של הפלאגין והתקצירים הקשורים

עריכת פלאגינים

בקטע הזה מוסבר איך עורכים פלאגינים שנוצרו באמצעות Service Extensions.

עריכת פלאגין

כדי לערוך פלאגין:

המסוף

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

   כניסה לדף Service Extensions

2. לוחצים על הכרטיסייה Plugins (יישומי פלאגין).

3. בפלאגין שרוצים לערוך, לוחצים על More actions ובוחרים באפשרות Edit.

   לחלופין, לוחצים על שם הפלאגין ואז בדף Details לוחצים על Edit.

   בדף עריכת הפלאגין, אי אפשר לערוך את שם הפלאגין. אפשר לערוך פרטים אחרים.

4. מבצעים את השינויים הנדרשים.

   מידע על רוב השדות מופיע במאמר יצירת פלאגין.

   מידע על הקטע גרסאות מופיע במאמר הוספת גרסה חדשה של פלאגין.

5. לוחצים על עדכון הפלאגין.

gcloud

מריצים את הפקודה gcloud service-extensions wasm-plugins update:

gcloud service-extensions wasm-plugins update WASM_PLUGIN \
   --location=LOCATION \
   --description=PLUGIN_DESCRIPTION \
   --labels=[LABELS,...]

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

• ‫WASM_PLUGIN: שם הפלאגין
• ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור
• ‫PLUGIN_DESCRIPTION: תיאור הפלאגין
• ‫LABELS: תוויות בצורה של צמדי מפתח/ערך, מופרדים בפסיקים

הוספת גרסה חדשה של פלאגין

אתם יכולים ליצור גרסה חדשה של קוד הפלאגין ואז להוסיף אותה כגרסה חדשה של הפלאגין.

כדי להוסיף גרסה חדשה של פלאגין:

המסוף

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

   כניסה לדף Service Extensions

2. לוחצים על הכרטיסייה Plugins (יישומי פלאגין).

3. לוחצים על עריכה.

4. בקטע גרסאות, לוחצים על הוספת גרסה.

5. בחלונית Add version, מציינים את פרטי גרסת הפלאגין.

6. אופציונלי: מסמנים את התיבה הגדרה כראשי.

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

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

8. לוחצים על עדכון הפלאגין.

gcloud

מריצים את הפקודה gcloud service-extensions wasm-plugins update:

 gcloud service-extensions wasm-plugins update WASM_PLUGIN \
     --location=LOCATION \
     --image=IMAGE \
     --main-version=MAIN_VERSION \
     --plugin-config=PLUGIN_CONFIG | --plugin-config-file=PLUGIN_CONFIG_FILE | --plugin-config-uri=PLUGIN_CONFIG_URI

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

• ‫WASM_PLUGIN: המזהה או השם המלא של הפלאגין
• ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור
• ‫IMAGE: ה-URI של מודול ה-Wasm החדש שמאוחסן במאגר של Artifact Registry
• ‫MAIN_VERSION: המזהה של גרסת הפלאגין שרוצים ליצור ולהגדיר כגרסה הראשית (או הגרסה שמוצגת).
• ‫PLUGIN_CONFIG,‏ PLUGIN_CONFIG_FILE או PLUGIN_CONFIG_URI: קובץ התצורה האופציונלי, שאפשר לציין אותו כטקסט בתוך השורה, כקובץ מקומי או כתמונה ב-Artifact Registry, בהתאמה.

הערה: כדי ליצור גרסת פלאגין חדשה בלי להגדיר אותה כגרסה הראשית, משתמשים בפקודה gcloud service-extensions wasm-plugins create.

שינוי הגרסה הראשית של פלאגין

כדי לשנות את הגרסה הראשית של פלאגין:

המסוף

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

   כניסה לדף Service Extensions

2. לוחצים על הכרטיסייה Plugins (יישומי פלאגין).

3. לוחצים על הכפתור עריכה.

4. בקטע Versions, בוחרים גרסה לא פעילה ולוחצים על Set as main.

   לחלופין, כשיוצרים גרסה חדשה של הפלאגין, אפשר להגדיר אותה כגרסה הראשית.

5. לוחצים על עדכון הפלאגין.

gcloud

מריצים את הפקודה gcloud service-extensions wasm-plugins update:

 gcloud service-extensions wasm-plugins update \
     --location=LOCATION \
     --main-version=WASM_PLUGIN_VERSION

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

• ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור
• ‫WASM_PLUGIN_VERSION: השם של הגרסה הראשית של הפלאגין

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

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

מחיקת פלאגינים

בקטע הזה מוסבר איך למחוק פלאגינים וגרסאות של פלאגינים שנוצרו באמצעות Service Extensions.

מחיקת פלאגין

כדי למחוק פלאגין:

המסוף

1. נכנסים לדף Service Extensions.

   כניסה לדף Service Extensions

2. לוחצים על הכרטיסייה Plugins (יישומי פלאגין).

3. בפלאגין שרוצים למחוק, לוחצים על הלחצן More actions ובוחרים באפשרות Delete.

   אפשר גם ללחוץ על שם הפלאגין ואז על הכפתור Delete בדף Details.

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

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

gcloud

1. מסירים את ההפניות לפלאגין מהגדרת השירות, ואז מייבאים מחדש את קובץ ה-YAML של ההגדרה.

   מידע נוסף זמין במאמרים בנושא הגדרת פלאגינים של מסלול ותנועה ב-Cloud Load Balancing, ופלאגינים של Media CDN.

2. מריצים את הפקודה gcloud service-extensions wasm-plugins delete:

   gcloud service-extensions wasm-plugins delete WASM_PLUGIN \
       --location=LOCATION
   

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

   • ‫WASM_PLUGIN: שם הפלאגין
   • ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור

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

מחיקת גרסה של פלאגין

כדי למחוק גרסה של פלאגין:

המסוף

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

   כניסה לדף Service Extensions

2. לוחצים על הכרטיסייה Plugins (יישומי פלאגין).

3. בוחרים את הפלאגין שרוצים לערוך ועוברים למצב עריכה.

4. בקטע Versions, מסמנים את התיבות של הגרסאות שרוצים למחוק ולוחצים על Delete.

5. לוחצים על עדכון הפלאגין.

gcloud

מריצים את הפקודה gcloud service-extensions wasm-plugin-versions delete:

 gcloud service-extensions wasm-plugin-versions delete WASM_PLUGIN_VERSION \
     --location=LOCATION

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

• ‫WASM_PLUGIN_VERSION: השם של גרסת פלאגין שלא משמשת כגרסה הראשית
• ‫LOCATION: המיקום של הפלאגין, שיכול להיות global או אזור

אם גרסה מסוימת מוגדרת כגרסה הראשית (הפעילה), אפשר למחוק אותה רק אחרי שמגדירים גרסה אחרת כגרסה הראשית.

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

• איך יוצרים פלאגינים
• סקירה כללית על תוספי שירות