הגדרת פרויקט יחיד

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

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

מגבלות

התמיכה בתכונות בגבולות של פרויקט יחיד שונה מהתמיכה בגבולות של תיקייה. השירותים מרכז האפליקציות, Application Design Center ו-Application Monitoring תומכים באופן מלא בפרויקטים יחידים, אבל שירותים אחרים של Google Cloud שמתמקדים באפליקציות, כמו Cloud Hub ו-Gemini Cloud Assist, דורשים גבול ברמת התיקייה.

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

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

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

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

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

  • ניהול משאבים, הרשאות וחיוב בפרויקט: Project Owner (roles/owner)
  • ניהול כל רכיבי האפליקציה בפרויקט: אדמין App Hub (roles/apphub.admin)

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

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

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

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

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

המסוף

  1. במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את הפרויקט.

  2. כדי לעבור לדף סקירה כללית ממרכז האפליקציות:

    לסקירה הכללית

  3. לוחצים על הגדרת מרכז האפליקציות.

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

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

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

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

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

  7. לוחצים על Continue.

  8. משלימים את ההגדרה בהתאם לבחירה שלכם:

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

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

      1. בכרטיסייה הגדרת גבול, מאמתים את פרטי הפרויקט. בטבלה Projects in your boundary מוצג רק הפרויקט שמגדיר את הגבול של הפרויקט הבודד. אם מגדירים גבולות לפרויקט יחיד, לא מוסיפים פרויקטים נוספים.

      2. לוחצים על Continue.

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

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

      5. לוחצים על הענקת תפקידים ואז על סיום.

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

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

gcloud

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

    הפעלת Cloud Shell

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

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

    gcloud components update

  3. איך למצוא את מזהה הפרויקט

  4. מגדירים את הפרויקט כפרויקט ברירת המחדל לפקודות:

    gcloud config set project PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט.

  5. מפעילים את App Hub API:

    gcloud services enable apphub.googleapis.com \
    --project PROJECT_ID

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

    gcloud apphub boundary update \
    --crm-node=projects/PROJECT_ID \
    --project=PROJECT_ID \
    --location=global

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

  7. מאשרים את סטטוס הקובץ המצורף:

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    הפלט שמתקבל אמור להיות דומה לדוגמה הבאה:

    name: projects/PROJECT_ID/locations/LOCATION/boundary
crmNode: projects/PROJECT_ID
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

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

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

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

איך לעשות את זה?

המסוף

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

  2. עוברים לדף IAM:

    כניסה לדף IAM

  3. לוחצים על Grant access. נפתחת החלונית הענקת גישה.

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

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

  6. בוחרים את תפקיד ה-IAM של מרכז האפליקציות שרוצים להקצות לחשבון הראשי ולוחצים על שמירה.

gcloud

  1. הענקת גישה לחשבונות משתמשים בפרויקט הניהול:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:EMAIL_ADDRESS' \
    --role='ROLE_NAME'

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

    • ‫PROJECT_ID: המזהה של פרויקט הניהול.
    • ‫EMAIL_ADDRESS: כתובת האימייל של הישות המורשית שצריך לקבל גישה למרכז האפליקציות. הערך הזה צריך להיות בפורמט username@yourdomain, לדוגמה, my.user@example.com.
    • ‫ROLE_NAME: תפקיד IAM במרכז האפליקציות שרוצים להקצות לישות המורשית, לדוגמה, roles/apphub.admin.

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

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

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

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

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

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

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

המסוף

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

    מעבר לדף Welcome

  2. עוברים אל הדף הגדרות הגבולות ממרכז האפליקציות:

    מעבר להגדרות הגבולות

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

  4. לוחצים על ניתוק פרויקטים.

    הטבלה Projects in your boundary מתרעננת ולא מציגה יותר את פרטי הפרויקט.

gcloud

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

    הפעלת Cloud Shell

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

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

    gcloud components update

  3. איך למצוא את מזהה הפרויקט

  4. מגדירים את הפרויקט כפרויקט ברירת המחדל לפקודות:

    gcloud config set project PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט.

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

    gcloud apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --crm-node=""

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

  6. כדי לאשר את הניתוק, מתארים את הגבול:

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

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

  7. אפשרות נוספת היא למחוק את כל האפליקציות בפרויקט ואז להשבית את מרכז האפליקציות API אם לא תשתמשו יותר בתכונות של האפליקציות בפרויקט הזה:

    gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID

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