מחזור החיים של פריסה ב-Marketplace

במאמר הזה מוסבר איך להתקין, לשדרג ולהסיר חבילות תוכנה של Google Distributed Cloud (GDC) air-gapped Marketplace באמצעות מסוף GDC. אפשר גם להתקין חבילות תוכנה באמצעות ה-CLI של gdcloud marketplace או Marketplace API.

המסמך הזה מיועד למפעילי אפליקציות שמנהלים את מחזור החיים של פריסות Marketplace בפרויקטים ב-GDC. מידע נוסף מופיע במאמר קהלים למסמכי תיעוד של GDC עם air gap.

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

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

בקשת תפקידים ב-IAM

כדי לבקש את התפקידים הבאים, פנו למנהל חשבון ארגוני ב-IAM או לאדמין של הפרויקט, בהתאם למשימות שאתם צריכים לבצע בפרויקט:

• עריכה ב-Marketplace (marketplace-editor): התקנה, שדרוג והסרה של חבילות תוכנה ב-Marketplace.
• צפייה בפרויקט (project-viewer): צפייה בפרויקט קיים ובמשאבים שלו.

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

הכנת הסביבה

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

• מורידים ומתקינים את ה-gdcloud CLI, אם עדיין לא עשיתם את זה.
• כדי להשתמש ב-API עם kubectl, צריך לבצע הגדרה נוספת:
  • מתקינים את ה-CLI של kubectl.
  • יוצרים קובץ kubeconfig.

התקנת חבילת תוכנה של Distributed Cloud Marketplace

כדי להתקין חבילת תוכנה מ-Distributed Cloud Marketplace:

המסוף

1. בבורר הפרויקטים במסוף GDC, בוחרים את הפרויקט שבו רוצים להתקין את חבילת התוכנה.
2. ב-Distributed Cloud Marketplace, נכנסים לדף של המוצר שרוצים להתקין. בדף הזה אפשר לראות את פרטי המוצר ולעבור לקישורים למסמכי התיעוד, לתמחור ולתנאים ולהגבלות שלו.
3. אם זו הפעם הראשונה שאתם מתקינים את המוצר הזה, לוחצים על התקנה. אם לא, עוברים לכרטיסייה Management ולוחצים על New Instance.
4. בתיבת הדו-שיח, בוחרים את אשכול המשתמשים שבו רוצים להתקין את חבילת התוכנה. אם רוצים להתאים אישית את ההגדרות, לוחצים על הבא. כדי להשתמש בהגדרות ברירת המחדל, לוחצים על Install.
5. אם לחצתם על Next, אתם יכולים לבדוק את הגדרות ברירת המחדל. לוחצים על הגדרה בהתאמה אישית כדי להזין פרמטרים משלכם, בהתאם לתיעוד של הספק. בסיום, לוחצים על התקנה כדי להמשיך בתהליך ההתקנה. בחבילות תוכנה של Kubernetes, הפרמטרים שאתם מגדירים כאן מחליפים את ערכי ברירת המחדל שסופקו על ידי הספק בקובץ הערכים של Helm.

6. ממתינים כמה דקות עד שהמכונה החדשה תסומן כ-Ready בכרטיסייה Management שבדף.

   

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

gdcloud

1. בוחרים את הפרויקט שבו רוצים להתקין את חבילת התוכנה:

   gdcloud config set project PROJECT_NAME
   

   מחליפים את PROJECT_NAME בשם הפרויקט שבו רוצים להתקין את חבילת התוכנה.

2. מציגים את האפליקציות הזמינות ב-Marketplace:

   gdcloud marketplace services list
   

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

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME
   

   כדי לספק שינויים בהגדרות האישיות במהלך ההתקנה, משתמשים בדגל --parameters-file:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME \
     --parameters-file=PATH_TO_PARAMETERS_FILE
   

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

   • ‫SERVICE_NAME: השם של שירות Marketplace שרוצים להתקין (לדוגמה, dataproc)
   • ‫CLUSTER_NAME: השם של אשכול המשתמשים שבו רוצים להתקין את האפליקציה
   • ‫PATH_TO_PARAMETERS_FILE: הנתיב לקובץ YAML שמכיל פרמטרים של שינוי הגדרות למכונה של השירות

4. מאמתים את ההתקנה:

   gdcloud marketplace services list
   

   מוודאים שהאפליקציה החדשה שהותקנה מופיעה ברשימה עם הסטטוס READY או INSTALLED.

API

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

   kubectl get serviceversions -n mkt-system
   

2. יוצרים מניפסט YAML למשאב ServiceInstance (לדוגמה, service-instance.yaml):

   apiVersion: marketplace.gdc.goog/v1
   kind: ServiceInstance
   metadata:
     name: INSTANCE_NAME
   spec:
     clusterRef:
       name: CLUSTER_NAME
       namespace: CLUSTER_NAMESPACE
     serviceVersionRef:
       name: SERVICE_VERSION_NAME
       namespace: mkt-system
     parameters:
       KEY: VALUE
   

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

   • ‫INSTANCE_NAME: שם למכונה החדשה של האפליקציה
   • ‫CLUSTER_NAME: השם של אשכול המשתמשים שבו רוצים להתקין את האפליקציה
   • ‫CLUSTER_NAMESPACE: מרחב השמות של האשכול (לדוגמה, production-cluster)
   • ‫SERVICE_VERSION_NAME: השם של ה-ServiceVersion שרוצים להתקין (לדוגמה, dataproc-1.0.0)
   • ‫KEY: שם הפרמטר של שינוי ההגדרה, בהתאם לסכימת הערכים של Helm של הספק
   • ‫VALUE: הערך של הפרמטר לשינוי ההגדרות האישיות

   למידע נוסף ולדוגמה למניפסט, קראו את הסקירה הכללית על Marketplace API.

