עיצוב תבניות מורכבות

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

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

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

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

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

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

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

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

מציינים את פרטי התבנית

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

כדי להזין את פרטי התבנית:

קנבס לעיצוב

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

    אל "תבניות"

  2. ברשימה Region, בוחרים את המיקום של התבנית. אם אתם מתכננים ליצור פריסה מותאמת לעומס ב-App Lifecycle Manager, בחרו באפשרות global.

  3. ברשימה Create Template, בוחרים באפשרות Composite template.

  4. השדה מזהה התבנית מאוכלס באופן אוטומטי. לחלופין, אפשר להזין מזהה ייחודי לתבנית. חובה למלא את השדה הזה.

  5. בשדה Template Name, מזינים מזהה קריא לאנשים שיוצג במסוף Google Cloud .

    אם לא תזינו שם, מזהה התבנית יועתק לשדה הזה.

  6. בשדה Description, מזינים הסבר קצר על מטרת האפליקציה.

  7. לוחצים על יצירת תבנית. אזור העריכה של העיצוב מוצג.

‫CLI של gcloud

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

gcloud design-center spaces application-templates create APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--display-name=DISPLAY_NAME \
--description=DESCRIPTION \
--composition-type=COMPOSITE

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

  • ‫APPLICATION_TEMPLATE: המזהה של תבנית האפליקציה שרוצים ליצור.
  • ‫PROJECT: מזהה הפרויקט לניהול.
  • ‫LOCATION: האזור של תבנית האפליקציה. אם אתם מתכננים ליצור פריסה מותאמת לעומס ב-App Lifecycle Manager, השתמשו ב-global.
  • ‫SPACE: מזהה המרחב המשותף.
  • ‫DISPLAY_NAME: השם שיוצג במסוף Google Cloud .
  • ‫DESCRIPTION: תיאור קצר.

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

עיצוב התבנית

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

בזמן שאתם מעצבים את התבנית, App Design Center יוצר קוד Terraform שמשקף את פרטי העיצוב וההגדרות.

כדי לעצב את התבנית:

קנבס לעיצוב

  1. באזור העריכה, לוחצים על עיצוב כדי לראות את האזור.

  2. כדי להתחיל, מבצעים אחת מהפעולות הבאות:

    • כדי להתחיל מתבנית ש-Google מספקת, באזור Get Started בלוח הציור לוחצים על שם התבנית.

    • כדי להתחיל עם קנבס ריק, עוברים לשלב הבא.

  3. כדי להוסיף תבנית אפליקציה רגילה לאזור העריכה:

    1. באזור רכיבים, לוחצים על הטמעת תבניות.

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

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

  4. כדי ליצור תבנית חדשה של בקשה רגילה, לוחצים על יצירת תבנית חדשה. הדף Create new template נפתח.

    מידע נוסף זמין במאמר עיצוב תבניות סטנדרטיות של בקשות.

  5. כדי להוסיף רכיב לאזור העריכה, לוחצים על רכיב באזור רכיבים.

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

    • גוררים מנקודה כחולה באבן בניין אחת לנקודה כחולה באבן בניין אחרת.

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

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

  7. כדי להסיר אבן בניין או חיבור:

    1. ב-canvas, לוחצים על אבן הבניין או על החיבור.

    2. באזור Configuration, לוחצים על Delete.

    3. בשדה, מזינים delete.

    4. לוחצים על Delete.

