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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

יצירת פרויקט

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

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

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

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

המסוף

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

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

   מעבר לניהול משאבים

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

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

gcloud

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

   הפעלת 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

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

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

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

{
    "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), ויכול להיות שהתמיכה בהן תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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 הם המזהים הייחודיים (מזהים) של משאבי הארגון או התיקייה שבהם מוגדרים מפתחות התגים.

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"
  }
}

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

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

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

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

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

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

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

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

אם במכסה של החשבון נשארו פחות מ-30 פרויקטים, בדף New Project תופיע התראה על כך. ההתראה תכלול גם את מספר הפרויקטים שנשארו במכסה. אחרי שמגיעים למכסת הפרויקטים, כדי ליצור עוד פרויקטים צריך לבקש להגדיל את מכסת הפרויקטים. אפשר גם לתזמן מחיקה של פרויקטים מסוימים אחרי 30 ימים בדף ניהול המשאבים. פרויקטים שמשתמשים מחקתם באופן זמני נספרים במכסה. הפרויקטים האלה יימחקו באופן סופי אחרי 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. מזינים את הפרטים ליצירת קשר ולוחצים על שליחת בקשה.

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

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

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

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