ניהול, פרסום ושיתוף של קטלוגים

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

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

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

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

משימה	התפקידים הנדרשים
פרסום תבניות של אפליקציות בקטלוג מרחבים	אדמין של Application Design Center (roles/designcenter.admin)
שיתוף קטלוג עם מרחבים ליעדים	אדמין של Application Design Center (roles/designcenter.admin)

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

לפני שמנהלים קטלוגים, צריך:

• משלימים את ההגדרה הראשונית של App Design Center.
• כדי ליצור חללים נוספים מעבר לחלל הראשוני, אפשר לעיין במאמר ניהול חללים.

פרסום תבנית של אפליקציה בקטלוג

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

קנבס העיצוב

1. בתפריט הניווט, לוחצים על קטלוגים.

   מעבר אל קטלוגים

2. לוחצים על הוספת תבניות.

3. באזור Add templates to Default Catalog (הוספת תבניות לקטלוג ברירת המחדל), מבצעים את הפעולות הבאות:

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

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

5. כדי לשתף את הקטלוג, אפשר לעיין במאמר בנושא שיתוף קטלוג עם מרחב.

‫CLI של gcloud

1. מאתרים את מזהה הקטלוג של הקטלוג שאליו רוצים להוסיף את התבנית.

   gcloud design-center spaces catalogs list \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

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

   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של הקטלוג.
   • ‫SPACE: מזהה המרחב.

   מידע נוסף זמין במאמר gcloud design-center spaces catalogs list.

2. מזהים את מזהה התבנית של התבנית שרוצים להוסיף לקטלוג. לדוגמה, הפקודה הבאה מציגה רשימה של תבניות אפליקציות.

   gcloud design-center spaces application-templates list \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --filter=FILTER
   

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

   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של הקטלוג.
   • ‫SPACE: מזהה המרחב.
   • ‫FILTER: מסנן שיעזור לכם לצמצם את תוצאות החיפוש. לדוגמה, "displayName:my-app-template*".

   מידע נוסף זמין במאמר gcloud design-center spaces application-templates list.

3. מאשרים את תבנית האפליקציה.

    gcloud design-center spaces application-templates commit TEMPLATE \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE
   

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

   • ‫TEMPLATE: מזהה התבנית של התבנית שרוצים לבצע.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של תבנית האפליקציה.
   • ‫SPACE: מזהה המרחב.

   מידע נוסף זמין במאמר gcloud design-center spaces application-templates commit.

4. מעתיקים את הפלט name מהפקודה commit. תציינו את השם הזה כערך application-template-revision-source כשתיצרו את הגרסה של תבנית הקטלוג.

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

   gcloud design-center spaces catalogs templates list \
   --catalog=CATALOG \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

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

   • ‫CATALOG: מזהה הקטלוג. לדוגמה, default-catalog.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של הקטלוג.
   • ‫SPACE: מזהה המרחב.

   מידע נוסף זמין במאמר gcloud design-center spaces catalogs templates list.

6. אם תבנית האפליקציה לא נמצאת בקטלוג, צריך ליצור את תבנית הקטלוג.

   gcloud design-center spaces catalogs templates create CATALOG_TEMPLATE \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --catalog=CATALOG \
   --template-category=TEMPLATE_CATEGORY
   

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

   • ‫CATALOG_TEMPLATE: מזהה תבנית הקטלוג של תבנית הקטלוג שרוצים ליצור.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של הקטלוג.
   • ‫SPACE: מזהה המרחב.
   • ‫CATALOG: מזהה הקטלוג.
   • ‫TEMPLATE_CATEGORY: קטגוריית התבנית. לדוגמה, application-template.

   מידע נוסף זמין במאמר gcloud design-center spaces catalogs templates create.

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

   gcloud design-center spaces catalogs templates revisions create REVISION \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --catalog=CATALOG \
   --template=CATALOG_TEMPLATE \
   --application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCE
   

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

   • ‫REVISION: מזהה הגרסה של הגרסה שרוצים ליצור. לדוגמה, r1.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של הקטלוג.
   • ‫SPACE: מזהה המרחב.
   • ‫CATALOG: מזהה הקטלוג.
   • ‫CATALOG_TEMPLATE: מזהה התבנית.
   • ‫APPLICATION_TEMPLATE_REVISION_SOURCE: המקור של עדכון תבנית האפליקציה. העתקתם את הערך הזה כשביצעתם את השמירה של תבנית האפליקציה. לדוגמה, projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.

   מידע נוסף זמין במאמר gcloud design-center spaces catalogs templates revisions create.

שיתוף תבניות מתוקנות

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

הסרת תבניות מקטלוג

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

קנבס העיצוב

1. בתפריט הניווט, לוחצים על קטלוגים.

   מעבר אל קטלוגים