‫CLI של gcloud

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

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

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

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

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

  2. מזהים את מזהי ה-URI של גרסאות התבניות של אבני הבניין בקטלוג של Google שרוצים להוסיף לתבנית.

    gcloud design-center spaces shared-templates list \
    --google-catalog \
    --location=us-central1
    

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

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

    gcloud design-center spaces application-templates components create COMPONENT \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --application-template=APPLICATION_TEMPLATE \
    --shared-template-revision-uri=SHARED_TEMPLATE_URI
    

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

    • ‫COMPONENT: המזהה של תבנית האפליקציה הרגילה או הרכיב שרוצים להוסיף לתבנית.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: האזור של תבנית האפליקציה.
    • ‫SPACE: מזהה המרחב המשותף.
    • ‫APPLICATION_TEMPLATE: מזהה התבנית של תבנית האפליקציה המשולבת שאליה מוסיפים את תבנית האפליקציה הרגילה או את הרכיב.
    • ‫SHARED_TEMPLATE_URI: ה-URI של תבנית האפליקציה הרגילה או של התבנית המשותפת של הרכיב. לדוגמה, projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1.

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

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

    gcloud design-center spaces application-templates components create COMPONENT_2 \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --application-template=APPLICATION_TEMPLATE \
    --shared-template-revision-uri=SHARED_TEMPLATE_URI_2
    

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

    • ‫COMPONENT_2: המזהה של תבנית האפליקציה או הרכיב הרגילים השניים שרוצים להוסיף לתבנית.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: האזור של תבנית האפליקציה.
    • ‫SPACE: מזהה המרחב המשותף.
    • ‫APPLICATION_TEMPLATE: מזהה התבנית של התבנית המורכבת שאליה מוסיפים את התבנית או הרכיב הרגילים של האפליקציה.
    • ‫SHARED_TEMPLATE_URI_2: ה-URI של תבנית האפליקציה הרגילה השנייה או של התבנית המשותפת של הרכיב. לדוגמה, projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1.

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

  5. ליצור חיבור בין התבניות או הרכיבים הרגילים של האפליקציה.

    gcloud design-center spaces application-templates components connections create CONNECTION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --application-template=APPLICATION_TEMPLATE \
    --component=COMPONENT \
    --destination-component-uri=COMPONENT_2
    

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

    • ‫CONNECTION: מזהה החיבור שרוצים להוסיף לתבנית.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: האזור של תבנית האפליקציה.
    • ‫SPACE: מזהה המרחב המשותף.
    • ‫APPLICATION_TEMPLATE: מזהה התבנית של האפליקציה שאליה מוסיפים את החיבור.
    • ‫COMPONENT: המזהה של תבנית האפליקציה או הרכיב הרגילים במקור.
    • ‫COMPONENT_2: מזהה הרכיב או תבנית האפליקציה הרגילה של היעד.

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

הגדרת ערכי ברירת מחדל לרכיבים

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

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

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

כדי להגדיר רכיבים וחיבורים:

קנבס לעיצוב

  1. לוחצים על רכיב באזור העריכה.

  2. באזור Configuration, ברשימה Project ID בוחרים את הפרויקט שבו רוצים לפרוס את המשאב. בוחרים פרויקט שעומד בדרישות הבאות:

  3. קובעים הגדרות נוספות למשאב. לדוגמה, ב-Cloud SQL אפשר להגדיר את הדברים הבאים:

    • אזור
    • הגדרת הגיבוי
    • דגלים לניהול מסדי נתונים
    • תצורת IP

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

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

    1. ב-design canvas, לוחצים על החיבור בין שני רכיבים. החלונית Connection נפתחת ומוצגים בה פרמטרים של החיבור.

    2. מבצעים אחת מהפעולות הבאות:

      • כדי לשנות פרמטר קיים של חיבור, לוחצים על Edit.

      • כדי להוסיף פרמטר חיבור חדש, לוחצים על Add parameter.

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

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

‫CLI של gcloud

  1. כדי לראות את הפרמטרים של הרכיבים, צריך לתאר כל רכיב בתבנית האפליקציה.

    gcloud design-center spaces application-templates components describe COMPONENT \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --application-template=APPLICATION_TEMPLATE
    

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

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

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

  2. לכל רכיב שרוצים לשנות, יוצרים קובץ JSON בספריית הבית שמכיל את ערכי הפרמטרים.

    לדוגמה, אפשר ליצור את הקובץ הבא לרכיב Cloud Run:

      [
          {
            "key": "service_name",
            "value": "frontend-service"
          },
          {
            "key": "project_id",
            "value": "DEPLOYMENT_PROJECT"
          }
      ]
    
  3. מעדכנים כל רכיב בתבנית האפליקציה כדי להגדיר את הפרמטרים הנדרשים.

    gcloud design-center spaces application-templates components update COMPONENT \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --parameters=PARAMETERS_FILE_PATH \
    --application-template=APPLICATION_TEMPLATE
    

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

    • ‫COMPONENT: מזהה הרכיב שרוצים לעדכן.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: האזור של תבנית האפליקציה.
    • ‫SPACE: מזהה המרחב המשותף.
    • ‫PARAMETERS_FILE_PATH: קובץ JSON שכולל פרמטרים של רכיבים.
    • ‫APPLICATION_TEMPLATE: מזהה התבנית של תבנית האפליקציה.

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

  4. תארו את החיבורים בין הרכיבים.

    gcloud design-center spaces application-templates components connections describe CONNECTION \
    --component=COMPONENT \
    --application-template=APPLICATION_TEMPLATE \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE
    

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

    • ‫CONNECTION: מזהה החיבור.
    • ‫COMPONENT: מזהה הרכיב.
    • ‫APPLICATION_TEMPLATE: מזהה התבנית.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: האזור של תבנית האפליקציה.
    • ‫SPACE: מזהה המרחב המשותף.

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

  5. עריכת הפרמטרים של החיבור לרכיב.

    gcloud design-center spaces application-templates components connections update CONNECTION \
        --component=COMPONENT \
        --application-template=APPLICATION_TEMPLATE \
        --project=PROJECT \
        --location=LOCATION \
        --space=SPACE \
        --source-component-parameters='[{"key": "SOURCE_KEY", "value": "SOURCE_VALUE"}]'
    

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

    • ‫CONNECTION: מזהה החיבור.
    • ‫COMPONENT: מזהה הרכיב.
    • ‫APPLICATION_TEMPLATE: מזהה התבנית.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: האזור של תבנית האפליקציה.
    • ‫SPACE: מזהה המרחב המשותף.
    • ‫SOURCE_KEY: מפתח הפרמטר החדש.
    • SOURCE_VALUE: ערך הפרמטר החדש.

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

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

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

  • כל קבוצה של תבניות סטנדרטיות לאפליקציות.
  • כל קבוצה של רכיבים.

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

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

