ניהול אפליקציות

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

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

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

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

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

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

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

יצירת טיוטה של אפליקציה

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

קנבס העיצוב

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

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

     אל "תבניות"

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

     מעבר אל 'תבניות משותפות'

2. לוחצים על מזהה התבנית שבה רוצים להשתמש.

3. באזור העיצוב, לוחצים על Configure an app (הגדרת אפליקציה) ואז על Create new application (יצירת אפליקציה חדשה).

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

   1. בשדה שם, מזינים מזהה ייחודי למרחב. לדוגמה, אפשר להשתמש בשילוב ייחודי של שם וסביבה כמו web-app-staging. זהו שדה חובה.

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

   2. בשדה שם לתצוגה, מזינים שם שיוצג במסוףGoogle Cloud .

   3. בשדה Description (תיאור), מזינים את המטרה של האפליקציה.

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

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

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

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

   • אם היקף האפליקציה הוא Global (ברירת מחדל), האזור יחול על רכיבים שלא הוגדר להם אזור.

   • אם היקף ההגדרה הוא אזורי, האזור חל על כל הרכיבים.

7. ברשימה Environment, בוחרים את הסביבה שבה רוצים לפרוס את האפליקציה הזו. לדוגמה, יכול להיות שתרצו לוודא שהפריסה פועלת כמצופה ב-TEST.

   הערה: אם אתם מתכננים לפרוס את האפליקציה הזו ואז למחוק אותה, כדאי לפרוס אותה אל TEST, DEVELOPMENT או STAGING.

8. ברשימה Criticality, בוחרים את מידת ההשפעה על העסק. לדוגמה, LOW או HIGH.

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

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

   • באזור בעלי חשבון פיתוח, מזינים בעלים שאחראי על פיתוח וקידוד.

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

10. ברשימה היקף ההרשאות, בוחרים אחת מהאפשרויות הבאות:

    • גלובלי (ברירת מחדל): האפליקציה מכילה משאב גלובלי, או שהמשאבים נמצאים בכמה אזורים.

    • אזורית: כל המשאבים נמצאים באזור אחד.

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

11. לוחצים על יצירת אפליקציה. פרטי האפליקציה מוצגים.

‫CLI של gcloud

1. מזהים את ה-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.

2. מעתיקים את הפלט של latestRevision.

3. יוצרים טיוטה של בקשה על סמך התבנית.

     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. אם היקף האפליקציה הוא 'גלובלי, the region is applied to components that don't already have a configured region. If the application scope isאזורי', האזור חל על כל הרכיבים.

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

הגדרת רכיבים וחיבורים

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

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

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

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

קנבס העיצוב

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

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

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

   • הפרויקט לא יכול להיות פרויקט ניהול.

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

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

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

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

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

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

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

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

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

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

5. לוחצים על Save.

‫CLI של gcloud

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

    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.

2. לכל רכיב שרוצים לשנות, יוצרים בספריית הבית קובץ 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"
          }
       ]
     }
   

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

    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-parameter.

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

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

עריכת קוד 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:

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

2. לוחצים על main.tf. המערכת מציגה את מודול Terraform לכל רכיב.

3. עריכת פרטי ההגדרה. מידע נוסף זמין במסמכי התיעוד בנושא הגדרות של כל משאב נתמך.

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

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

   1. לוחצים על הצגת ההבדלים.

   2. כדי לבטל שינוי, לוחצים בשוליים על Click to revert change (לחיצה לביטול השינוי).

   3. לוחצים על הצגת ההבדלים כדי לסגור את תצוגת ההשוואה.

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

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

   1. לוחצים על עיצוב.
   2. לוחצים על רכיב ובודקים את פרטי ההגדרה שלו.

יצירת גרסת אפליקציה

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

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

קנבס העיצוב

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

   מעבר אל Applications

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

3. כדי לשנות את פרטי האפליקציה:

4. לוחצים על עריכה ומשנים את הפרטים.

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

6. כדי לשנות רכיב באפליקציה הזו:

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

   2. לוחצים על Save כדי לשמור את השינויים.

‫CLI של gcloud

מידע נוסף זמין במאמר בנושא הגדרת רכיבים וחיבורים.

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

מחיקת אפליקציה

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

אפשר למחוק את האפליקציות הבאות:

• אפליקציה שלא נפרסה. בדף Applications (בקשות), הסטטוס Status (סטטוס) מופיע כDraft (טיוטה).
• אפליקציה שנפרסה בTEST, בDEVELOPMENT או בSTAGING Environment.

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

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

כדי למחוק אפליקציה:

קנבס העיצוב

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

   מעבר אל Applications

2. בטבלה, לוחצים על שם האפליקציה.

3. לוחצים על פעולות ובוחרים באפשרות מחיקת האפליקציה.

4. בשדה מחיקה, מזינים את שם האפליקציה.

5. לוחצים על 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.