הצעת אפליקציות Terraform Kubernetes דרך Cloud Marketplace

אפליקציות Terraform Kubernetes ב-Google Cloud Marketplace מאפשרות ללקוחות שלכם להשתמש ב-Terraform כדי לפרוס את האפליקציות בקונטיינרים ב-Google Kubernetes Engine. המשתמשים לא מחויבים על השימוש שלהם באפליקציות Terraform Kubernetes, אבל הם מחויבים על השימוש שלהם במשאבי Google Cloud . אתם יכולים להציע אפליקציות Terraform Kubernetes באופן ציבורי לכל המשתמשים ב-Cloud Marketplace, או באופן פרטי באמצעות מבצעים פרטיים.

אפליקציות Terraform Kubernetes שאתם מציעים דרך Cloud Marketplace מגדירות את ההגדרות שלהן באמצעות Helm charts, שאתם מארחים ב-Artifact Registry. אחרי ההגדרה הזו, מצטרפים עם האפליקציה ל-Cloud Marketplace דרך Producer Portal.

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

סקירה כללית של צירוף אפליקציית Kubernetes של Terraform

כדי להציע אפליקציית Terraform Kubernetes דרך Cloud Marketplace, צריך לבצע את השלבים הבאים:

  1. הכנת אפליקציית Terraform Kubernetes ל-Cloud Marketplace. הפעולות האלה כוללות הגדרה של Artifact Registry והעלאה של קובצי האימג' של האפליקציה אליו.

  2. מוסיפים פרטי תמחור לאפליקציה בפורטל של היוצרים.

  3. מגדירים את הפריסה של האפליקציה בפורטל של ספק התוכן, כולל מודול Terraform, תרשים Helm וקובצי אימג' בקונטיינר.

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

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

דרישות ספציפיות למוצר

כל המוצרים שאתם מציעים דרך Cloud Marketplace צריכים לעמוד בדרישות לרישום ב-Cloud Marketplace.

אפליקציית Terraform Kubernetes צריכה לעמוד בדרישות הנוספות הבאות:

  • האפליקציה צריכה לפעול בצמתי GKE שמשתמשים במעבדי x86.
  • צריך להעלות את כל תרשימי ה-Helm וקובצי האימג' של הקונטיינרים של האפליקציה למאגר Artifact Registry, לאותו מאגר ולאותו פרויקט שבהם משתמשים באפליקציית Terraform Kubernetes.
  • מאגר ה-Artifact Registry צריך לכלול תרשים Helm.
  • כדי לעקוב אחרי צריכת המשאבים המשויכת של האפליקציה, צריך להוסיף תווית לתרשימי ה-Helm של האפליקציה. Google Cloud פרטים נוספים זמינים במאמר בנושא מעקב אחרי צריכת המשאבים המשויכת של אפליקציות Kubernetes באמצעות תוויות.
  • מודול Terraform צריך להיות מאוחסן כקובץ ZIP בקטגוריה של Cloud Storage שנמצאת באותו פרויקט שבו אתם משתמשים באפליקציית Terraform Kubernetes.
  • צריך להפעיל ניהול גרסאות בקטגוריה של Cloud Storage שבה אתם משתמשים לאירוח מודול Terraform.
  • עליכם לכלול מדריך למשתמש עם שלבים לפריסת האפליקציה משורת הפקודה, להגדרת האפליקציה ולשימוש בה. פרטים נוספים מופיעים בקטע דרישות לגבי המדריך למשתמש במסמך הזה.
  • כדי להגן על המשתמשים מפני ממשקי API לא יציבים, צריך להשתמש רק במשאבי Kubernetes בגרסת בטא או במשאבים שזמינים בדרך כלל.

הדרישות לגבי תמונות האפליקציה

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

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

    com.googleapis.cloudmarketplace.product.service.name=services/SERVICE_NAME
    

    מחליפים את SERVICE_NAME בשם השירות (לדוגמה, example.endpoints.example-project.cloud.goog). אפשר למצוא את שם השירות של המוצר בדף סקירה כללית בפורטל של ספקי התוכן, בעמודה שם השירות. מידע נוסף על הערות זמין במאמר בנושא הערות ב-GitHub, שפורסם על ידי Open Container Initiative.

הדרישות למאגר Artifact Registry

תרשים Helm וקובצי האימג' של הקונטיינרים של האפליקציה צריכים להיות חלק ממאגר יחיד של Artifact Registry.

לדוגמה, אם מאגר Artifact Registry הוא us-docker.pkg.dev/exampleproject, תרשים Helm וקובצי האימג' בקונטיינר של האפליקציה צריכים להיראות כך:

  • us-docker.pkg.dev/exampleproject/exampleapp/chart
  • us-docker.pkg.dev/exampleproject/exampleapp/image1
  • us-docker.pkg.dev/exampleproject/exampleapp/image2

הדרישות למודול Terraform

