ניהול שירותים

בדף הזה מוסבר איך ליצור שירות ואיך לצפות במידע על שירות. שירותים הם המשאבים העיקריים של Knative serving.

יצירת שירות

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

הצגת רשימת השירותים בפרויקט

אפשר לראות את רשימת השירותים שזמינים בפרויקט באמצעות מסוףGoogle Cloud או Google Cloud CLI:

המסוף

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

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

    מעבר אל Knative serving

  2. בודקים את רשימת השירותים שמוצגת בפרויקט:

שורת הפקודה

כדי לפרסם את השירותים בפרויקט:

gcloud run services list

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

העתקת שירות

אפשר ליצור עותק של שירות קיים באמצעות מסוף Google Cloud או YAML. אתם יכולים לשנות כל מה שתרצו בעותק, כולל השם והאזור.

המסוף

כדי להעתיק שירות:

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

    מעבר אל Knative serving

  2. בוחרים את השירות להעתקה מתוך רשימת השירותים שמוצגת בפרויקט:

    1. לוחצים על Copy.

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

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

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. מבצעים את שינויי ההגדרות הרצויים בשירות, כפי שמתואר בדפי ההגדרות השונים.

     apiVersion: serving.knative.dev/v1
 kind: Service
 metadata:
   annotations:
     ...
   name: SERVICE
   ...
 spec:
   template:
     metadata:
       annotations:
       ...
       name: REVISION-NAME

    • אם אתם פורסים את העותק לאותו אשכול Kubernetes, מחליפים את SERVICE בשם שבו אתם רוצים להשתמש בשביל העותק. אם אתם פורסים את העותק לאשכול Kubernetes אחר, אתם יכולים להשתמש באותו שם.

    • מוודאים שהערך של REVISION-NAME מתחיל בשם השירות (SERVICE). לדוגמה, אם שם השירות החדש הוא mynewfoo, שם התיקון צריך להיות בפורמט mynewfoo-whatever. אפשר גם למחוק את הערך לגמרי, ואז המערכת תיצור באופן אוטומטי שם חדש לגרסה.

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

    gcloud run services replace service.yaml

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

הצגת פרטים נוספים על שירות

כדי לראות פרטים נוספים על שירות מסוים:

המסוף

כדי לראות את פרטי השירות:

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

    מעבר אל Knative serving

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

  3. שימו לב לכרטיסיות REVISIONS (גרסאות), LOGS (יומנים) ו-DETAILS (פרטים). בכרטיסייה 'גרסאות' מוצגת רשימת הגרסאות, בכרטיסייה 'יומנים' מוצגים יומני השירות, ובכרטיסייה 'פרטים' מוצגות ההגדרות הנוכחיות של אימות או קישוריות.

שורת הפקודה

כדי לראות פרטים על שירות:

‫
gcloud run services describe SERVICE
 מחליפים את SERVICE בשם השירות.

אפשר להשתמש ב--format flag כדי לעצב את הפלט. לדוגמה, ב-YAML:

gcloud run services describe SERVICE --format yaml

אפשר להשתמש ב---format export כדי לייצא כ-YAML בלי תוויות או סטטוס שנוצרו באופן אוטומטי:

gcloud run services describe SERVICE --format export

אפשר גם להשתמש בדגל --format כדי לקבל את כתובת ה-URL של השירות: 

gcloud run services describe SERVICE --format='value(status.url)'

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

שינוי הגדרות הקישוריות של השירות

לשירות Knative serving יכולות להיות שתי אפשרויות חיבור:

  • חיצוני, שמאפשר גישה חיצונית לשירות

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

אפשר לשנות את ההגדרות באמצעות המסוף או Google Cloud CLI.

המסוף

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

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

    מעבר אל Knative serving

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

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

  4. בוחרים את ההגדרה הרצויה ולוחצים על שמירה.

שורת הפקודה

כדי לשנות את הגדרות הקישוריות של השירות, מעדכנים את השירות עם הגדרת הקישוריות הרצויה:

gcloud run services update [SERVICE] --connectivity=[OPTION]

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

  • מחליפים את [OPTION] ב-internal או ב-external.

מחיקת שירותים קיימים

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

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

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

המסוף

כדי למחוק שירות:

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

    מעבר אל Knative serving

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

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

שורת הפקודה

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

gcloud run services delete [SERVICE]

מחליפים את [SERVICE] בשם השירות.