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

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

סקירה כללית

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

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

• שירותים: ממשק רשת או ממשק API שחושף פונקציונליות ללקוחות, כמו כלל העברה של מאזן עומסים.
• עומסי עבודה: משאב מחשוב שמריץ פריסה בינארית שמבצעת פונקציה עסקית נפרדת, כמו קבוצת מופעי מכונה מנוהלים (MIG) או פריסה של Google Kubernetes Engine ‏ (GKE).

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

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

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

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

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

סקירה כללית של פרויקטים לניהול

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

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

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

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

הגדרת תיקייה לניהול אפליקציות

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

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

נניח שיש היררכיית משאבים במבנה הבא:

תיקייה F1 מכילה את שלושת הפריטים הבאים:

• פרויקטים P10 ו-P11
• תיקייה F2

תיקייה F2 מכילה את שני הפריטים הבאים:

• פרויקט P20 ו-P21

מפעילים את ניהול האפליקציות בתיקייה F1 כדי ליצור אפליקציה שכוללת משאבים מכמה רמות של תיקיות. לדוגמה, אפליקציה יכולה לכלול משאבים מפרויקטים P10 ו-P20.

אם תפעילו את ניהול האפליקציות רק בתיקייה F2, לא תוכלו ליצור אפליקציות בפרויקט P10. כדי ליצור אפליקציות בפרויקט P10, צריך להעביר את פרויקט P10 לתיקייה F2.

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

התפקידים הנדרשים

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

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

• הפעלת ניהול אפליקציות: אדמין תיקיות (roles/resourcemanager.folderAdmin) במשאב ההורה של התיקייה
• הפעלת ממשקי API: אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin) בתיקיית היעד (כדי להפעיל את ממשקי ה-API הנדרשים והמומלצים)
• מקשרים חשבון לחיוב לפרויקט הניהול:
  • Project Billing Manager (roles/billing.projectManager) בפרויקט הניהול
  • משתמש בחשבון לחיוב (roles/billing.user) בחשבון היעד לחיוב
• הקצאת תפקידים שמתמקדים באפליקציות למשתמשים: אדמין IAM של פרויקט (roles/resourcemanager.projectIamAdmin) בפרויקט הניהול
• מגדירים את היקף הניראות:
  • עריכת ניראות (roles/observability.editor) בפרויקט הניהול
  • כתיבת הגדרות של יומנים (roles/logging.configWriter) בפרויקט הניהול
  • אדמין של Monitoring ‏(roles/monitoring.admin) בפרויקט הניהול ובכל פרויקט שרוצים להוסיף להיקף המדדים בפרויקט
  • משתמש ב-Cloud Trace ‏(roles/cloudtrace.user) בפרויקט הניהול
  • צפייה ב-App Hub (roles/apphub.viewer) בפרויקט הניהול
• צפייה בנתונים ברמת האפליקציה וברמת הפרויקט ב-Cloud Hub: מפעיל Cloud Hub (roles/cloudhub.operator) בתיקייה לניהול אפליקציות

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

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

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

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

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

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

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

המסוף

1. בוחרים או יוצרים את התיקייה Google Cloud שרוצים להגדיר כתיקייה לניהול אפליקציות. איך יוצרים תיקיות חדשות?

2. פותחים את הדף Manage resources במסוף Google Cloud .

   כניסה לדף Manage resources

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

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

4. בשורה של התיקייה, פותחים את התפריט Actions ולוחצים על Settings.

   אם ניהול האפליקציות לא הופעל בתיקייה, בהגדרה Application management יוצג הערך Not enabled.

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

   נפתח החלון Create management project and enable required APIs.

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

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

   המערכת יוצרת את פרויקט הניהול בתיקייה.

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

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

   לחלופין, כדי לקבל את מזהה פרויקט הניהול, אתם יכולים להשתמש בפקודה הבאה של Google Cloud CLI:

   gcloud resource-manager folders describe FOLDER_ID
       --format="value(managementProject.split('/').slice(-1))"
   

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

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

gcloud

1. מפעילים את Cloud Shell במסוף Google Cloud .

   הפעלת Cloud Shell

   בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. מוודאים שמותקנת הגרסה העדכנית של Google Cloud CLI:

   gcloud components update
   

3. כדי להפעיל ניהול אפליקציות בתיקייה ספציפית, משתמשים בפקודה gcloud resource-manager capabilities update עם הדגל --enable.

   gcloud resource-manager capabilities update folders/FOLDER_ID/capabilities/app-management \
      --enable
   

   מחליפים את FOLDER_ID במזהה התיקייה.

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

4. אם רוצים להפעיל ממשקי API מומלצים בפרויקט הניהול, פועלים לפי ההוראות להפעלת שירותי Google Cloud בפרויקט.

Terraform

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

resource "google_folder" "folder" {
  display_name     = "my-folder"
  parent           = "organizations/123456789"
  deletion_protection = false
}
resource "time_sleep" "wait_60s" {
  depends_on = [google_folder.folder]
  create_duration = "60s"
}
resource "google_resource_manager_capability" "capability" {
  value            = true
  parent           = "${google_folder.folder.name}"
  capability_name  = "app-management"
  depends_on = [time_sleep.wait_60s]
}

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

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

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

אופציונלי: קישור של חשבון לחיוב לפרויקט הניהול

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

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

