פרויקטים הם יחידת ההפעלה הבסיסית בהיררכיית המשאבים של Cloud de Confiance by S3NS . הפרויקטים נמצאים בין התיקיות (או הארגון) לבין המשאבים, כמו מכונות וירטואליות ואחסון. בדף הזה מוסבר איך ליצור Cloud de Confiance פרויקטים באמצעות Cloud Resource Manager API ומסוף Cloud de Confiance Google Cloud.
המאפיינים העיקריים של פרויקטים כוללים את הדברים הבאים:
הקונטיינר הראשי של השירות: פרויקט הוא הרמה הבסיסית שבה כל שירותיCloud de Confiance by S3NS (ממשקי API) מופעלים, ובה נוצרים משאבים כמו מכונות Compute Engine או מערכי נתונים ב-BigQuery.
גבולות האמון: פרויקטים משמשים כשכבת בידוד. כברירת מחדל, למשאבים בפרויקט אחד אין גישה למשאבים בפרויקט אחר, וכך נוצר היקף מאובטח לאפליקציות או לסביבות שונות.
יחידת החיוב: פרויקטים הם הדרך העיקרית שבה עסקים עוקבים אחרי העלויות בארגון, מארגנים אותן ומפרידים ביניהן.
נקודת החיבור של המדיניות: כללי המדיניות בדרך כלל עוברים בירושה מתיקיות, אבל רמת הפרויקט היא המקום הנפוץ ביותר שבו ניתנות הרשאות ספציפיות (ניהול זהויות והרשאות גישה (IAM)) למפתחים ולחשבונות שירות בשביל משימות יומיות.
לפני שמתחילים
במאמר סקירה כללית על היררכיית המשאבים מוסבר על משאב הפרויקט. במאמר בחירה של היררכיית משאבים לאזור הנחיתה ב- Cloud de Confiance מוסבר איך להגדיר את היררכיית המשאבים.
המזהים הבאים משמשים לפרויקט שלך:
שם הפרויקט: שם הפרויקט שקריא לבני אדם.
שם הפרויקט צריך לעמוד בדרישות הבאות:
- האורך שלו צריך להיות בין 4 ל-30 תווים.
- הוא יכול להכיל אותיות, מספרים, מירכאות בודדות, מקפים, רווחים או סימני קריאה.
- הוא צריך להסתיים באות או בספרה.
שם הפרויקט לא נמצא בשימוש באף Google API. אפשר לערוך את שם הפרויקט בכל שלב במהלך יצירת הפרויקט או אחרי היצירה. שמות הפרויקטים לא חייבים להיות ייחודיים.
Project ID: מזהה ייחודי גלובלי של הפרויקט.
מזהה פרויקט הוא מחרוזת ייחודית שמבדילה את הפרויקט שלכם מכל הפרויקטים האחרים ב- Cloud de Confiance by S3NS. אחרי שמזינים את שם הפרויקט, מסוףCloud de Confiance יוצר מזהה פרויקט ייחודי שיכול להיות שילוב של אותיות, מספרים ומקפים. משתמשים במזהה הפרויקט שנוצר, אבל אפשר לערוך אותו במהלך יצירת הפרויקט. אחרי שיוצרים פרויקט, מזהה הפרויקט הוא קבוע.
מזהה פרויקט צריך לעמוד בדרישות הבאות:
- האורך שלו צריך להיות בין 6 ל-30 תווים.
- הוא יכול להכיל רק אותיות קטנות, ספרות ומקפים.
- הוא צריך להתחיל באות.
- הוא לא יכול להסתיים במקף.
- הפרויקט לא יכול להיות בשימוש או שהיה בשימוש בעבר, כולל פרויקטים שנמחקו.
- הוא לא יכול להכיל מחרוזות מוגבלות כמו
googleו-ssl. אל תשתמשו במחרוזות כמוundefinedו-nullבמזהה הפרויקט.
כל Cloud de Confianceמזהי הפרויקטים מקבלים באופן אוטומטי את הקידומת
s3ns:.Project number: מספר הפרויקט הוא מזהה ייחודי שנוצר באופן אוטומטי עבור הפרויקט. במאמר זיהוי פרויקטים מוסבר איך למצוא את מספר הפרויקט.
אל תכללו מידע רגיש, למשל פרטים אישיים מזהים (PII) או נתוני אבטחה, בשם הפרויקט, במזהה הפרויקט או בשמות אחרים של משאבים. מזהה הפרויקט מופיע בשם של הרבה משאבים אחרים Cloud de Confiance by S3NS. הפניה לפרויקט או למשאבים שלו חושפת את מזהה הפרויקט ואת שם המשאב.
יצירת פרויקט
כדי ליצור פרויקט, צריכה להיות לכם ההרשאה resourcemanager.projects.create. ההרשאה הזו כלולה בתפקידים כמו התפקיד 'יצירת פרויקט' (roles/resourcemanager.projectCreator).
במאמר ניהול תפקידים שמוגדרים כברירת מחדל בארגון מוסבר איך להעניק לאנשים תפקיד ולהגביל את הגישה שלהם למשאבים בארגון.
אם לא תציינו את משאב ההורה, ייבחר משאב הורה באופן אוטומטי, אם רלוונטי, על סמך הדומיין של חשבון המשתמש.
אפשר ליצור פרויקט חדש באמצעות מסוף Cloud de Confiance , Google Cloud CLI או ה-method projects.create().
המסוף
כדי ליצור פרויקט חדש:
-
נכנסים לדף Manage resources במסוף Cloud de Confiance .
שאר השלבים מופיעים במסוף Cloud de Confiance .
- לוחצים על יצירת פרויקט.
- בחלון New project שמופיע, מזינים שם לפרויקט ובוחרים חשבון לחיוב, לפי הצורך. שם הפרויקט יכול להכיל רק אותיות, מספרים, מירכאות בודדות, מקפים, רווחים או סימני קריאה, והאורך שלו צריך להיות בין 4 ל-30 תווים.
- מזינים את משאב תיקיית ההורה או הארגון בתיבה משאב הורה. המשאב הזה יהיה ההורה ההיררכי של הפרויקט החדש.
- כשמסיימים להזין את הפרטים החדשים של הפרויקט, לוחצים על יצירה.
gcloud
-
מפעילים את Cloud Shell במסוף Cloud de Confiance .
בחלק התחתון של מסוף Cloud de Confiance יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
כדי ליצור פרויקט חדש, משתמשים בפקודה
gcloud projects create:gcloud projects create PROJECT_IDכאשר PROJECT_ID הוא המזהה של הפרויקט שרוצים ליצור. מזהה הפרויקט צריך להתחיל באות קטנה באנגלית, והוא יכול לכלול רק אותיות ASCII, ספרות ומקפים. האורך שלו צריך להיות בין 6 ל-30 תווים.
כדי ליצור פרויקט עם משאב ארגון או תיקייה כהורה, משתמשים בדגלים
--organizationאו--folder. לכל משאב יכול להיות רק הורה אחד, ולכן אפשר להשתמש רק באחד מהדגלים הבאים:gcloud projects create PROJECT_ID --organization=ORGANIZATION_IDgcloud projects create PROJECT_ID --folder=FOLDER_ID
REST
כשיוצרים פרויקט חדש באמצעות method 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"
}
}
הוספת תגים במהלך יצירת הפרויקט
תגים מאפשרים ליצור הערות למשאבים. אפשר להוסיף תגים כשיוצרים פרויקטים. אתם צריכים להקצות את התפקיד משתמש תגים כשאתם מוסיפים תגים. מידע נוסף על ההרשאות שמוקצות לתפקיד הזה זמין במאמר ניהול תגים במשאבים. אפשר להוסיף את מרחב השמות לצמדי מפתח/ערך של התג רק באחת מהדרכים הבאות:
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"
}
}
הקצאת תגים לסביבות פרויקט
אפשר להשתמש בתגים כדי להבחין חזותית בין פרויקטים על סמך הסביבה שלהם, כמו ייצור, Staging או פיתוח. כך אפשר למנוע שגיאות ולשפר את המודעות כשעובדים בסביבות רגישות. כשבוחרים פרויקט עם צמד מפתח/ערך ספציפי של תג, Google מוסיפה אינדיקטור חזותי לפרויקט בכלי לבחירת פרויקטים במסוף Cloud de Confiance . האינדיקטור הזה מזכיר לכם שכל שינוי יכול להשפיע על האפליקציות המשויכות בסביבת הייצור או מחוץ לסביבת הייצור. הפרויקט יכול לרשת את התגים או שאפשר להגדיר אותם ישירות בפרויקט.
כדי להשתמש בתכונה הזו:
- יוצרים מפתח תג בשם
environment. - יוצרים ערכי תגים לקטגוריות הסביבה שבהן אתם משתמשים. יש תמיכה בערכים הבאים, והם ממופים לתג תואם בכלי לבחירת פרויקטים במסוף:
- Prod: Prod, prod, Production, production
- פיתוח: Dev, dev, Development, development
- בדיקה: Test, test, Testing, testing, QA, qa, Quality assurance, quality assurance
- העברה לבמה: Staging, staging, Stage, stage
- מצרפים את התג המתאים לפרויקט על ידי יצירת קישור תג.
אם לפרויקט יש כמה תגי סביבה (לדוגמה, תג אחד שעבר בירושה מתיקייה ותג אחד ישירות בפרויקט), התג הספציפי ביותר משמש לקביעת התג.
יצירת פרויקט באמצעות חשבון שירות
אפשר להשתמש בחשבון שירות כדי לבצע אוטומציה של יצירת פרויקטים. בדומה לחשבונות משתמשים, אפשר להעניק לחשבונות שירות הרשאה ליצור פרויקטים במשאב ארגון. לחשבונות שירות אסור ליצור פרויקטים מחוץ למשאב ארגון, וכשיוצרים פרויקט צריך לציין את משאב האב.
חשבונות שירות יכולים ליצור פרויקט חדש באמצעות ה-CLI של gcloud או השיטה projects.create().
ניהול מכסות בפרויקט
כדי לבקש הגדלה של המכסה לפרויקטים בארגון, אפשר לפתוח כרטיס תמיכה אצל Cloud de Confiance by S3NS הצוות. לפרטים נוספים, קראו את המאמר איך שולחים בקשה לשינוי המכסות.