שימוש בתוויות

כאן מוסבר איך יוצרים תוויות ומשתמשים בהן בשירותים ובגרסאות של Knative Serving.

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

התוויות ב-Knative Serving הן תוויות של משאבי Kubernetes, והן לא מועברות אל Google Cloud. כאן אפשר לקרוא מידע נוסף על שימוש בתוויות כדי לנתח את השימוש במשאבי האשכול.

כללי שימוש בתוויות

ב-Knative Serving אפשר להשתמש רק בתוויות Kubernetes תקינות.

הגדרת תוויות או שינוי שלהן

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

אפשר להגדיר או לשנות תוויות באמצעות Google Cloud המסוף, Google Cloud CLI או קובץ YAML כשפורסים שירות חדש או מעדכנים שירות קיים ופורסים עדכון:

המסוף

  1. נכנסים אל Knative serving במסוף Google Cloud :

מעבר אל Knative serving

  1. מסמנים את תיבת הסימון שמימין לשירות שרוצים להגדיר לו את התווית.

  2. מוודאים שהאפשרות Info Panel (חלונית המידע) מופעלת בצד שמאל (Show Info Panel).

  3. לוחצים על תוויות כדי להציג את חלונית התוויות.

    הגדרת תווית

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

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

  6. לוחצים על שמירה

שורת הפקודה

אפשר להשתמש ב-Google Cloud CLI כדי להגדיר תוויות לשירותים חדשים או לעדכן שירותים קיימים:

  • בשירותים קיימים, כדי לעדכן את התוויות מריצים את הפקודה gcloud run services update עם אחד מהפרמטרים הבאים:

    דוגמה:

    gcloud run services update SERVICE --update-labels KEY1=VALUE1,KEY2=VALUE2

    מחליפים את:

    • SERVICE בשם של השירות.
    • ‫KEY1=VALUE1,KEY2=VALUE2 ברשימה מופרדת בפסיקים של צמדים של שמות וערכים לכל תווית. מציינים את שם התווית לכל אחד מהתגים KEY ואת הערך לכל אחד מהתגים VALUE. איך מציינים כמה פרמטרים

      • אפשרויות של פרמטרים של פקודות

      כדי לציין כמה קבוצות של צמדי מפתח/ערך, אפשר לציין כמה פרמטרים כדי שהקוד יהיה קריא. דוגמה: 
      [...]
--set-labels "KEY=VALUE1" \
--set-labels "KEY=VALUE2" \
--set-labels "KEY=VALUE3"

  • בשירותים חדשים, כדי להגדיר תוויות מריצים את הפקודה gcloud run deploy עם הפרמטר --set-labels:

    gcloud run deploy SERVICE --image=IMAGE_URL --set-labels KEY1=VALUE1,KEY2=VALUE2

    מחליפים את:

    • ‫IMAGE_URL עם הפניה לקובץ אימג' של קונטיינר, לדוגמה, gcr.io/cloudrun/hello.
    • SERVICE בשם של השירות.
    • ‫KEY1=VALUE1,KEY2=VALUE2 ברשימה מופרדת בפסיקים של צמדים של שמות וערכים לכל תווית. מציינים את שם התווית לכל אחד מהתגים KEY ואת הערך לכל אחד מהתגים VALUE. איך מציינים כמה פרמטרים

      • אפשרויות של פרמטרים של פקודות

      כדי לציין כמה קבוצות של צמדי מפתח/ערך, אפשר לציין כמה פרמטרים כדי שהקוד יהיה קריא. דוגמה: 
      [...]
--set-labels "KEY=VALUE1" \
--set-labels "KEY=VALUE2" \
--set-labels "KEY=VALUE3"

YAML

אפשר להוריד את ההגדרה של שירות קיים לקובץ YAML באמצעות הפקודה gcloud run services describe והדגל --format=export. אחר כך תוכלו לשנות את קובץ ה-YAML ולפרוס את השינויים האלה באמצעות הפקודה gcloud run services replace. חשוב לוודא שמשנים רק את המאפיינים שצוינו.

  1. מורידים את ההגדרה של השירות לקובץ בשם service.yaml בסביבת העבודה המקומית:

    gcloud run services describe SERVICE --format export > service.yaml

    מחליפים את SERVICE בשם של שירות Knative serving.

  2. מעדכנים את המאפיין labels בקובץ המקומי:

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  labels:
    LABEL: 'VALUE'

    החלפה

    • ‫SERVICE בשם של שירות Knative serving
    • ‫LABEL עם שם התווית
    • ‫VALUE עם הערך הרצוי

  3. מחליפים את השירות בהגדרה החדשה שלו באמצעות הפקודה הבאה:

    gcloud run services replace service.yaml

הצגת רשימת שירותים לפי תווית

אפשר להציג רשימה של שירותים לפי תווית באמצעות מסנן Google Cloud CLI:

  gcloud run services list --filter metadata.labels.LABEL=VALUE

מחליפים את:

  • ‫LABEL עם שם התווית
  • ‫VALUE עם הערך שרוצים לכלול ברשימה המסוננת

מחיקת תווית

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

המסוף

  1. נכנסים אל Knative serving במסוף Google Cloud :

מעבר אל Knative serving

  1. מסמנים את התיבה שמימין לשירות שממנו רוצים למחוק את התווית.

  2. מוודאים שהאפשרות Info Panel (חלונית המידע) מופעלת בצד שמאל (Show Info Panel).

  3. לוחצים על תוויות כדי להציג את חלונית התוויות.

  4. מאתרים את התווית שרוצים למחוק.

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

  6. לוחצים על שמירה

שורת הפקודה

כדי לנקות את כל התוויות משירות:

gcloud run services update SERVICE --clear-labels

כדי למחוק תוויות ספציפיות משירות, צריך לספק רשימה של מפתחות מופרדים בפסיקים:

gcloud run services update SERVICE --remove-labels LABEL

החלפה

  • ‫SERVICE בשם של השירות שלכם ב-Knative serving
  • ‫LABEL בשם התווית