יצירת פרויקטים

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

מאפיינים מרכזיים של פרויקטים

המאפיינים העיקריים של פרויקטים כוללים:

• הקונטיינר הראשי של השירות: פרויקט הוא הרמה הבסיסית שבה מפעילים שירותים (ממשקי API) ויוצרים משאבים כמו מכונות של Compute Engine או מערכי נתונים של BigQuery. Google Cloud

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

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

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

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

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

אלה המזהים שמשמשים בפרויקט:

• שם הפרויקט: שם קריא לאנשים של הפרויקט.

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

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

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

• מזהה פרויקט: מזהה ייחודי גלובלי של הפרויקט.

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

  מזהה הפרויקט צריך לעמוד בדרישות הבאות:

  • הוא צריך להיות באורך של 6 עד 30 תווים.
  • הוא יכול להכיל רק אותיות קטנות, מספרים ומקפים.
  • הוא צריך להתחיל באות.
  • הוא לא יכול להסתיים במקף.
  • אי אפשר להשתמש במזהה פרויקט שכבר נמצא בשימוש או שהיה בשימוש בעבר, כולל פרויקטים שנמחקו.
  • הוא לא יכול להכיל מחרוזות מוגבלות כמו google ו-ssl. אל תשתמשו במחרוזות כמו undefined ו-null במזהה הפרויקט.

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

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

יצירת פרויקט

כדי ליצור פרויקט, אתם צריכים את ההרשאה resourcemanager.projects.create. ההרשאה הזו כלולה בתפקידים כמו "יצירת פרויקטים" (roles/resourcemanager.projectCreator).

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

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

אפשר ליצור פרויקט חדש באמצעות מסוף Google Cloud ,‏ Google Cloud CLI או ה-method‏ projects.create().

המסוף

כדי ליצור פרויקט חדש:

1. נכנסים לדף Manage resources במסוף Google Cloud .

   כניסה לדף Manage Resources

   שאר השלבים מופיעים במסוף Google Cloud .

2. לוחצים על Create project.
3. בחלון New project שמופיע, מזינים שם לפרויקט ובוחרים חשבון לחיוב, לפי הצורך. שם הפרויקט יכול להכיל רק אותיות, מספרים, מירכאות בודדות, מקפים, רווחים או סימני קריאה, והאורך שלו צריך להיות בין 4 ל-30 תווים.
   הערה: אפשר לבחור חשבון לחיוב רק אם יש לכם את התפקיד משתמש בחשבון לחיוב (roles/billing.user) בארגון או בחשבון לחיוב. בשילוב עם התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), התפקידים האלה מאפשרים ליצור פרויקטים חדשים שמקושרים לחשבון לחיוב. בשילוב עם התפקיד Project Billing Manager (roles/billing.projectManager), התפקידים האלה מאפשרים לקשר ולבטל את הקישור של פרויקטים בחשבון לחיוב.
4. בתיבה Parent resource, מזינים את משאב הארגון או התיקייה ברמה העליונה. המשאב הזה יהיה ההורה ההיררכי של הפרויקט החדש. אם האפשרות No organization זמינה, אתם יכולים לבחור בה כדי ליצור את הפרויקט החדש ברמה העליונה של היררכיית המשאבים שלו.
5. כשמסיימים להזין את פרטי הפרויקט החדש, לוחצים על Create.

gcloud

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

   הפעלת Cloud Shell

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

2. כדי ליצור פרויקט חדש, משתמשים בפקודה gcloud projects create:

   gcloud projects create PROJECT_ID
   

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

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

   gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID
   

   gcloud projects create PROJECT_ID --folder=FOLDER_ID
   

REST

כשיוצרים פרויקט חדש באמצעות ה-method‏ projects.create(), אי אפשר להשתמש במילים מסוימות במזהה הפרויקט. לדוגמה: google, null, undefined ו-ssl. אם תשתמשו במילה מוגבלת, הבקשה תחזיר שגיאת INVALID_ARGUMENT.

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

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

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

תגובה ליצירת פרויקט:

