פריסת אפליקציות

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

• אפשר לראות בתצוגה מקדימה את השינויים ש-Terraform מתכננת לבצע בתשתית.
• מפעילים Google Cloud ממשקי API של משאבים שנדרשים לאפליקציה.
• בודקים את הסיבות לבעיות בפריסה.
• אפשר להשתמש בנתוני טלמטריה כדי לנתח את ביצועי המשאבים.
• זיהוי של עדכוני תבניות והחלתם על האפליקציה.

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

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

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

משימה	התפקידים הנדרשים
פריסת אפליקציה והחלת שינויים בתבנית	אדמין של אפליקציה (roles/designcenter.applicationAdmin) או מפעיל אפליקציה (roles/designcenter.applicationOperator)
יצירה אוטומטית של חשבון שירות במהלך הפריסה	אדמין IAM בפרויקט (roles/resourcemanager.projectIamAdmin)

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

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

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

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

קנבס העיצוב

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

   מעבר אל Applications

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

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

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

4. לוחצים על פריסה.

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

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

   • יצירת חשבון שירות חדש: אתם צריכים את התפקיד Project IAM Admin ‏(roles/resourcemanager.projectIamAdmin), שמשמש להקצאת תפקידי הפריסה הנדרשים לחשבון השירות.

6. לוחצים על המשך.

7. כדי לראות תצוגה מקדימה של השינויים ש-Terraform מתכנן לבצע בתשתית, מבצעים את הפעולות הבאות:

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

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

   3. כדי לשמור את התצוגה המקדימה, מדביקים ושומרים אותה במסמך הרצוי.

8. באזור Review APIs, בודקים את רשימת ממשקי ה-API שנדרשים לאפליקציה. ממשקי ה-API מופעלים באופן אוטומטי כשמבצעים פריסה.

9. לוחצים על פריסה. פרטי האפליקציה וסטטוס הפריסה מוצגים בסיום הפריסה.

10. אם יש בעיות בהטמעה, צריך לבצע את הפעולות הבאות:

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

    2. בודקים את הודעות השגיאה.

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

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

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

    טיפ: כדי לראות רשימה של אפליקציות עם בעיות פריסה ב-Cloud Hub, אפשר לעיין במאמר הצגת פריסות.

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

‫CLI של gcloud

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

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

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --create-sa \
     --service-account=SERVICE_ACCOUNT
     

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

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --service-account=SERVICE_ACCOUNT
     

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

   • ‫APPLICATION: מזהה האפליקציה.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של האפליקציה.
   • ‫SPACE: מזהה המרחב.
   • ‫SERVICE_ACCOUNT: מבצעים אחת מהפעולות הבאות:
     • כדי ליצור חשבון שירות חדש, צריך לציין שם לחשבון השירות.
     • כדי להשתמש בחשבון שירות משלכם, צריך לציין את שם המשאב המלא בפורמט projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

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

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

   הערה: כדי לעדכן אפליקציה קיימת, מוסיפים את הדגל --replace לפקודות הפריסה הבאות.

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

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --create-sa \
      --service-account=SERVICE_ACCOUNT \
      --async
     

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

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --service-account=SERVICE_ACCOUNT \
      --async
     

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

   • ‫APPLICATION: מזהה האפליקציה.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של האפליקציה.
   • ‫SPACE: מזהה המרחב.
   • ‫SERVICE_ACCOUNT: מבצעים אחת מהפעולות הבאות:
     • כדי ליצור חשבון שירות חדש, צריך לציין שם לחשבון השירות.
     • כדי להשתמש בחשבון שירות משלכם, צריך לציין את שם המשאב המלא בפורמט projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

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

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

   gcloud design-center operations describe OPERATION\
   --project=PROJECT \
   --location=LOCATION
   

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

   • ‫OPERATION: שם הפעולה המלא שהועתק מהפלט של הפקודה deploy בפורמט projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של האפליקציה.

   מידע נוסף זמין במאמר gcloud design-center operations describe.

פתרון בעיות בהטמעה

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

כדי לפתור את הבעיות ולתקן את השגיאות, צריך לבצע את הפעולות הבאות:

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

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

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

3. בודקים את השגיאות וההמלצות לגבי הפריסה:

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

   2. אם כתוצאה מהניתוח מתקבלות המלצות נוספות, המערכת מציגה פקודות ה-CLI של gcloud שאפשר להריץ כדי לפתור את השגיאות. כדי להריץ את הפקודות של ה-CLI של gcloud ב-Cloud Shell, לוחצים על הפעלת הפקודה.

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

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

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

כדי לראות את פרטי האפליקציה:

קנבס העיצוב

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

   מעבר אל Applications

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

   • הצגת האפליקציה ב-App Hub: בדיקת האפליקציה ב-App Hub. אתם יכולים לראות את המשאבים שנפרסו ולבדוק את נתוני הטלמטריה כדי לאבחן בעיות ולנתח את הביצועים. מידע נוסף זמין במאמר מעקב אחרי אפליקציות ב-App Hub.

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

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

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

‫CLI של gcloud

gcloud design-center spaces applications describe APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

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

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

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

שינוי אפליקציות שנפרסו

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

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

החלת תיקונים בתבנית

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

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

כדי להחיל על האפליקציה שינויים בתבנית:

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

קנבס העיצוב

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

   אל "תבניות"

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

3. ברשימה Configure an app (הגדרת אפליקציה), בוחרים את האפליקציה שרוצים לעדכן.

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

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

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

‫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 update APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION
   

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

   • ‫APPLICATION: מזהה האפליקציה.
   • ‫PROJECT: מזהה פרויקט הניהול.
   • ‫LOCATION: האזור של האפליקציה.
   • ‫SPACE: מזהה המרחב.
   • ‫SOURCE_APPLICATION_TEMPLATE_REVISION: ה-URI של תבנית האפליקציה. לדוגמה, projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION.

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

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

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

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

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