לקוחות משתמשים במודול Terraform כדי לפרוס את המוצר שלכם מ-Cloud Marketplace דרך Infrastructure Manager. מודול Terraform חבילה את הגדרות Kubernetes של האפליקציה.

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

פרמטרים שמועברים לאפליקציה

מודול Terraform צריך להצהיר על פרמטרים שצריך לאסוף מהלקוחות כשהם בוחרים את האפליקציה שלכם. הפרמטרים האלה מועברים למאגר התרשימים של Helm כשהמשתמשים פורסים את האפליקציה.

כדי להגדיר את הפרמטרים האלה, מודול Terraform צריך לכלול קובץ schema.yaml.

במדריך ליצירת סכימה ב-GitHub יש הסבר איך ליצור schema.yaml.

בקשות לאשכולות GPU

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

יכול להיות שהאפליקציה תבקש GPU גנרי של Nvidia או פלטפורמה ספציפית של Nvidia.

דרישות לגבי מדריך למשתמש של האפליקציה

מדריך המשתמש של האפליקציה צריך לכלול את המידע הבא:

  • סקירה כללית: סקירה כללית של האפליקציה, כולל פונקציות בסיסיות ואפשרויות הגדרה. בנוסף, בקטע הזה צריך להוסיף קישור לאפליקציה שפורסמה ב-Cloud Marketplace.
  • הגדרה חד-פעמית: כוללת שלבים להגדרת Helm ולהתקנת האפליקציה CustomResourceDefinition (CRD) כדי שהאשכול יוכל לנהל את משאב האפליקציה.
  • התקנה: כולל את הפעולות הבאות:
    • פקודות לפריסת האפליקציה
    • העברת פרמטרים שזמינה בהגדרות בממשק המשתמש
    • הצמדת הפניות לתמונות לערכי גיבוב (digest) שלא ניתן לשנות
    • מידע על שדות קלט מותאמים אישית שהוספתם למודול Terraform, אם רלוונטי. אפשר לעיין בהוראות להוספת שדות קלט למודול Terraform.
  • שימוש בסיסי: מדריכים למשימות הבאות:
    • שינוי שמות משתמש וסיסמאות
    • חיבור למסוף Admin, אם רלוונטי
    • חיבור כלי לקוח והרצת פקודה לדוגמה, אם רלוונטי
    • הפעלת כניסה והתקנת אישורי TLS, אם רלוונטי
  • גיבוי ושחזור: מידע על גיבוי מצב האפליקציה ועל שחזור מצב האפליקציה מגיבוי.
  • עדכוני תמונות: מידע על עדכון תמונות האפליקציה לצורך תיקוני באגים או עדכונים משניים.
  • קנה מידה: מידע על שינוי קנה המידה של האפליקציה, אם רלוונטי.
  • מחיקה: מדריכים למחיקת האפליקציה ולניקוי משאבים שעשויים להישאר, כמו PersistentVolumeClaims.

מודלים של תמחור לאפליקציות Kubernetes ב-Terraform

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

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

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

תמחור לפי שימוש

‫Google Cloud Marketplace משתמש בהערות של Kubernetes pod כדי לעקוב אחרי השימוש ולחייב את הלקוחות על הפריסות של אפליקציות Cloud Marketplace. ב-Cloud Marketplace מתבצע מעקב אחר החיוב והשימוש ברמת ה-pod, והנתונים מצטברים ברמת כרטיס המוצר.

אם פורסים כמה פודים באותה מכונה (vCPU,‏ GPU,‏ TPU או זיכרון), המערכת מקצה לכל אחד מהפודים את השימוש המצטבר שמתרחש בכל הפודים שנפרסו במכונה. לדוגמה, אם יש לכם שלושה פודים שמשתפים את אותו GPU, ‏ Cloud Marketplace יספור את זה כשלושה GPU.

ב-Cloud Marketplace, מק"טים שונים של GKE בתוך כל משפחה של מק"טים של vCPU,‏ TPU, ‏ GPU או זיכרון נחשבים זהים. לדוגמה, אם GPU מוגדר כמדד, המחיר שמוגדר חל בלי קשר לשאלה אם הלקוח משתמש ב-GKE Autopilot T4 GPU Premium, ב-GKE Autopilot L4GKE Autopilot H100 GPU Premium, ב-GKE Autopilot A100 40 GiB GPU, ב-GKE Autopilot A100 80 GiB GPU או ב-GKE Autopilot H100 GPU Premium.

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

pod_name = os.environ.get("HOSTNAME")
namespace = open(
      "/var/run/secrets/kubernetes.io/serviceaccount/namespace"
).read()
# Load in-cluster config
config.load_incluster_config()
v1 = client.CoreV1Api()
# Get the Pod object
pod = v1.read_namespaced_pod(name=pod_name, namespace=namespace)
annotations = pod.metadata.annotations
if annotations:
print("Annotations for this pod:")
for key, value in annotations.items():
      print(f"  {key}: {value}")
else:
print("No annotations found on this pod.")

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