{
    "name": "operations/pc.123456789",
}

בקשה לקבלת פעולה:

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

תגובה לפעולת Get:

{
    "name": "operations/pc.123456789",
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
        "projectNumber": "464036093014",
        "projectId": "our-project-123",
        "lifecycleState": "ACTIVE",
        "name": "my project",
        "labels": {
        "mylabel": "prod"
        },
    "createTime": "2016-01-07T21:59:43.314Z"
    }
}

הוספת תגים במהלך יצירת הפרויקט

תצוגה מקדימה

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

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

gcloud

כדי להוסיף תגים במהלך יצירת הפרויקט, מריצים את הפקודה הבאה:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

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

• ‫PROJECT_ID הוא המזהה הייחודי של הפרויקט.
• ‫ORGANIZATION_ID הוא המזהה הייחודי של הארגון.
• ‫KEY_VALUE_PAIRS היא רשימה מופרדת בפסיקים של צמדי מפתח/ערך שאפשר להקצות למשאב. דוגמה לצמדי מפתח/ערך שמופרדים בפסיקים: 123/environment=production, 456/create=testresource. בדוגמה הזו, 123 ו-456 הם המזהים הייחודיים (IDs) של משאבי הארגון או התיקייה שבהם מוגדרים מפתחות התגים.

REST

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

  POST https://cloudresourcemanager.googleapis.com/v3/projects/
  Authorization: *************
  Content-Type: application/json

  {
    "projectId": "our-project-456",
    "name": "my project",
    "parent": "organizations/123",
    "tags": {
      "key": "123/environment"
      "value": "production"
    },
"tags": {
      "key": "123/costCenter"
      "value": "marketing"
  }
}

הגדרת סביבות פרויקטים באמצעות תגים

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

כדי להשתמש בתכונה הזו:

1. יוצרים מפתח תג בשם environment.
2. יוצרים ערכי תגים לקטגוריות הסביבה שבהן אתם משתמשים. אלה הערכים הנתמכים, שממופים לתג תואם בכלי לבחירת פרויקטים במסוף:
   • ‫Prod: Prod, prod, Production, production
   • מפתח: Dev,‏ dev,‏ Development,‏ development
   • בדיקה: Test, test, Testing, testing, QA, qa, Quality assurance, quality assurance
   • Staging: Staging, staging, Stage, stage
3. מצרפים את התג המתאים לפרויקט על ידי יצירת קישור לתג.

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

הערה: כדי לראות תגי סביבה בכלי לבחירת פרויקטים, למשתמשים צריך להיות התפקיד "צפייה בתגים" (roles/resourcemanager.tagViewer) ברמת הארגון או התיקייה.

יצירת פרויקט באמצעות חשבון שירות

אתם יכולים להשתמש בחשבון שירות כדי להפוך את יצירת הפרויקטים לאוטומטית. כמו חשבונות משתמשים, גם חשבונות שירות יכולים לקבל הרשאה ליצור פרויקטים במשאב הארגון. חשבונות שירות לא יכולים ליצור פרויקטים מחוץ למשאב הארגון, וצריך לציין את משאב ההורה כשיוצרים פרויקט. חשבונות שירות יכולים ליצור פרויקט חדש באמצעות ה-CLI של gcloud או באמצעות ה-method‏ projects.create().

ניהול מכסות בפרויקט

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

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

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

1. נכנסים לדף Quotas & System Limits.

   כניסה לדף Quotas & System Limits

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

3. באפשרות Filter, בוחרים ב-Metric ומזינים את הערך cloudresourcemanager.googleapis.com/projects_count.

4. בוחרים באפשרות Cloud Resource Manager API, לוחצים על More actions ואז על Edit quota.

5. בתיבת הדו-שיח Quota changes, מזינים ערך חדש למכסה ותיאור, ולוחצים על Next.

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

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

אם אין לכם ארגון ואתם רוצים לבקש קיבולת נוספת לפרויקטים במכסה, אתם יכולים להשתמש בטופס Request Project Quota Increase.

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

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