קנבס לעיצוב

  1. ב-design canvas, לוחצים על תבנית סטנדרטית של אפליקציה.

    החלונית Embedded Template נפתחת.

  2. באזור Configuration, מזינים את פרטי האפליקציה.

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

‫CLI של gcloud

מידע נוסף זמין במאמר עיצוב התבנית.

מניעת התנגשויות בין שמות של משתנים

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

כדי למנוע התנגשויות בין שמות של משתנים, אפשר למפות את שם המשתנה של רכיב לשם חלופי ייחודי בתבנית המורכבת. לדוגמה, אפשר למפות את project_id ל-database_project_id בשביל רכיב של מסד נתונים, ואת service_project_id בשביל רכיב של שירות.

כללי אימות לשמות חלופיים של משתנים

חשוב לוודא שהכינויים של המשתנים עומדים בדרישות הבאות:

  • אפשר ליצור כינויים למשתנים רק בתבניות של אפליקציות מורכבות (--composition-type=COMPOSITE).

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

  • שמות המשתנים והשמות החלופיים חייבים להיות מחרוזות לא ריקות.

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

  • אם לכמה משתנים יש את אותו כינוי, סוגי הנתונים של המשתנים צריכים להיות תואמים.

הגדרת שמות חלופיים למשתנים באמצעות ה-CLI של gcloud

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

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

הוספת כינויים כשיוצרים רכיב

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

gcloud design-center spaces application-templates components create \
    COMPONENT \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --application-template=APPLICATION_TEMPLATE \
    --shared-template-revision-uri=SHARED_TEMPLATE_URI \
    --input-variable-aliases=variable=VARIABLE_NAME,alias=ALIAS_NAME

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

  • ‫COMPONENT: המזהה של התבנית או הרכיב של האפליקציה הרגילה שרוצים להוסיף לתבנית.

  • ‫PROJECT: מזהה הפרויקט לניהול.

  • ‫LOCATION: האזור של תבנית האפליקציה.

  • ‫SPACE: מזהה המרחב המשותף.

  • ‫APPLICATION_TEMPLATE: מזהה התבנית של תבנית האפליקציה המורכבת.

  • ‫SHARED_TEMPLATE_URI: ה-URI של גרסת התבנית הרגילה של האפליקציה או של התבנית המשותפת של הרכיב.

  • ‫VARIABLE_NAME: שם המשתנה הפנימי ברכיב שרוצים לתת לו כינוי.

  • ‫ALIAS_NAME: השם הייחודי של השם הסודי שמשמש למשתנה הקלט של התבנית.

כדי להגדיר כמה כינויים כשיוצרים רכיב, חוזרים על הדגל --input-variable-aliases, מספקים רשימת JSON או מספקים קובץ YAML או JSON:

  • חוזרים על הדגל: --input-variable-aliases=variable=v1,alias=a1 --input-variable-aliases=variable=v2,alias=a2

  • מזינים רשימת JSON: --input-variable-aliases='[{"variable": "v1", "alias": "a1"}, {"variable": "v2", "alias": "a2"}]'

  • מזינים קובץ YAML או JSON: --input-variable-aliases=path/to/aliases.yaml

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

עדכון כינויים ברכיב קיים

כדי להוסיף כינוי לרכיב קיים בתבנית מורכבת, משתמשים בדגל --add-input-variable-aliases עם הפקודה components update:

