‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

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

שליחת בקשה לתפקידים ב-IAM

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

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

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

הכנת הסביבה

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

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

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

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

המסוף

ברשימת הפרויקטים במסוף GDC, בוחרים את הפרויקט שבו רוצים להתקין את חבילת התוכנה.
ב-Marketplace של Distributed Cloud, נכנסים לדף המוצר שרוצים להתקין. בדף הזה אפשר לעיין בפרטי המוצר ולעבור לקישורים למסמכי התיעוד, למחירים ולתנאי השירות שלו.
אם זו הפעם הראשונה שאתם מתקינים את המוצר הזה, לוחצים על התקנה. אם לא, עוברים לכרטיסייה 'ניהול' ולוחצים על New Instance (מכונה חדשה).
בתיבת הדו-שיח, בוחרים את אשכול המשתמשים שרוצים להתקין בו את חבילת התוכנה. אם רוצים להתאים אישית את ההגדרה, לוחצים על הבא. אם רוצים להשתמש בהגדרות ברירת המחדל, לוחצים על Install (התקנה).
אם לחצתם על הבא, תוכלו לבדוק את הגדרות ברירת המחדל. לוחצים על הגדרה בהתאמה אישית כדי להזין פרמטרים משלכם, בהתאם לתיעוד של הספק. בסיום, לוחצים על התקנה כדי להמשיך בהתקנה. במקרה של חבילות תוכנה של Kubernetes, הפרמטרים שאתם מגדירים כאן מבטלים את ערכי ברירת המחדל שסופקו על ידי הספק בקובץ הערכים של Helm.
מחכים כמה דקות עד שהמופע החדש יסומן כמוכן בכרטיסייה ניהול בדף.
אחרי ההתקנה, כדאי לעיין בתיעוד של ספק התוכנה הרלוונטי כדי ללמוד איך להשתמש בפתרון שלו.

gdcloud

בוחרים את הפרויקט שבו רוצים להתקין את חבילת התוכנה:
```
gdcloud config set project PROJECT_NAME
```
מחליפים את PROJECT_NAME בשם הפרויקט שבו רוצים להתקין את חבילת התוכנה.
מציגים את רשימת האפליקציות הזמינות ב-Marketplace:
```
gdcloud marketplace services list
```
מתקינים את האפליקציה שנבחרה מהרשימה ומציינים את אשכול היעד:
```
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 שמכיל פרמטרים של שינוי ברירת המחדל של התצורה עבור מופע השירות
מאמתים את ההתקנה:
```
gdcloud marketplace services list
```
מוודאים שהאפליקציה שהותקנה מופיעה ברשימה עם הסטטוס READY או INSTALLED.

API

כדי למצוא את השירות והגרסה הספציפיים שרוצים להתקין, מריצים את הפקודה הבאה כדי לראות את רשימת המשאבים הזמינים של ServiceVersion:
```
kubectl get serviceversions -n mkt-system
```
יוצרים קובץ מניפסט בפורמט 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.
מחילים את המניפסט על הפרויקט:
```
kubectl apply -f service-instance.yaml -n PROJECT_NAME
```
מחליפים את PROJECT_NAME בשם הפרויקט שבו רוצים להתקין את חבילת התוכנה.
כדי לוודא שההתקנה בוצעה, בודקים את הסטטוס של האובייקט ServiceInstance:
```
kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
```
מוודאים שהרכיב status.conditions מכיל תנאי מסוג Ready עם הסטטוס "True", ושהרכיב status.installedVersion מציג את הגרסה המותקנת.

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

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

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

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

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

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

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

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

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

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

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