הגדרת הרכיבים הטכניים

בדף הזה מוסבר איך ליצור את הרכיבים הטכניים העיקריים שנדרשים להפצת מוצר של קובץ אימג' של קונטיינר באמצעות Google Cloud Marketplace.

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

הגדרה של Artifact Registry ו-IAM

לפני שיוצרים את המוצר ב-Producer Portal, צריך ליצור מאגר זמני ב-Artifact Registry ולהעלות אליו את התמונות שרוצים להפיץ במוצר. בפרויקט, צריך להעניק ל[e-mail] את התפקיד 'עריכת פרויקט'.

תחילת העבודה עם Container Registry

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

לשותפי VM קיימים: מאגר Artifact Registry של סביבת הבדיקה יכול להיות בפרויקט הפיתוח ולא בפרויקט הציבורי.

אחרי שמתקינים את gcloud ואת Docker, צריך להפעיל את ממשקי ה-API הבאים בדף ספריית ה-API:

• Artifact Registry API
• Artifact Analysis API

‫Artifact Registry API מאפשר לכם לבצע push ל-Artifact Registry, ו-Artifact Analysis API מאפשר לכם לבצע סריקת אבטחה.

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

תיוג תמונות והעלאה שלהן

1. בוחרים את הנתיב של מאגר ההכנה (staging) ב-Artifact Registry. מומלץ שהמאגר יפעל לפי המבנה us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

   • מאגר ההכנה חייב להיות ב-us-docker.pkg.dev או ב-gcr.io (אזורים אחרים, כמו europe-docker.pkg.dev או eu.gcr.io, עדיין לא נתמכים).
   • שומרים או מעתיקים את הנתיב של מאגר ההכנה ליצירת מוצרים בפורטל של היוצרים.

2. יוצרים את האימג' שרוצים להעביר בדחיפה למאגר הזמני של Artifact Registry.

3. מתייגים את התמונה באמצעות Docker עם latest.

   docker tag image_name staging_repo_path:tag

   לדוגמה, docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest

   שימו לב: התמונה שתויגה ב-latest תישלף אם המשתמש לא יציין תג.

4. דחיפת התמונה באמצעות gcloud:

   gcloud docker push staging_repo_path:tag

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

   • חשוב לזכור שהעלאת תמונה למאגר ההכנה לא תגרום לכך שהיא תהיה גלויה למשתמשים באופן אוטומטי. זה קורה רק לתמונות של התגים שבוחרים, אחרי שהן מתפרסמות.
   • ההיקף של מאגר הוא הרמה היחידה של התיקייה שצוינה בנתיב שלה. תמונות שנמצאות בתוך תיקייה אחרת במאגר לא נמצאות במאגר עצמו. במילים אחרות, אם תמונה נמצאת ב-us-docker.pkg.dev/testpartner/testsolution/1.0, היא לא נמצאת במאגר us-docker.pkg.dev/testpartner/testsolution. us-docker.pkg.dev/testpartner/testsolution/1.0 הוא מאגר נפרד.

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

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

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

• פרטי המוצר: מוסיפים מידע על כרטיס המוצר ועל השיווק שלו.
• קובצי אימג' של קונטיינרים: צריך לספק את מאגר Google Container Registry שכולל את קובצי האימג' של הקונטיינרים.

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

כדי ליצור את הדף של המוצר ב-Cloud Marketplace:

1. פותחים את Producer Portal במסוף Google Cloud :

   https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
   

   מחליפים את YOUR_PUBLIC_PROJECT_ID במזהה של הפרויקט הציבורי שיצרתם עבור Cloud Marketplace – לדוגמה, my-organization-public.

   הערה: אם הקישור לא מופיע או שאין לכם גישה לכתובת ה-URL, צריך לוודא שבחרתם את הפרויקט הנכון ושיש לכם תפקיד עורך (roles/editor) בפרויקט. אם עדיין אין לך גישה לכתובת ה-URL, אפשר להשתמש במוקד התמיכה לשותפים כדי לבקש עזרה, ולכלול את המילה Marketplace בתיאור. מידע נוסף על מוקד התמיכה לשותפים זמין במאמר בנושא בקשת עזרה בנוגע ל-Cloud Marketplace.

2. בראש הדף, לוחצים על הוספת מוצר.

3. בוחרים באפשרות קובץ אימג' של קונטיינר.

4. בקטע שם המוצר, נותנים שם למוצר ומסמנים את מזהה המוצר. מזהה המוצר משמש בכתובת ה-URL של כרטיס המוצר ב-Cloud Marketplace.

   שימו לב: אי אפשר לשנות את מזהה המוצר ואת סוג המוצר אחרי שהמוצר נוצר. אפשר לשנות את שם המוצר לפני ששולחים אותו.

5. לוחצים על יצירה. יכול להיות שיחלפו כמה שניות עד שהמוצר ייווצר.

הוספת פרטי מוצר

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

כדי להוסיף את פרטי המוצרים:

1. ברשימת המוצרים, לוחצים על מזהה המוצר.

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

3. משלימים את הפרטים בכרטיסייה פרטי מוצר שבקטע פרטי מוצר. במהלך מילוי הפרטים בקטע PRODUCT INFO (פרטי המוצר), אפשר להוסיף מזהי קטגוריות. מזהי קטגוריות מאפשרים ללקוחות למצוא את המוצר שלכם בקטגוריות או במסננים מסוימים כשהם מחפשים ב-Cloud Marketplace.

4. כדי להוסיף הדרכות, מסמכי תיעוד ואופציונלית הסכמי רישיון נוספים, ממלאים את הכרטיסייה DOCUMENTATION (תיעוד) בקטע Product details (פרטי המוצר). המסמכים צריכים לעמוד בדרישות בנוגע למדריכי משתמש.

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

6. כשמוכנים לשלוח את פרטי המוצר לעיבוד, לוחצים על שליחה.

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

הוספת תמונות של קונטיינרים

אתם צריכים ליצור גרסה אחת שתואמת לתג Container Registry‏ latest (הבחנה בין אותיות רישיות לאותיות קטנות). זו גרסת ברירת המחדל בדף המוצר.

כדי להוסיף את תמונות הקונטיינר:

1. ברשימת המוצרים, לוחצים על מזהה המוצר.

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

3. בקטע Container images (תמונות של קונטיינרים), מזינים את כתובת ה-URL של מאגר Artifact Registry של סביבת הבדיקה.

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

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

6. אפשר גם להוסיף שם גרסה ותיאור קצר של הגרסה. כך המשתמשים יכולים לפרוס את הגרסה שהם רוצים.

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

8. אחרי שמוסיפים את כל הפרטים של הגרסה, לוחצים על סיום.

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

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

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

תצוגה מקדימה של מוצר קובץ אימג' של קונטיינר

כדי לראות תצוגה מקדימה של דף המוצר ב-Cloud Marketplace לפני שהוא מוצג למשתמשים:

1. ברשימת המוצרים, לוחצים על מזהה המוצר.

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

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

פרסום מוצר קובץ אימג' של קונטיינר

כדי לפרסם את המוצר ב-Cloud Marketplace, אתם צריכים:

• משלימים את הבדיקות פרטי מוצר וקובצי אימג' של קונטיינרים.

• לקבל אישור כGoogle Cloud שותף build.

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

1. ברשימת המוצרים, לוחצים על מזהה המוצר.

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