כשיוצרים טיוטת אפליקציה מתבנית ב-Application Design Center, אפשר להתאים אישית ולפרוס מכונות נפרדות של האפליקציה בסביבות כמו בדיקה וייצור. כשיוצרים טיוטת אפליקציה, מציינים מאפיינים כדי לסווג ולסנן את האפליקציה, מגדירים רכיבים וחיבורים, ואם רוצים, עורכים את קוד Terraform שנוצר. אתם יכולים גם ליצור גרסאות חדשות כשהדרישות משתנות, ולמחוק את האפליקציה כשאתם לא צריכים יותר את המשאבים שנפרסו.
לפני שמתחילים
כדי לבצע את המשימות שמפורטות במסמך הזה, בקשו מהאדמין להקצות לכם את התפקידים הנדרשים בתיקייה לניהול אפליקציות או בפרויקט הניהול, כמו שמפורט בטבלה הבאה:
| משימה | התפקידים הנדרשים |
|---|---|
| ליצור, להגדיר, לערוך ולשמור גרסאות של טיוטות של אפליקציות | אדמין ב-Application Design Center (roles/designcenter.admin), אואדמין של אפליקציה ( roles/designcenter.applicationAdmin), אועריכת אפליקציה ( roles/designcenter.applicationEditor) |
| מחיקת אפליקציה | אדמין ב-Application Design Center (roles/designcenter.admin) אואדמין באפליקציה ( roles/designcenter.applicationAdmin) |
מידע נוסף על תפקידים זמין במאמר בקרת גישה באמצעות IAM.
יצירת טיוטה של בקשה
יצירת טיוטת אפליקציה מתבנית על ידי ציון פרטים, ואפשרות לשנות את הגדרות הרכיבים. אחר כך אפשר לפרוס את הטיוטה כדי ליצור אפליקציה.
קנבס לעיצוב
בתפריט הניווט, מבצעים אחת מהפעולות הבאות:
כדי לראות את התבניות שנוצרו במרחב המשותף, לוחצים על תבניות.
כדי לראות תבניות ששותפו ממרחב עבודה אחר, לוחצים על תבניות משותפות.
לוחצים על מזהה התבנית שרוצים להשתמש בה.
ב-design canvas, לוחצים על Configure an app ואז על Create new application.
בקטע Application name, נותנים שם לאפליקציה ומוסיפים תיאור:
בשדה Name, מזינים מזהה ייחודי במרחב הזה. לדוגמה, אפשר להשתמש בשילוב ייחודי של שם וסביבה, כמו
web-app-staging. זהו שדה חובה.אפשר להשתמש בעד 63 תווים, כולל אותיות קטנות, מספרים ומקפים. השם צריך להתחיל באות קטנה ולא יכול להסתיים במקף. אי אפשר לשנות את השמות.
בשדה Display name, מזינים את השם שיוצג במסוףGoogle Cloud .
בשדה Description, מזינים את מטרת האפליקציה.
כדי להגדיר פרויקט ברירת מחדל לכל הרכיבים שבהם השדה מזהה פרויקט ריק, בוחרים פרויקט מהרשימה Deployment project. בגבול ברמת התיקייה, הפרויקט צריך לעמוד בתנאים הבאים:
- הפרויקט חייב להיות בתוך התיקייה לניהול אפליקציות שנבחרה.
- הפרויקט לא יכול להיות פרויקט ניהול.
אם לרכיב כבר יש פרויקט שצוין בשדה מזהה פרויקט, הפרויקט הזה ישמש במקום ההגדרה הזו.
ברשימה Region, בוחרים את האזור שבו הרכיבים פרוסים. האזור של הרכיב נקבע לפי:
אם היקף האפליקציה הוא Global (ברירת המחדל), האזור יחול על רכיבים שעדיין לא הוגדר להם אזור.
אם היקף האפליקציה הוא Regional, האזור חל על כל הרכיבים.
ברשימה Environment, בוחרים את הסביבה שבה רוצים לפרוס את האפליקציה. לדוגמה, יכול להיות שתרצו לוודא שהפריסה פועלת כמו שצריך ב-
TEST.ברשימה Criticality, בוחרים את מידת ההשפעה על העסק. לדוגמה,
LOWאוHIGH.כדי לציין בעלים, באזור Owners לוחצים על Add owner ומזינים שם לתצוגה וכתובת אימייל עבור:
באזור Business owners, מזינים בעל עסק שאחראי על האיכות ועל הציפיות של המשתמשים.
באזור בעלים של פיתוח, מזינים בעלים שאחראי על הפיתוח והתכנות.
באזור Operator owners, מזינים בעלים שאחראי על הפעלת האפליקציה.
ברשימה היקף, בוחרים אחת מהאפשרויות הבאות:
גלובלי (ברירת המחדל): האפליקציה מכילה משאב גלובלי, או שהמשאבים נמצאים בכמה אזורים.
אזורית: כל המשאבים נמצאים באזור אחד.
זהו שדה חובה. מידע נוסף זמין במאמר אפליקציות גלובליות, אזוריות ובמספר אזורים.
לוחצים על Create Application. פרטי האפליקציה מוצגים.
CLI של gcloud
מזהים את ה-URI של גרסת תבנית האפליקציה שבה רוצים להשתמש כדי ליצור את האפליקציה.
gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --format='yaml(name,latestRevision)'מחליפים את מה שכתוב בשדות הבאים:
-
APPLICATION_TEMPLATE: מזהה התבנית של האפליקציה שרוצים להשתמש בה כבסיס לאפליקציה. -
PROJECT: מזהה הפרויקט לניהול. -
LOCATION: האזור של תבנית האפליקציה. -
SPACE: מזהה המרחב המשותף.
מידע נוסף זמין במאמר gcloud design-center spaces application-templates describe.
-
מעתיקים את הפלט של
latestRevision.יוצרים טיוטת אפליקציה על סמך התבנית.
gcloud design-center spaces applications create APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION \ --scope-type=SCOPE_TYPEמחליפים את מה שכתוב בשדות הבאים:
-
APPLICATION: מזהה האפליקציה של טיוטת הבקשה שרוצים ליצור. -
PROJECT: מזהה הפרויקט לניהול. -
LOCATION: האזור של האפליקציה. -
SPACE: מזהה המרחב המשותף. -
SOURCE_APPLICATION_TEMPLATE_REVISION: ה-URI של גרסת תבנית האפליקציה, למשלprojects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION. -
SCOPE_TYPE: היקף ההרשאות של האפליקציה. regionalאוglobal. אם היקף האפליקציה הואglobal, האזור יחול על רכיבים שעדיין לא הוגדר להם אזור. אם היקף האפליקציה הואregional, האזור חל על כל הרכיבים.
מידע נוסף זמין במאמר gcloud design-center spaces applications create.
-
הגדרת רכיבים וחיבורים
לכל רכיב באפליקציה אפשר לציין פרטי הגדרה, כמו הפרויקט שבו נוצר המשאב והמיקום שבו הוא נפרס.
אם הגדרות ברירת המחדל לא מתאימות לדרישות שלכם, אתם יכולים לשנות את פרטי החיבור. לדוגמה, אתם יכולים לשנות את שמות המפתחות של משתני הסביבה, לשנות את יציאות החיבור או להוסיף תפקידים לחשבונות השירות.
צריך להגדיר את הפרטים הנדרשים לכל משאב נתמך.
כדי להגדיר רכיבים וחיבורים:
קנבס לעיצוב
לוחצים על רכיב באזור העריכה.
באזור Configuration, ברשימה Project ID בוחרים את הפרויקט שבו רוצים לפרוס את המשאב. בוחרים פרויקט שעומד בדרישות הבאות:
הפרויקט חייב להיות בתוך התיקייה לניהול אפליקציות שנבחרה.
הפרויקט לא יכול להיות פרויקט ניהול.
קובעים הגדרות נוספות למשאב. לדוגמה, ב-Cloud SQL אפשר להגדיר את הדברים הבאים:
- אזור
- הגדרת הגיבוי
- דגלים לניהול מסדי נתונים
- תצורת IP
בקטע משאבים נתמכים יש קישורים למסמכי הגדרה של כל רכיב.
כשמחברים רכיבים בלוח העריכה, נוצר חיבור עם ערכי הגדרות ברירת המחדל. כדי להוסיף או לשנות את פרטי החיבור:
ב-design canvas, לוחצים על החיבור בין שני רכיבים. החלונית Connection נפתחת ומוצגים בה פרמטרים של החיבור.
מבצעים אחת מהפעולות הבאות:
כדי לשנות פרמטר קיים של חיבור, לוחצים על Edit.
כדי להוסיף פרמטר חיבור חדש, לוחצים על Add parameter.
מעדכנים את השדות מפתח וערך. לדוגמה, יכול להיות שתרצו לשנות את הפרטים הבאים:
- שמות המפתחות של משתני הסביבה, בהתאם לדרישות של האפליקציה.
- ערך היציאה של החיבור.
- התפקידים שנוספו לחשבון השירות.
לוחצים על Save.
CLI של gcloud
תארו את האפליקציה כדי לראות את הפרמטרים של הרכיבים, וזהו את הפרמטרים הנדרשים לאפליקציה שלכם.
gcloud design-center spaces applications describe APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --format='yaml(name,componentParameters)'מחליפים את מה שכתוב בשדות הבאים:
-
APPLICATION: מזהה האפליקציה. -
PROJECT: מזהה הפרויקט לניהול. -
LOCATION: האזור של האפליקציה. -
SPACE: מזהה המרחב המשותף.
מידע נוסף זמין במאמר gcloud design-center spaces applications describe.
-
לכל רכיב שרוצים לשנות, יוצרים קובץ JSON שמכיל ערכי פרמטרים בספריית הבית.
לדוגמה, אפשר ליצור את הקובץ הבא לרכיב Cloud Run:
{ "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT", "parameters": [ { "key": "service_name", "value": "frontend-service" }, { "key": "project_id", "value": "DEPLOYMENT_PROJECT" } ] }מעדכנים את האפליקציה כדי להגדיר את הפרמטרים הנדרשים.
gcloud design-center spaces applications update APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --component-parameters=COMPONENT_FILE_PATH_1מחליפים את מה שכתוב בשדות הבאים:
-
APPLICATION: מזהה האפליקציה. -
PROJECT: מזהה הפרויקט לניהול. -
LOCATION: האזור של האפליקציה. -
SPACE: מזהה המרחב המשותף. -
COMPONENT_FILE_PATH_1: הנתיב לקובץ JSON שכולל פרמטרים של רכיבים. לכל קובץ JSON נוסף, מוסיפים עוד דגל--component-parametersוערך.
מידע נוסף זמין במאמר gcloud design-center spaces applications update.
-
במאמר פריסת אפליקציות מוסבר איך לפרוס אפליקציות.
אימות תאימות אבטחה
אתם יכולים לבצע הערכת אבטחה של האפליקציה כדי לאמת את ההגדרות האישיות שלכם בהתאם למסגרות של Security Command Center. ההערכה המקיפה הזו בודקת את הדברים הבאים:
- ערכי הגדרות הרכיבים: הגדרות התצורה שעברו בירושה באופן אוטומטי מהתבנית, או הגדרות ששיניתם לאפליקציה הזו.
- פרמטרים של האפליקציה: הפרטים הספציפיים למכונה שסופקו לאפליקציה, כמו אזור הפריסה או הסביבה.
- רכיבים מותרים: השירותים ועומסי העבודה באפליקציה הנוכחית שמותרים לשימוש בארגון.
האפליקציות יורשות את המסגרות של Security Command Center מהתבנית שלהן. קודם כל, האדמין צריך לצרף מסגרת אבטחה לתבנית האפליקציה. לאחר מכן, מבצעים את הפעולות הבאות כדי להעריך את התאימות של האפליקציה לדרישות האבטחה:
CLI של gcloud
יוצרים דוח הערכה לאפליקציה:
gcloud alpha design-center spaces applications generate-assessment-report \
APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
מחליפים את מה שכתוב בשדות הבאים:
-
APPLICATION: מזהה האפליקציה שרוצים לבדוק. -
PROJECT: מזהה הפרויקט לניהול. -
LOCATION: האזור של האפליקציה. -
SPACE: מזהה המרחב המשותף.
בפלט מוצג דוח הערכה של האפליקציה על סמך המסגרות שמצורפות לתבנית. מידע נוסף זמין במאמר gcloud alpha design-center spaces applications generate-assessment-report.
עריכת קוד ב-Terraform
האפליקציה יוצרת קוד Terraform שמשקף את פרטי העיצוב וההגדרות. אתם יכולים לערוך את Terraform כדי לציין את פרטי ההגדרות של הרכיבים.
המערכת יוצרת את קובצי Terraform הבאים:
-
main.tf: קוד תשתית שכולל מודול לכל רכיב בתבנית. -
outputs.tf: חשיפת מידע על רכיבי התשתית שנפרסו. -
variables.tf: הצהרה על השם, הסוג והתיאור של המשתנים שמשמשים בקובץmain.tf. -
input.tfvars: הגדרת ערכים למשתנים שמשמשים בקובץmain.tf. -
providers.tf: מגדיר תוויות שעוזרות ל-Terraform לקיים אינטראקציה עם ממשקי ה-API והמשאבים של Google Cloud .
למידע רקע, ראו סקירה כללית על Terraform ב-Google Cloud.
כדי לערוך את קוד Terraform:
בסביבת העבודה של העיצוב, לוחצים על קוד. המערכת מציגה את קובצי Terraform שנוצרו.
לוחצים על main.tf. המערכת מציגה את המודול של Terraform לכל רכיב.
עורכים את פרטי ההגדרות האישיות. מידע נוסף זמין במסמכי התיעוד של ההגדרות לכל משאב נתמך.
המערכת מאמתת את השינויים באופן אוטומטי, ומציגה שגיאות אם השינויים לא תקינים.
כדי להדגיש את העריכות ולהשוות ביניהן:
לוחצים על השוואה מול המילון.
כדי לבטל שינוי, לוחצים על לחיצה לביטול השינוי בשוליים.
לוחצים על הצגת ההבדלים כדי לסגור את תצוגת ההשוואה.
כדי לשמור את השינויים, לוחצים על שמירת השינויים בקוד.
כדי לוודא שהשינויים בוצעו:
- לוחצים על עיצוב.
- לוחצים על רכיב ובודקים את פרטי ההגדרות שלו.
יצירת גרסה של אפליקציה
כדי לשנות פרטים או רכיבים, יוצרים גרסה חדשה של הבקשה. אם משנים רכיבים באפליקציה מחוץ ל-App Design Center, השינויים האלה לא נשמרים כשפורסים מחדש.
כדי ליצור גרסה של אפליקציה:
קנבס לעיצוב
בתפריט הניווט, לוחצים על אפליקציות.
בטבלה, לוחצים על שם האפליקציה שרוצים לשנות.
כדי לשנות את פרטי האפליקציה:
- לוחצים על עריכה ומשנים את הפרטים.
- לוחצים על Save כדי לשמור את השינויים.
כדי לשנות רכיב באפליקציה הזו:
לוחצים על הרכיב בקנבס העיצוב ועורכים את הפרטים באזור Configuration.
לוחצים על Save כדי לשמור את השינויים.
CLI של gcloud
במאמר פריסת אפליקציות מוסבר איך לפרוס אפליקציות.
מחיקת אפליקציה
אם אתם לא צריכים יותר אפליקציה מסוימת, אתם יכולים למחוק אותה. לדוגמה, אתם יכולים לפרוס אפליקציה כדי לאמת את התבנית בסביבת TEST, ואז למחוק את האפליקציה.
אתם יכולים למחוק את האפליקציות הבאות:
- אפליקציה שלא נפרסה. בדף Applications, הסטטוס (Status) מופיע כ-Draft.
- אפליקציה שנפרסה בסביבה של
TEST,DEVELOPMENTאוSTAGING.
כשמוחקים אפליקציה, קורים הדברים הבאים:
- פרטי האפליקציה יוסרו מ-App Design Center.
- האפליקציה הבסיסית ב-App Hub נמחקת.
- אם פרסתם, המשאבים נמחקים.
כדי למחוק אפליקציה:
קנבס לעיצוב
בתפריט הניווט, לוחצים על אפליקציות.
בטבלה, לוחצים על שם האפליקציה.
לוחצים על Actions ובוחרים באפשרות Delete Application.
בשדה Delete, מזינים את שם האפליקציה.
לוחצים על Delete.
CLI של gcloud
למחוק אפליקציה.
gcloud design-center spaces applications delete APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
מחליפים את מה שכתוב בשדות הבאים:
-
APPLICATION: מזהה האפליקציה שרוצים למחוק. -
PROJECT: מזהה הפרויקט לניהול. -
LOCATION: האזור של האפליקציה.
SPACE: מזהה המרחב המשותף.מידע נוסף זמין במאמר gcloud design-center spaces applications delete.
המאמרים הבאים
- להקצות את התשתית באמצעות המסוף או שורת הפקודה על ידי פריסת אפליקציות.
- מורידים ופורסים את Terraform כדי לייצא את ההגדרות של Terraform למכונה המקומית או למאגר.