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

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

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

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

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

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

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

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

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

קנבס לעיצוב

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

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

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

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

    1. כדי למצוא תבנית ספציפית, מקלידים את שם התבנית בשדה Filter.
    2. כדי להוסיף תבנית לקטלוג, בעמודה Actions לוחצים על Add to catalog.
  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 \
--force

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

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

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

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

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

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

קנבס לעיצוב

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

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

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

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

    • תיקייה: תחום לניהול אפליקציות ברמת התיקייה.
    • פרויקט: תחום לניהול אפליקציות ברמת הפרויקט.
  4. בשדה Project/Folder ID, מזינים את מזהה הפרויקט או התיקייה של התחום לניהול אפליקציות שבו נמצא המרחב המשותף שאליו רוצים להעביר את האפליקציה.

    המרחב באותו אזור כמו מרחב המקור מאוכלס באופן אוטומטי בשדה Space name.

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

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

‫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-dest-project/locations/us-central1/spaces/my-dest-space.

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

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

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

קנבס לעיצוב

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

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

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

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

    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. כדי לשנות את ה-Description:

    1. לוחצים על עריכת התיאור.
    2. בשדה תיאור, מזינים את התיאור החדש.
    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.

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