3. מחילים את המניפסט על הפרויקט:

   kubectl apply -f service-instance.yaml -n PROJECT_NAME
   

   מחליפים את PROJECT_NAME בשם הפרויקט שבו רוצים להתקין את חבילת התוכנה.

4. כדי לוודא שההתקנה בוצעה, בודקים את הסטטוס של האובייקט ServiceInstance:

   kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
   

   מוודאים ש-status.conditions מכיל תנאי מסוג Ready עם הסטטוס "True", ושהגרסה המותקנת מוצגת ב-status.installedVersion.

הערה: אם אתם צריכים לדעת איזה קובץ אימג' של קונטיינר זמין ב-GDC, עיינו ברשימת התמונות ב-Marketplace שכלולות בגרסה שלכם של GDC. תמונות שנכללו בגרסאות קודמות של GDC עדיין זמינות לשימוש, גם אחרי שדרוג של GDC.

הגדרה מחדש של מכונה של חבילת תוכנה ב-Distributed Cloud Marketplace

אזהרה: אפשר להגדיר מחדש מכונה פעילה של חבילת תוכנה ב-Distributed Cloud Marketplace, אבל תהליך ההגדרה מחדש מיושם על ידי הספק שפרסם את המוצר. לכן, תהליך ההגדרה מחדש משתנה מחבילת תוכנה אחת לאחרת. מומלץ לעיין בקפידה במסמכי התיעוד של הספק הרלוונטי לפני שמגדירים מחדש. בהתאם לאופן שבו הספק הטמיע את תהליך ההגדרה מחדש, יכול להיות שיהיה זמן השבתה בשירות שניתן.

אפשר להגדיר מחדש חלק מחבילות התוכנה של Distributed Cloud Marketplace כשהן כבר פועלות. בשירותים שמבוססים על Kubernetes, הפעולה הזו מקבילה להחלת ערכים חדשים על תרשים ה-Helm של הספק.

כדי להגדיר מחדש מכונה פעילה של חבילת תוכנה מ-Distributed Cloud Marketplace:

1. בבורר הפרויקטים במסוף GDC, בוחרים את הפרויקט שבו רוצים לשדרג את חבילת התוכנה.
2. בדף של Distributed Cloud Marketplace, נכנסים לדף של המוצר שרוצים לשדרג.
3. לוחצים על הכרטיסייה ניהול.
4. לוחצים על Configuration file (קובץ תצורה) במכונה שרוצים להגדיר מחדש.
5. בחלונית שנפתחת, מזינים את הפרמטרים המותאמים אישית לפי ההוראות במסמכי התיעוד של הספק.
6. לוחצים על שמירה כדי להחיל את הפרמטרים החדשים. ההגדרה מחדש מסתיימת תוך כמה דקות.

שדרוג חבילת תוכנה של Distributed Cloud Marketplace

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

אחרי שמפעיל התשתית יאפשר לכם להשתמש בגרסאות חדשות של חבילות תוכנה מסוימות ב-Distributed Cloud Marketplace, תוכלו לשדרג את החבילות האלה לגרסה החדשה דרך Google Distributed Cloud Marketplace.

כדי לשדרג חבילת תוכנה של Distributed Cloud Marketplace:

1. בבורר הפרויקטים במסוף GDC, בוחרים את הפרויקט שבו רוצים לשדרג את חבילת התוכנה.
2. בדף של Distributed Cloud Marketplace, נכנסים לדף של המוצר שרוצים לשדרג.
3. לוחצים על הכרטיסייה "ניהול".
4. לוחצים על Upgrade במכונה שרוצים לשדרג. השדרוג מסתיים תוך כמה דקות.

הערה: שדרוג של חבילת תוכנה דרך מסוף Distributed Cloud מוביל להתקנה של הגרסה הזמינה הבאה של התוכנה. אם יש כמה גרסאות חדשות של התוכנה, צריך לחזור על התהליך לכל אחת מהן. אם צריך, משתמשים ב-Marketplace API כדי לשדרג לגרסה ספציפית.

הסרת ההתקנה של חבילת תוכנה מ-Distributed Cloud Marketplace

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

כדי להסיר חבילת תוכנה של Distributed Cloud Marketplace:

1. בבורר הפרויקטים במסוף GDC, בוחרים את הפרויקט שממנו רוצים להסיר את חבילת התוכנה.
2. בדף של Distributed Cloud Marketplace, נכנסים לדף של המוצר שרוצים להסיר.
3. לוחצים על הכרטיסייה ניהול.
4. לוחצים על הסרה ליד המופע שרוצים להסיר. חבילת התוכנה תוסר תוך כמה דקות.