gcloud design-center spaces application-templates components update \
    COMPONENT \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --application-template=APPLICATION_TEMPLATE \
    --add-input-variable-aliases=variable=VARIABLE_NAME,alias=ALIAS_NAME

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

  • ‫COMPONENT: המזהה של הרכיב שרוצים לעדכן.

  • ‫PROJECT: מזהה הפרויקט לניהול.

  • ‫LOCATION: האזור של תבנית האפליקציה.

  • ‫SPACE: מזהה המרחב המשותף.

  • ‫APPLICATION_TEMPLATE: מזהה התבנית של תבנית האפליקציה המורכבת.

  • ‫VARIABLE_NAME: שם המשתנה הפנימי ברכיב שרוצים לתת לו כינוי.

  • ‫ALIAS_NAME: השם הייחודי של השם הסודי שמשמש למשתנה הקלט של התבנית.

כדי להוסיף כמה כתובות אימייל חלופיות, חוזרים על הדגל --add-input-variable-aliases או מספקים רשימה או קובץ בפורמט JSON.

ניהול כתובות אימייל חלופיות קיימות

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

  • כדי להסיר שם חלופי קיים מרכיב:

    gcloud design-center spaces application-templates components update \
        COMPONENT \
        --project=PROJECT \
        --location=LOCATION \
        --space=SPACE \
        --application-template=APPLICATION_TEMPLATE \
        --remove-input-variable-aliases=variable=VARIABLE_NAME,alias=ALIAS_NAME
    
  • הסרת כל השמות החלופיים של המשתנים מרכיב:

    gcloud design-center spaces application-templates components update \
        COMPONENT \
        --project=PROJECT \
        --location=LOCATION \
        --space=SPACE \
        --application-template=APPLICATION_TEMPLATE \
        --clear-input-variable-aliases
    
  • אפשר להחליף את כל השמות החלופיים הקיימים ברשימה חדשה, או לספק שמות חלופיים בקובץ YAML או JSON:

    gcloud design-center spaces application-templates components update \
        COMPONENT \
        --project=PROJECT \
        --location=LOCATION \
        --space=SPACE \
        --application-template=APPLICATION_TEMPLATE \
        --input-variable-aliases=ALIASES_FILE_PATH
    

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

    • ‫ALIASES_FILE_PATH: הנתיב המקומי לקובץ YAML או JSON שמכיל את השמות החלופיים של המשתנים.

    מגדירים את הפורמט של קובץ ה-YAML או ה-JSON עם רשימה של זוגות של משתנים ושמות חלופיים. לדוגמה:

    - variable: "db_password"
      alias: "database_password"
    - variable: "project_id"
      alias: "database_project_id"
    

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

אימות התבנית

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

כדי לאמת את התבנית:

  1. ב-design canvas, לוחצים על Continue ובוחרים באפשרות Create application to deploy.

    החלונית Create an application תיפתח.

  2. באזור Composite application details, מזינים את פרטי האפליקציה.

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

  3. לוחצים על הבא.

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

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

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

  6. כדי להימנע מעלויות חוזרות, מחקו את פריסת הבדיקה.

יצירת פריסה מותאמת לעומס

כדי לפרוס ולנהל כמה מופעים של התבנית המורכבת, משתמשים ב-App Lifecycle Manager.

  1. מאמתים את התבנית ב-App Design Center.

  2. ב-design canvas, לוחצים על Continue ובוחרים באפשרות Deploy at scale with App Lifecycle Manager.

    ‫App Lifecycle Manager נפתח במסוף Google Cloud .

  3. כדי לפרוס ב-App Lifecycle Manager, קראו את המאמר פריסת מוצר SaaS.

איך לשתף את התבנית

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

כדי לשתף את התבנית:

  1. ב-design canvas, לוחצים על הוספה לקטלוג.

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

תיקון התבנית ושיתוף מחדש שלה

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

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

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

כדי ליצור גרסה חדשה:

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

    אל "תבניות"

  2. בוחרים את תבנית הבקשה שרוצים לשנות. אזור העריכה נפתח.

  3. משנים את התבנית בהתאם לדרישות החדשות. לדוגמה, להוסיף ולהגדיר רכיב חדש.

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

איך מוחקים תבניות

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

קנבס לעיצוב

  1. במסך העיצוב, לוחצים על פעולות.
  2. לוחצים על Delete.

‫CLI של gcloud

מחיקת תבנית של אפליקציה.

```sh
gcloud design-center spaces application-templates delete APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
```

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

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

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

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