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

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

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

מגבלות

התמיכה בתכונות בגבולות של פרויקט יחיד שונה מהתמיכה בתכונות בגבולות של תיקייה. ב-App Hub, ב-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. לוחצים על הגדרת מרכז האפליקציות.

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

  4. בדף הפעלת App Hub, בוחרים באחת מהאפשרויות הבאות:

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

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

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

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

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

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

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. איך למצוא את מזהה הפרויקט

  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, צריך להעניק להם את התפקידים וההרשאות המתאימים ב-App Hub.

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

המסוף

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

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

    כניסה לדף IAM

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

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

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

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

gcloud

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

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

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

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

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

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

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

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

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

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

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

המסוף

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

    מעבר לדף Welcome

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

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

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

  4. לוחצים על Detach projects.

    הטבלה 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. אפשרות נוספת היא למחוק את כל האפליקציות בפרויקט ואז להשבית את App Hub API אם לא תשתמשו יותר בתכונות של האפליקציות בפרויקט הזה:

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

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