במאמר הסבר על העלויות תוכלו לקרוא סקירה כללית על העלויות הפוטנציאליות שקשורות לניהול האפליקציות ולממשקי ה-API שהופעלו.

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

כדי לקשר חשבון פעיל לחיוב לפרויקט הניהול:

המסוף

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

2. פותחים את הדף Billing במסוף Google Cloud .

   לדף החיוב

3. בכרטיסייה My projects, מאתרים את הפרויקט לניהול.

4. בשורת הפרויקט, פותחים את התפריט Actions, בוחרים באפשרות Change billing ואז בוחרים את החשבון לחיוב ב-Cloud.

איך מפעילים את החיוב בפרויקט?

gcloud

gcloud billing projects link PROJECT_ID \
    --billing-account ACCOUNT_ID

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

• ‫PROJECT_ID: המזהה של פרויקט הניהול.
• ‫ACCOUNT_ID: מזהה החשבון לחיוב. מזהי החשבונות לחיוב הם בפורמט 0X0X0X-0X0X0X-0X0X0X.

אופציונלי: הפעלת ממשקי ה-API המומלצים

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

הקצאת תפקידים שמתמקדים באפליקציות למשתמשים

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

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

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

תחומי האחריות של המשתמשים	תפקידי IAM	איפה מקצים תפקידים
אדמינים של הפלטפורמה לבצע משימות של אדמין בפרויקט הניהול.	אדמין IAM בפרויקט (roles/resourcemanager.projectIamAdmin)	פרויקט ניהול
מהנדסי פלטפורמה לבצע משימות של אדמין ב-App Hub וב-App Design Center.	אדמין ב-App Hub‏ (roles/apphub.admin) אדמין ב-App Design Center‏ (roles/designcenter.admin)	פרויקט ניהול
מפתחי אפליקציות לפתח אפליקציות.	עריכה ב-App Hub‏ (roles/apphub.editor) משתמש ב-App Design Center‏ (roles/designcenter.user)	פרויקט ניהול
מהנדסי SRE, מפעילים ומשתמשי Cloud Hub לראות נתונים ברמת האפליקציה וברמת הפרויקט ב-Cloud Hub.	מפעיל Cloud Hub‏ (roles/cloudhub.operator)	תיקייה לניהול אפליקציות

הגדרת היקף הניראות (observability)

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

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

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

רכיב היקף ההרשאות	תרחיש הגדרה	פעולות מרכזיות ודברים שצריך לקחת בחשבון
אוסף תצוגות יומן (log scope)	אתם משתמשים ב כיור נתונים נצברים כדי לנתב את כל היומנים בארגון לקטגוריית יומנים מרכזית.	יוצרים תצוגת יומן שכוללת רק יומני אפליקציות שמאוחסנים בקטגוריה. מגדירים את אוסף תצוגות היומן (log scope) של ברירת המחדל בפרויקט הניהול כך שיכלול את תצוגת היומן.
	אין לכם כיור נתונים נצברים ברמת הארגון, ובתיקייה לניהול אפליקציות אין תיקיות בתצוגת עץ.	מגדירים קבוצת משאבים נפרדת כדי לנתב את יומני האפליקציות לקטגוריית היומנים _Default של פרויקט הניהול. מוודאים שאוסף תצוגות היומן שנקרא _Default הוא אוסף ברירת המחדל.
	אתם לא רוצים להשתמש בכיור נתונים נצברים.	מגדירים את אוסף תצוגות היומן שמוגדר כברירת מחדל בפרויקט הניהול, כדי להציג את מיקומי האחסון של נתוני היומן של האפליקציה.
היקף המדדים בפרויקט	הגדרתם תיקייה לניהול אפליקציות שמכילה את כל הפרויקטים שבהם מאוחסנים נתוני המדדים שאתם רוצים לראות.	‫Google Cloud Observability מנסה לסנכרן את רשימת הפרויקטים בתיקייה לניהול אפליקציות עם רשימת הפרויקטים בהיקף המדדים. כל עוד מספר הפרויקטים בתיקייה לניהול אפליקציות לא חורג מהמכסה של היקף המדדים, Google Cloud Observability יכול לעדכן את רשימת הפרויקטים בהיקף המדדים כשמוסיפים או מסירים פרויקטים בתיקייה לניהול אפליקציות.
היקף המעקב	אתם רוצים לעקוב אחרי נתוני המעקב של האפליקציה בכמה פרויקטים.	יוצרים היקף מעקב בהתאמה אישית בפרויקט הניהול, שבו מפורטים הפרויקטים שבהם מאוחסנים נתוני המעקב של האפליקציה. מגדירים את היקף המעקב בהתאמה אישית כהיקף המעקב שמוגדר כברירת מחדל.

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

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

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

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

2. בוחרים את התיקייה Google Cloud שבה רוצים להשבית את ניהול האפליקציות.

3. פותחים את הדף Manage resources במסוף Google Cloud .

   כניסה לדף Manage resources

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

5. בשורה של התיקייה, פותחים את התפריט Actions ולוחצים על Settings.

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

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

7. בתיבת הדו-שיח לאישור, מזינים Disable בשדה Disable.

8. אם אתם מוכנים להשבית את ניהול האפליקציות, לחצו על השבתה.

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

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

• מידע נוסף על App Hub
• יצירת האפליקציות
• מידע על תכנון ופריסה של אפליקציות ב-App Design Center