בדף הזה מוסבר איך להשתמש באילוצים בהתאמה אישית של שירות מדיניות הארגון כדי להגביל פעולות ספציפיות במשאבים הבאים של Google Cloud :
aiplatform.googleapis.com/Endpointaiplatform.googleapis.com/DeploymentResourcePool
מידע נוסף על מדיניות הארגון בהתאמה אישית
מידע על כללי מדיניות ואילוצים של הארגון
Google Cloud שירות מדיניות הארגון נותן לכם שליטה מרוכזת ופרוגרמטית על המשאבים של הארגון. אדמינים של מדיניות הארגון יכולים להגדיר מדיניות ארגונית, שהיא קבוצה של הגבלות שנקראות אילוצים. האילוצים האלה חלים על משאביGoogle Cloud ועל הצאצאים של המשאבים האלה בGoogle Cloud היררכיית המשאבים. אפשר לאכוף את מדיניות הארגון ברמת הארגון, התיקייה או הפרויקט.
מדיניות הארגון מספקת אילוצים מנוהלים מובְנים לשירותים שונים של Google Cloud . עם זאת, אם אתם רוצים שליטה מפורטת יותר ומותאמת אישית בשדות הספציפיים שמוגבלים במדיניות הארגון, אתם יכולים גם ליצור אילוצים מותאמים אישית ולהשתמש בהם במדיניות הארגון.
ירושה של מדיניות
כברירת מחדל, מדיניות הארגון עוברת בירושה לצאצאים של המשאבים שעליהם אתם אוכפים את המדיניות. לדוגמה, אם אוכפים מדיניות בתיקייה, Google Cloud המדיניות נאכפת בכל הפרויקטים בתיקייה. במאמר כללי הערכה של היררכיה מוסבר בהרחבה על ההתנהגות הזו ואיך לשנות אותה.
יתרונות
אתם יכולים להשתמש במדיניות ארגונית בהתאמה אישית כדי לאשר או לדחות ערכים ספציפיים למשאבי הסקה אונליין. לדוגמה, אם בקשה ליצירת נקודת קצה (endpoint) להסקת מסקנות אונליין לא עומדת בדרישות של אימות אילוצים מותאמים אישית שמוגדרים במדיניות הארגון, הבקשה נכשלת ומוחזרת שגיאה למבצע השיחה.
מגבלות
כמו כל האילוצים של מדיניות הארגון, שינויים במדיניות לא חלים רטרואקטיבית על משאבים קיימים.
- מדיניות חדשה לא משפיעה על הגדרות קיימות של משאבים.
- הגדרת משאב קיימת נשארת תקינה, אלא אם משנים ערך בהגדרה שלה מערך תואם לערך לא תואם.
לפני שמתחילים
- נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init - מוודאים שאתם יודעים מהו מזהה הארגון.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול מדיניות ארגונית בהתאמה אישית, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות ארגונית (roles/orgpolicy.policyAdmin) ב-IAM במשאב הארגון.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
משאבים נתמכים ב-Gemini Enterprise Agent Platform
בטבלה הבאה מפורטים המשאבים של Gemini Enterprise Agent Platform שאפשר להפנות אליהם באילוצים מותאמים אישית.| משאב | שדה |
|---|---|
| aiplatform.googleapis.com/DeploymentResourcePool |
resource.dedicatedResources.machineSpec.acceleratorCount
|
resource.dedicatedResources.machineSpec.acceleratorType
| |
resource.dedicatedResources.machineSpec.gpuPartitionSize
| |
resource.dedicatedResources.machineSpec.machineType
| |
resource.dedicatedResources.machineSpec.reservationAffinity.key
| |
resource.dedicatedResources.machineSpec.reservationAffinity.reservationAffinityType
| |
resource.dedicatedResources.machineSpec.reservationAffinity.values
| |
resource.dedicatedResources.machineSpec.tpuTopology
| |
resource.dedicatedResources.minReplicaCount
| |
resource.dedicatedResources.spot
| |
resource.disableContainerLogging
| |
resource.encryptionSpec.kmsKeyName
| |
resource.serviceAccount
| |
| aiplatform.googleapis.com/Endpoint |
resource.clientConnectionConfig.inferenceTimeout
|
resource.dedicatedEndpointEnabled
| |
resource.deployedModels.automaticResources.maxReplicaCount
| |
resource.deployedModels.automaticResources.minReplicaCount
| |
resource.deployedModels.dedicatedResources.machineSpec.acceleratorCount
| |
resource.deployedModels.dedicatedResources.machineSpec.acceleratorType
| |
resource.deployedModels.dedicatedResources.machineSpec.gpuPartitionSize
| |
resource.deployedModels.dedicatedResources.machineSpec.machineType
| |
resource.deployedModels.dedicatedResources.machineSpec.reservationAffinity.key
| |
resource.deployedModels.dedicatedResources.machineSpec.reservationAffinity.reservationAffinityType
| |
resource.deployedModels.dedicatedResources.machineSpec.reservationAffinity.values
| |
resource.deployedModels.dedicatedResources.machineSpec.tpuTopology
| |
resource.deployedModels.dedicatedResources.minReplicaCount
| |
resource.deployedModels.dedicatedResources.spot
| |
resource.deployedModels.displayName
| |
resource.deployedModels.enableAccessLogging
| |
resource.deployedModels.gdcConnectedModel
| |
resource.deployedModels.model
| |
resource.description
| |
resource.displayName
| |
resource.encryptionSpec.kmsKeyName
| |
resource.genAiAdvancedFeaturesConfig.ragConfig.enableRag
| |
resource.name
| |
resource.network
| |
resource.predictRequestResponseLoggingConfig.bigqueryDestination.outputUri
| |
resource.predictRequestResponseLoggingConfig.enabled
| |
resource.predictRequestResponseLoggingConfig.samplingRate
| |
resource.privateServiceConnectConfig.enablePrivateServiceConnect
| |
resource.privateServiceConnectConfig.projectAllowlist
| |
resource.privateServiceConnectConfig.pscAutomationConfigs.network
| |
resource.privateServiceConnectConfig.pscAutomationConfigs.projectId
| |
resource.publisherModelConfig.claudeFeatureConfig.advancedAiEnabled
| |
resource.publisherModelConfig.claudeFeatureConfig.cyberVerificationProgramEnabled
| |
resource.publisherModelConfig.dataSharingEnabledProvider
| |
resource.trafficSplit
|
הגדרת אילוץ בהתאמה אישית
אילוץ בהתאמה אישית מוגדר בקובץ YAML לפי המשאבים, השיטות, התנאים והפעולות שנתמכים על ידי השירות שבו אתם אוכפים את מדיניות הארגון. התנאים של האילוצים המותאמים אישית מוגדרים באמצעות Common Expression Language (CEL). מידע נוסף על יצירת תנאים באילוצים מותאמים אישית באמצעות CEL זמין בקטע בנושא CEL במאמר יצירה וניהול של אילוצים מותאמים אישית.
המסוף
כדי ליצור אילוץ בהתאמה אישית:
- במסוף Google Cloud , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- לוחצים על Custom constraint.
- בתיבה שם לתצוגה, מזינים שם קריא לאנשים עבור האילוץ. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או בנתונים רגישים בשמות לתצוגה, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
-
בתיבה Constraint ID, מזינים את המזהה שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה
custom.restrictKmsKey. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.), לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים (PII) או נתונים רגישים במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. - בתיבה Description, מזינים תיאור של האילוץ שקריא לאנשים. התיאור הזה משמש כהודעת שגיאה כשמתרחשת הפרה של המדיניות. ציינו פרטים על הסיבה להפרת המדיניות ואיך לפתור את הבעיה. אל תכללו פרטים אישיים מזהים או מידע אישי רגיש בתיאור, כי הם עלולים להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 2,000 תווים.
-
בתיבה Resource type, בוחרים את השם של משאב ה- Google Cloud REST שמכיל את האובייקט והשדה שרוצים להגביל, לדוגמה
container.googleapis.com/NodePool. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
בקטע Enforcement method, בוחרים אם לאכוף את האילוץ על שיטת REST
CREATEאו על השיטותCREATEו-UPDATE. אם אוכפים את האילוץ באמצעות השיטהUPDATEבמשאב שמפר את האילוץ, מדיניות הארגון חוסמת את השינויים במשאב הזה, אלא אם השינוי פותר את ההפרה. - כדי להגדיר תנאי, לוחצים על עריכת התנאי.
-
בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך, למשל,
resource.management.autoUpgrade == false. השדה הזה יכול להכיל עד 1,000 תווים. פרטים על השימוש ב-CEL זמינים במאמר בנושא Common Expression Language. למידע נוסף על משאבי השירות שאפשר להשתמש בהם באילוצים בהתאמה אישית, קראו את המאמר שירותים שנתמכים באילוצים בהתאמה אישית. - לוחצים על Save.
- בקטע Action, בוחרים אם לאשר או לדחות את השיטה שנבדקה אם התנאי מתקיים.
- לוחצים על יצירת אילוץ.
כדי לראות את השיטות הנתמכות לכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
פעולת הדחייה חוסמת את הפעולה ליצירה או לעדכון של המשאב אם התנאי מתקיים.
פעולת ההרשאה מאפשרת ליצור או לעדכן את המשאב רק אם התנאי מתקיים. כל מקרה אחר, מלבד אלה שרשומים במפורש בתנאי, נחסם.
אחרי שמזינים ערך בכל שדה, הגדרת ה-YAML המקבילה לאילוץ המותאם אישית הזה מופיעה בצד שמאל.
gcloud
- כדי ליצור אילוץ בהתאמה אישית, יוצרים קובץ YAML בפורמט הבא:
-
ORGANIZATION_ID: מזהה הארגון, למשל123456789. -
CONSTRAINT_NAME: השם שרוצים לתת לאילוץ המותאם אישית החדש. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה,custom.restrictKmsKey. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.) – לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע אישי רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. -
RESOURCE_NAME: השם מוגדר במלואו של המשאב Google Cloudשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה,aiplatform.googleapis.com/Endpoint. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור עוד אילוצים בהתאמה אישית, הפעולה תיכשל. -
methodTypes: שיטות ה-REST שעליהן נאכף האילוץ. יכול להיותCREATEאו גםCREATEוגםUPDATE. אם אוכפים את האילוץ באמצעות השיטהUPDATEעל משאב שמפר את האילוץ, שינויים במשאב הזה נחסמים על ידי מדיניות הארגון, אלא אם השינוי פותר את ההפרה. -
CONDITION: תנאי CEL שנכתב על בסיס ייצוג של משאב שירות נתמך. השדה הזה יכול להכיל עד 1,000 תווים. לדוגמה,"resource.encryptionSpec.kmsKeyName == \"\"". -
ACTION: הפעולה שצריך לבצע אם התנאיconditionמתקיים. הערכים האפשריים הםALLOWו-DENY. -
DISPLAY_NAME: שם קריא לאנשים של האילוץ. השם הזה מופיע בהודעות שגיאה ויכול לשמש לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע אישי רגיש בשמות המוצגים, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים. -
DESCRIPTION: תיאור קריא של האילוץ שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. השדה הזה יכול להכיל עד 2,000 תווים. -
אחרי שיוצרים את קובץ ה-YAML לאילוץ חדש בהתאמה אישית, צריך להגדיר אותו כדי שיהיה זמין למדיניות הארגון בארגון. כדי להגדיר אילוץ בהתאמה אישית, משתמשים בפקודה
gcloud org-policies set-custom-constraint: -
כדי לוודא שהאילוץ המותאם אישית קיים, משתמשים בפקודה
gcloud org-policies list-custom-constraints:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: RESOURCE_NAME methodTypes: - CREATE
- UPDATE condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTION
מחליפים את מה שכתוב בשדות הבאים:
כדי לראות את השיטות הנתמכות לכל שירות, צריך לחפש את השירות בקטע שירותים שתומכים באילוצים בהתאמה אישית.
מידע נוסף על המשאבים שאפשר לכתוב תנאים לגביהם זמין במאמר משאבים נתמכים.
הפעולה allow (אישור) אומרת שאם התנאי מקבל את הערך true, הפעולה ליצירה או לעדכון של המשאב מותרת. המשמעות היא שכל מקרה אחר, מלבד המקרה שמופיע במפורש בתנאי, ייחסם.
פעולת הדחייה פירושה שאם התנאי מקבל את הערך True, הפעולה ליצירה או לעדכון של המשאב נחסמת.
gcloud org-policies set-custom-constraint CONSTRAINT_PATH
מחליפים את CONSTRAINT_PATH בנתיב המלא לקובץ האילוץ בהתאמה אישית. לדוגמה, /home/user/customconstraint.yaml.
בסיום הפעולה, האילוצים המותאמים אישית יהיו זמינים כמדיניות ארגונית ברשימת Google Cloud המדיניות הארגונית.
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
מחליפים את ORGANIZATION_ID במזהה של משאב הארגון.
למידע נוסף, קראו את המאמר הצגת מדיניות הארגון.
אכיפה של מדיניות ארגון בהתאמה אישית
כדי לאכוף אילוץ, יוצרים מדיניות ארגון שמפנה אליו, ואז מחילים את מדיניות הארגון הזו על משאב Google Cloud .המסוף
- במסוף Google Cloud , נכנסים לדף מדיניות הארגון.
- בתפריט לבחירת פרויקט, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- ברשימה שבדף מדיניות הארגון, בוחרים את האילוץ כדי להציג את הדף Policy details של אותו אילוץ.
- כדי להגדיר את מדיניות הארגון למשאב הזה, לוחצים על Manage policy.
- בדף עריכת מדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.
- לוחצים על Add a rule.
- בקטע Enforcement, בוחרים אם לאכוף את מדיניות הארגון או לא.
- אופציונלי: כדי להגדיר את מדיניות הארגון כתלויה בתג, לוחצים על הוספת תנאי. שימו לב: אם מוסיפים כלל מותנה למדיניות הארגון, צריך להוסיף לפחות כלל אחד לא מותנה, אחרת אי אפשר לשמור את המדיניות. מידע נוסף זמין במאמר בנושא הגדרת היקף של מדיניות הארגון באמצעות תגים.
- לוחצים על Test changes כדי לדמות את ההשפעה של מדיניות הארגון. מידע נוסף מופיע במאמר בדיקת שינויים במדיניות הארגון באמצעות סימולטור המדיניות.
- כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, לוחצים על הגדרת המדיניות להרצת בדיקה. מידע נוסף זמין במאמר בנושא בדיקת מדיניות הארגון.
- אחרי שמוודאים שמדיניות הארגון במצב הרצה יבשה פועלת כמו שרוצים, מגדירים את המדיניות הפעילה על ידי לחיצה על הגדרת מדיניות.
gcloud
- כדי ליצור מדיניות ארגונית עם כללים בוליאניים, יוצרים קובץ YAML של מדיניות שמפנה לאילוץ:
-
PROJECT_ID: הפרויקט שבו רוצים לאכוף את האילוץ. -
CONSTRAINT_NAME: השם שהגדרתם לאילוץ המותאם אישית. לדוגמה,custom.restrictKmsKey. -
כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, מריצים את הפקודה הבאה עם הדגל
dryRunSpec: -
אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמו שצריך, מגדירים את המדיניות הפעילה באמצעות הפקודה
org-policies set-policyוהדגלspec:
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true dryRunSpec: rules: - enforce: true
מחליפים את מה שכתוב בשדות הבאים:
gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
gcloud org-policies set-policy POLICY_PATH --update-mask=spec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
בדיקה של מדיניות הארגון המותאמת אישית
בדוגמה הבאה נוצרים אילוץ ומדיניות בהתאמה אישית שחוסמים יצירה של נקודות קצה שאין להן מפתח KMS.
לפני שמתחילים, חשוב לדעת את הדברים הבאים:
- מזהה הארגון
- מזהה פרויקט
יצירת האילוץ
שומרים את הקובץ הבא בשם
constraint-endpoint.yaml:name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictKmsKey resourceTypes: - aiplatform.googleapis.com/Endpoint methodTypes: - CREATE condition: "resource.encryptionSpec.kmsKeyName == \"\"" actionType: DENY displayName: Deny endpoint without a kms key description: All new endpoints must have a KMS key.כך מגדירים אילוץ שבו לכל נקודת קצה חדשה, אם לא מסופק מפתח KMS, יצירת נקודת הקצה נדחית.
מחילים את האילוץ:
gcloud org-policies set-custom-constraint ~/constraint-endpoint.yamlמוודאים שהאילוץ קיים:
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_IDהפלט אמור להיראות כך:
CUSTOM_CONSTRAINT ACTION_TYPE METHOD_TYPES RESOURCE_TYPES DISPLAY_NAME custom.restrictKmsKey DENY CREATE aiplatform.googleapis.com/Endpoint Deny endpoint without a kms key ...
יצירת המדיניות
שומרים את הקובץ הבא בשם
policy-deny-endpoint.yaml:name: projects/PROJECT_ID/policies/custom.restrictKmsKey spec: rules: - enforce: trueמחליפים את
PROJECT_IDבמזהה הפרויקט.מחילים את המדיניות:
gcloud org-policies set-policy ~/policy-deny-endpoint.yamlמוודאים שהמדיניות קיימת:
gcloud org-policies list --project=PROJECT_IDהפלט אמור להיראות כך:
CONSTRAINT LIST_POLICY BOOLEAN_POLICY ETAG custom.restrictKmsKey - SET CIzywsIGEKji2J8C-
אחרי שמחילים את המדיניות, ממתינים כשתי דקות עד ש- Google Cloud יתחיל לאכוף את המדיניות.
בדיקת המדיניות
מנסים ליצור נקודת קצה להסקת מסקנות אונליין ללא מפתח KMS:
gcloud ai endpoints create \
--region=LOCATION \
--display-name=ENDPOINT_NAME
הפלט שיתקבל:
Operation denied by org policy on resource: ["customConstraints/custom.restrictKmsKey": "All new endpoints must have a KMS key."]
דוגמאות למדיניות ארגונית מותאמת אישית לתרחישים נפוצים
בטבלה הזו מפורטות דוגמאות לתחביר של כמה אילוצים נפוצים בהתאמה אישית.
| תיאור | תחביר של אילוצים |
|---|---|
| הגבלת מפתח KMS לנקודות קצה של הסקת מסקנות אונליין |
name: organizations/ORGANIZATION_ID/customConstraints/custom. restrictKmsKey resourceTypes: - aiplatform.googleapis.com/Endpoint methodTypes: - CREATE condition: "resource.encryptionSpec.kmsKeyName == """ actionType: DENY displayName: Deny endpoint without a kms key description: All new endpoints must have a KMS key. |
המאמרים הבאים
- מידע נוסף על שירות מדיניות הארגון
- איך יוצרים ומנהלים את מדיניות הארגון
- רשימה מלאה של אילוצים מנוהלים של מדיניות הארגון