2. כדי לנהל את התבניות בקטלוג הזה, לוחצים על תבניות בקטלוג.

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

   1. בשדה, מזינים את שם התבנית.
   2. לוחצים על הסרה.

‫CLI של gcloud

הסרת תבנית מהקטלוג.

gcloud design-center spaces catalogs templates delete CATALOG_TEMPLATE \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

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

• ‫CATALOG_TEMPLATE: המזהה של תבנית הקטלוג שרוצים להסיר מהקטלוג.
• ‫CATALOG: מזהה הקטלוג.
• ‫PROJECT: מזהה פרויקט הניהול.
• ‫LOCATION: האזור של הקטלוג.
• ‫SPACE: מזהה המרחב.

מידע נוסף זמין במאמר gcloud design-center spaces catalogs templates delete.

שיתוף קטלוג עם מרחב

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

כדי לשתף את הקטלוג עם מרחב:

קנבס העיצוב

1. בתפריט הניווט, לוחצים על קטלוגים.

   מעבר אל קטלוגים

2. לוחצים על שיתוף הקטלוג.

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

   • תיקייה: גבול לניהול אפליקציות ברמת התיקייה.
   • פרויקט: גבול לניהול אפליקציות ברמת הפרויקט.

4. בשדה Project/Folder ID (מזהה הפרויקט או התיקייה), מזינים את מזהה הפרויקט או התיקייה של הגבול לניהול האפליקציות שבו נמצא המרחב החדש.

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

5. לוחצים על שיתוף.

   מפתחים יכולים לראות את התבניות מקטלוג משותף על ידי פתיחת המרחב שלהם ב-App Design Center ולחיצה על תבניות משותפות מתפריט הניווט.

‫CLI של gcloud

שיתוף קטלוג עם מרחב.

gcloud design-center spaces catalogs shares create SHARE \
--project=PROJECT \
--space=SPACE \
--location=LOCATION \
--catalog=CATALOG \
--destination-space=DESTINATION_SPACE

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

• ‫SHARE: מזהה השיתוף של השיתוף שרוצים למחוק.
• ‫PROJECT: מזהה פרויקט הניהול.
• ‫SPACE: מזהה המרחב.
• ‫LOCATION: האזור של הקטלוג.
• ‫CATALOG: מזהה הקטלוג של הקטלוג שמשתפים.
• ‫DESTINATION_SPACE: השם המוגדר במלואו של המרחב שאליו משתפים. לדוגמה, projects/my-project/locations/us-central1/spaces/my-space.

מידע נוסף זמין במאמר gcloud design-center spaces catalogs shares create.

הפסקת שיתוף קטלוג עם מרחב

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

קנבס העיצוב

1. בתפריט הניווט, לוחצים על קטלוגים.

   מעבר אל קטלוגים

2. לוחצים על מרחבים משותפים ששותפו עם.

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

   פעולות ובוחרים באפשרות הפסקת השיתוף.

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

‫CLI של gcloud

להפסיק לשתף קטלוג עם מרחב.

gcloud design-center spaces catalogs shares delete SHARE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG

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

• ‫SHARE: מזהה השיתוף של השיתוף שרוצים למחוק.
• ‫PROJECT: מזהה פרויקט הניהול.
• ‫LOCATION: האזור של הקטלוג.
• ‫SPACE: מזהה המרחב.
• ‫CATALOG: מזהה הקטלוג של הקטלוג שמשתפים.

מידע נוסף זמין במאמר gcloud design-center spaces catalogs shares delete.

עריכת מטא-נתונים של קטלוג

כדי לנהל את הקטלוג, אפשר לתת לו שם ותיאור שמתארים אותו. לשם כך:

קנבס העיצוב

1. בתפריט הניווט, לוחצים על קטלוגים.

   מעבר אל קטלוגים

2. בודקים את פרטי הקטלוג.

3. כדי לשנות את השם המוצג, מבצעים את הפעולות הבאות:

   1. לוחצים על עריכת השם המוצג.
   2. בשדה שם לתצוגה, מזינים את השם החדש.
   3. לוחצים על Save.

4. כדי לשנות את התיאור:

   1. לוחצים על עריכת התיאור.
   2. בשדה Description (תיאור), מזינים את התיאור החדש.
   3. לוחצים על Save.

‫CLI של gcloud

gcloud design-center spaces catalogs update CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--description=DESCRIPTION \
--display-name=DISPLAY_NAME

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

• ‫CATALOG: מזהה הקטלוג.
• ‫PROJECT: מזהה פרויקט הניהול.
• ‫LOCATION: האזור של הקטלוג.
• ‫SPACE: מזהה המרחב.
• ‫DESCRIPTION: תיאור הקטלוג.
• ‫DISPLAY_NAME: השם המוצג של הקטלוג.

מידע נוסף זמין במאמר gcloud design-center spaces catalogs update.

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

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