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

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

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

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

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

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

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

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

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

קנבס לעיצוב

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

   מעבר אל Applications

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    1. בחלונית Application details, לוחצים על Deployments.

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

    3. לוחצים על View logs כדי לראות מידע מפורט על ה-build.

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

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

    טיפ: כדי לראות רשימה של אפליקציות עם בעיות פריסה ב-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. בחלונית Application details, לוחצים על Deployments.

2. כדי לנתח שגיאות ולקבל הצעות לתיקונים, לוחצים על Troubleshoot Deployment.

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

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

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

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

הצגת פרטי הבקשה

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

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

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

קנבס לעיצוב

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

   מעבר אל Applications

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

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

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

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

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

‫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. לוחצים על Deploy. במאמר פריסת האפליקציה מוסבר איך לפרוס את האפליקציה.

‫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 עם ארכיטקטורות מוגדרות מראש.