יצירה וניהול של אילוצים מותאמים אישית

בדף הזה מוסבר איך להשתמש באילוצים בהתאמה אישית של שירות מדיניות הארגון כדי להגביל פעולות ספציפיות במשאבי Google Cloud הבאים:

  • gkeonprem.googleapis.com/BareMetalAdminCluster
  • gkeonprem.googleapis.com/BareMetalCluster
  • gkeonprem.googleapis.com/BareMetalNodePool
  • gkeonprem.googleapis.com/VmwareAdminCluster
  • gkeonprem.googleapis.com/VmwareCluster
  • gkeonprem.googleapis.com/VmwareNodePool

מידע נוסף על מדיניות הארגון בהתאמה אישית

מידע על כללי מדיניות ואילוצים של הארגון

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

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

ירושה של מדיניות

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

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

  1. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloudליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.

  5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

  7. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  8. Verify that billing is enabled for your Google Cloud project.

  9. Install the Google Cloud CLI.

  10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  11. To initialize the gcloud CLI, run the following command: 

    gcloud init
  12. מוודאים שאתם יודעים מהו מזהה הארגון שלכם.

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לניהול של מדיניות ארגונית בהתאמה אישית, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות ארגונית (roles/orgpolicy.policyAdmin) ב-IAM במשאב הארגון. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

משאבים נתמכים ב-GKE On-Prem API

בטבלה הבאה מפורטים המשאבים של GKE On-Prem API שאפשר להפנות אליהם באילוצים בהתאמה אישית.

משאב שדה
gkeonprem.googleapis.com/BareMetalAdminCluster resource.annotations
resource.bareMetalVersion
resource.binaryAuthorization.evaluationMode
resource.clusterOperations.enableApplicationLogs
resource.controlPlane.apiServerArgs.argument
resource.controlPlane.apiServerArgs.value
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.kubeletConfig.registryBurst
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.kubeletConfig.registryPullQps
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.kubeletConfig.serializeImagePullsDisabled
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.nodeConfigs.nodeIp
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.operatingSystem
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.taints.effect
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.taints.key
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.taints.value
resource.description
resource.loadBalancer.manualLbConfig.enabled
resource.loadBalancer.portConfig.controlPlaneLoadBalancerPort
resource.loadBalancer.vipConfig.controlPlaneVip
resource.maintenanceConfig.maintenanceAddressCidrBlocks
resource.name
resource.networkConfig.islandModeCidr.podAddressCidrBlocks
resource.networkConfig.islandModeCidr.serviceAddressCidrBlocks
resource.nodeAccessConfig.loginUser
resource.nodeConfig.maxPodsPerNode
resource.osEnvironmentConfig.packageRepoExcluded
resource.proxy.noProxy
resource.proxy.uri
resource.securityConfig.authorization.adminUsers.username
resource.storage.lvpNodeMountsConfig.path
resource.storage.lvpNodeMountsConfig.storageClass
resource.storage.lvpShareConfig.lvpConfig.path
resource.storage.lvpShareConfig.lvpConfig.storageClass
resource.storage.lvpShareConfig.sharedPathPvCount
gkeonprem.googleapis.com/BareMetalCluster resource.adminClusterMembership
resource.annotations
resource.bareMetalVersion
resource.binaryAuthorization.evaluationMode
resource.clusterOperations.enableApplicationLogs
resource.controlPlane.apiServerArgs.argument
resource.controlPlane.apiServerArgs.value
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.kubeletConfig.registryBurst
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.kubeletConfig.registryPullQps
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.kubeletConfig.serializeImagePullsDisabled
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.nodeConfigs.nodeIp
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.operatingSystem
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.taints.effect
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.taints.key
resource.controlPlane.controlPlaneNodePoolConfig.nodePoolConfig.taints.value
resource.description
resource.loadBalancer.bgpLbConfig.addressPools.addresses
resource.loadBalancer.bgpLbConfig.addressPools.avoidBuggyIps
resource.loadBalancer.bgpLbConfig.addressPools.manualAssign
resource.loadBalancer.bgpLbConfig.addressPools.pool
resource.loadBalancer.bgpLbConfig.asn
resource.loadBalancer.bgpLbConfig.bgpPeerConfigs.asn
resource.loadBalancer.bgpLbConfig.bgpPeerConfigs.controlPlaneNodes
resource.loadBalancer.bgpLbConfig.bgpPeerConfigs.ipAddress
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.kubeletConfig.registryBurst
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.kubeletConfig.registryPullQps
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.kubeletConfig.serializeImagePullsDisabled
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.nodeConfigs.nodeIp
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.operatingSystem
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.taints.effect
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.taints.key
resource.loadBalancer.bgpLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.taints.value
resource.loadBalancer.manualLbConfig.enabled
resource.loadBalancer.metalLbConfig.addressPools.addresses
resource.loadBalancer.metalLbConfig.addressPools.avoidBuggyIps
resource.loadBalancer.metalLbConfig.addressPools.manualAssign
resource.loadBalancer.metalLbConfig.addressPools.pool
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.kubeletConfig.registryBurst
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.kubeletConfig.registryPullQps
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.kubeletConfig.serializeImagePullsDisabled
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.nodeConfigs.nodeIp
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.operatingSystem
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.taints.effect
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.taints.key
resource.loadBalancer.metalLbConfig.loadBalancerNodePoolConfig.nodePoolConfig.taints.value
resource.loadBalancer.portConfig.controlPlaneLoadBalancerPort
resource.loadBalancer.vipConfig.controlPlaneVip
resource.loadBalancer.vipConfig.ingressVip
resource.maintenanceConfig.maintenanceAddressCidrBlocks
resource.name
resource.networkConfig.advancedNetworking
resource.networkConfig.islandModeCidr.podAddressCidrBlocks
resource.networkConfig.islandModeCidr.serviceAddressCidrBlocks
resource.networkConfig.multipleNetworkInterfacesConfig.enabled
resource.networkConfig.srIovConfig.enabled
resource.nodeAccessConfig.loginUser
resource.nodeConfig.containerRuntime
resource.nodeConfig.maxPodsPerNode
resource.osEnvironmentConfig.packageRepoExcluded
resource.proxy.noProxy
resource.proxy.uri
resource.securityConfig.authorization.adminUsers.username
resource.storage.lvpNodeMountsConfig.path
resource.storage.lvpNodeMountsConfig.storageClass
resource.storage.lvpShareConfig.lvpConfig.path
resource.storage.lvpShareConfig.lvpConfig.storageClass
resource.storage.lvpShareConfig.sharedPathPvCount
resource.upgradePolicy.policy
gkeonprem.googleapis.com/BareMetalNodePool resource.annotations
resource.displayName
resource.name
resource.nodePoolConfig.kubeletConfig.registryBurst
resource.nodePoolConfig.kubeletConfig.registryPullQps
resource.nodePoolConfig.kubeletConfig.serializeImagePullsDisabled
resource.nodePoolConfig.nodeConfigs.nodeIp
resource.nodePoolConfig.operatingSystem
resource.nodePoolConfig.taints.effect
resource.nodePoolConfig.taints.key
resource.nodePoolConfig.taints.value
resource.upgradePolicy.parallelUpgradeConfig.concurrentNodes
resource.upgradePolicy.parallelUpgradeConfig.minimumAvailableNodes
gkeonprem.googleapis.com/VmwareAdminCluster resource.addonNode.autoResizeConfig.enabled
resource.annotations
resource.antiAffinityGroups.aagConfigDisabled
resource.authorization.viewerUsers.username
resource.autoRepairConfig.enabled
resource.bootstrapClusterMembership
resource.controlPlaneNode.cpus
resource.controlPlaneNode.memory
resource.controlPlaneNode.replicas
resource.description
resource.enableAdvancedCluster
resource.imageType
resource.loadBalancer.f5Config.address
resource.loadBalancer.f5Config.partition
resource.loadBalancer.f5Config.snatPool
resource.loadBalancer.manualLbConfig.addonsNodePort
resource.loadBalancer.manualLbConfig.controlPlaneNodePort
resource.loadBalancer.manualLbConfig.ingressHttpNodePort
resource.loadBalancer.manualLbConfig.ingressHttpsNodePort
resource.loadBalancer.manualLbConfig.konnectivityServerNodePort
resource.loadBalancer.metalLbConfig.enabled
resource.loadBalancer.vipConfig.addonsVip
resource.loadBalancer.vipConfig.controlPlaneVip
resource.name
resource.networkConfig.dhcpIpConfig.enabled
resource.networkConfig.haControlPlaneConfig.controlPlaneIpBlock.gateway
resource.networkConfig.haControlPlaneConfig.controlPlaneIpBlock.ips.hostname
resource.networkConfig.haControlPlaneConfig.controlPlaneIpBlock.ips.ip
resource.networkConfig.haControlPlaneConfig.controlPlaneIpBlock.netmask
resource.networkConfig.hostConfig.dnsSearchDomains
resource.networkConfig.hostConfig.dnsServers
resource.networkConfig.hostConfig.ntpServers
resource.networkConfig.podAddressCidrBlocks
resource.networkConfig.serviceAddressCidrBlocks
resource.networkConfig.staticIpConfig.ipBlocks.gateway
resource.networkConfig.staticIpConfig.ipBlocks.ips.hostname
resource.networkConfig.staticIpConfig.ipBlocks.ips.ip
resource.networkConfig.staticIpConfig.ipBlocks.netmask
resource.networkConfig.vcenterNetwork
resource.onPremVersion
resource.platformConfig.requiredPlatformVersion
resource.vcenter.address
resource.vcenter.caCertData
resource.vcenter.cluster
resource.vcenter.datacenter
resource.vcenter.dataDisk
resource.vcenter.datastore
resource.vcenter.folder
resource.vcenter.resourcePool
resource.vcenter.storagePolicyName
gkeonprem.googleapis.com/VmwareCluster resource.adminClusterMembership
resource.annotations
resource.antiAffinityGroups.aagConfigDisabled
resource.authorization.adminUsers.username
resource.autoRepairConfig.enabled
resource.binaryAuthorization.evaluationMode
resource.controlPlaneNode.autoResizeConfig.enabled
resource.controlPlaneNode.cpus
resource.controlPlaneNode.memory
resource.controlPlaneNode.replicas
resource.controlPlaneNode.vsphereConfig.datastore
resource.controlPlaneNode.vsphereConfig.storagePolicyName
resource.dataplaneV2.advancedNetworking
resource.dataplaneV2.dataplaneV2Enabled
resource.dataplaneV2.forwardMode
resource.dataplaneV2.windowsDataplaneV2Enabled
resource.description
resource.disableBundledIngress
resource.enableAdvancedCluster
resource.enableControlPlaneV2
resource.loadBalancer.f5Config.address
resource.loadBalancer.f5Config.partition
resource.loadBalancer.f5Config.snatPool
resource.loadBalancer.manualLbConfig.controlPlaneNodePort
resource.loadBalancer.manualLbConfig.ingressHttpNodePort
resource.loadBalancer.manualLbConfig.ingressHttpsNodePort
resource.loadBalancer.manualLbConfig.konnectivityServerNodePort
resource.loadBalancer.metalLbConfig.addressPools.addresses
resource.loadBalancer.metalLbConfig.addressPools.avoidBuggyIps
resource.loadBalancer.metalLbConfig.addressPools.manualAssign
resource.loadBalancer.metalLbConfig.addressPools.pool
resource.loadBalancer.vipConfig.controlPlaneVip
resource.loadBalancer.vipConfig.ingressVip
resource.name
resource.networkConfig.controlPlaneV2Config.controlPlaneIpBlock.gateway
resource.networkConfig.controlPlaneV2Config.controlPlaneIpBlock.ips.hostname
resource.networkConfig.controlPlaneV2Config.controlPlaneIpBlock.ips.ip
resource.networkConfig.controlPlaneV2Config.controlPlaneIpBlock.netmask
resource.networkConfig.dhcpIpConfig.enabled
resource.networkConfig.hostConfig.dnsSearchDomains
resource.networkConfig.hostConfig.dnsServers
resource.networkConfig.hostConfig.ntpServers
resource.networkConfig.podAddressCidrBlocks
resource.networkConfig.serviceAddressCidrBlocks
resource.networkConfig.staticIpConfig.ipBlocks.gateway
resource.networkConfig.staticIpConfig.ipBlocks.ips.hostname
resource.networkConfig.staticIpConfig.ipBlocks.ips.ip
resource.networkConfig.staticIpConfig.ipBlocks.netmask
resource.networkConfig.vcenterNetwork
resource.onPremVersion
resource.storage.vsphereCsiDisabled
resource.upgradePolicy.controlPlaneOnly
resource.vcenter.caCertData
resource.vcenter.cluster
resource.vcenter.datacenter
resource.vcenter.datastore
resource.vcenter.folder
resource.vcenter.resourcePool
resource.vcenter.storagePolicyName
resource.vmTrackingEnabled
gkeonprem.googleapis.com/VmwareNodePool resource.annotations
resource.config.bootDiskSizeGb
resource.config.cpus
resource.config.enableLoadBalancer
resource.config.image
resource.config.imageType
resource.config.memoryMb
resource.config.replicas
resource.config.taints.effect
resource.config.taints.key
resource.config.taints.value
resource.config.vsphereConfig.datastore
resource.config.vsphereConfig.hostGroups
resource.config.vsphereConfig.tags.category
resource.config.vsphereConfig.tags.tag
resource.displayName
resource.name
resource.nodePoolAutoscaling.maxReplicas
resource.nodePoolAutoscaling.minReplicas
resource.onPremVersion

הגדרת אילוץ בהתאמה אישית

אילוץ מותאם אישית מוגדר בקובץ YAML לפי המשאבים, השיטות, התנאים והפעולות שנתמכים בשירות שבו אתם אוכפים את מדיניות הארגון. התנאים של האילוצים המותאמים אישית מוגדרים באמצעות Common Expression Language (CEL). בקטע CEL במאמר יצירה וניהול של אילוצים בהתאמה אישית מוסבר איך ליצור תנאים באילוצים בהתאמה אישית באמצעות CEL.

המסוף

כדי ליצור אילוץ בהתאמה אישית:

  1. במסוף Google Cloud , נכנסים לדף מדיניות הארגון.

    כניסה לדף Organization policies

  2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
  3. לוחצים על Custom constraint.
  4. בתיבה Display name, מזינים שם לאילוץ שיהיה קריא לאנשים. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע רגיש בשמות לתצוגה, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
  5. בתיבה Constraint ID, מזינים את המזהה שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה custom.denyHighNumvCPUs. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.), לדוגמה, organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה.
  6. בתיבה Description, מזינים תיאור של האילוץ שקריא לאנשים. התיאור הזה משמש כהודעת שגיאה כשיש הפרה של המדיניות. ציינו פרטים על הסיבה להפרת המדיניות ואיך לפתור את הבעיה. אל תכללו פרטים אישיים מזהים או מידע רגיש בתיאור, כי הם עלולים להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 2,000 תווים.
  7. בתיבה Resource type, בוחרים את השם של משאב ה- Google Cloud REST שמכיל את האובייקט והשדה שרוצים להגביל, לדוגמה container.googleapis.com/Cluster. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל.
  8. אפשר לאכוף את האילוץ הזה רק ב-REST CREATE.

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

  9. כדי להגדיר תנאי, לוחצים על עריכת התנאי.
    1. בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך, לדוגמה resource.autopilot.enabled == false. השדה הזה יכול להכיל עד 1,500 תווים. לפרטים על השימוש ב-CEL, ראו Common Expression Language. מידע נוסף על משאבי השירות שבהם אפשר להשתמש באילוצים מותאמים אישית מופיע במאמר שירותים שנתמכים באילוצים מותאמים אישית.
    2. לוחצים על Save.
  10. בקטע Action, בוחרים אם לאשר או לדחות את השיטה שנבדקה אם התנאי מתקיים.

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

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

  11. לוחצים על Create constraint.

    12. אחרי שמזינים ערך בכל שדה, הגדרת ה-YAML המקבילה לאילוץ המותאם אישית הזה מופיעה בצד שמאל.

gcloud

  1. כדי ליצור אילוץ בהתאמה אישית, יוצרים קובץ YAML בפורמט הבא: 
    2. name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes: RESOURCE_NAME
methodTypes:
  - CREATE
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

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

    • ‫ORGANIZATION_ID: מזהה הארגון, למשל 123456789.
    • ‫CONSTRAINT_NAME: השם שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה, custom.denyHighNumvCPUs. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.) – לדוגמה, organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה.
    • ‫RESOURCE_NAME: השם המלא של המשאב ב- Google Cloudשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה, gkeonprem.googleapis.com/VmwareNodePool. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל.
    • ‫methodTypes: השיטות של REST שעליהן נאכף האילוץ. הערך יכול להיות רק CREATE.

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

    • ‫CONDITION: תנאי CEL שנכתב כנגד ייצוג של משאב שירות נתמך. השדה הזה יכול להכיל עד 1,500 תווים. לדוגמה, resource.config.cpus > 4.

      • למידע נוסף על המשאבים הזמינים לכתיבת תנאים, ראו משאבים נתמכים.

    • ‫ACTION: הפעולה שצריך לבצע אם התנאי condition מתקיים. הערך יכול להיות רק ALLOW.

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

    • ‫DISPLAY_NAME: שם קריא לאנשים של האילוץ. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים או במידע רגיש בשמות המוצגים, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
    • ‫DESCRIPTION: תיאור קריא של האילוץ שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. השדה הזה יכול להכיל עד 2,000 תווים.
  2. אחרי שיוצרים את קובץ ה-YAML לאילוץ חדש בהתאמה אישית, צריך להגדיר אותו כדי שיהיה זמין למדיניות הארגון. כדי להגדיר אילוץ בהתאמה אישית, משתמשים בפקודה gcloud org-policies set-custom-constraint: 
    3. gcloud org-policies set-custom-constraint CONSTRAINT_PATH

    מחליפים את CONSTRAINT_PATH בנתיב המלא לקובץ האילוץ בהתאמה אישית. לדוגמה, /home/user/customconstraint.yaml.

    בסיום הפעולה, האילוצים המותאמים אישית יהיו זמינים כמדיניות ארגונית ברשימת Google Cloud כללי המדיניות של הארגון.

  3. כדי לוודא שהאילוץ המותאם אישית קיים, משתמשים בפקודה gcloud org-policies list-custom-constraints: 
    4. gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

    מחליפים את ORGANIZATION_ID במזהה של משאב הארגון.

    איך בודקים את מדיניות הארגון

אכיפה של מדיניות ארגונית בהתאמה אישית

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף מדיניות הארגון.

    כניסה לדף Organization policies

  2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
  3. ברשימה שבדף מדיניות הארגון, בוחרים את האילוץ כדי להציג את הדף Policy details של אותו אילוץ.
  4. כדי להגדיר את מדיניות הארגון למשאב הזה, לוחצים על ניהול המדיניות.
  5. בדף עריכת המדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.
  6. לוחצים על Add a rule.
  7. בקטע Enforcement, בוחרים אם לאכוף את מדיניות הארגון הזו או לא.
  8. אופציונלי: כדי להוסיף תנאי למדיניות הארגון שמבוסס על תג, לוחצים על Add condition. שימו לב: אם מוסיפים כלל מותנה למדיניות הארגון, צריך להוסיף לפחות כלל אחד לא מותנה, אחרת אי אפשר לשמור את המדיניות. מידע נוסף זמין במאמר הגדרת ההיקף של מדיניות הארגון באמצעות תגים.
  9. לוחצים על בדיקת השינויים כדי לדמות את ההשפעה של מדיניות הארגון. למידע נוסף, קראו את המאמר בדיקת שינויים במדיניות הארגון באמצעות סימולטור המדיניות.
  10. כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, לוחצים על הגדרת המדיניות להרצת בדיקה. למידע נוסף, קראו את המאמר בדיקת כללי מדיניות של הארגון.
  11. אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמו שצריך, לוחצים על Set policy כדי להגדיר את המדיניות הפעילה.

gcloud

  1. כדי ליצור מדיניות ארגונית עם כללים בוליאניים, יוצרים קובץ YAML של מדיניות שמפנה לאילוץ: 
    2. name: projects/PROJECT_ID/policies/CONSTRAINT_NAME
spec:
  rules:
  - enforce: true

dryRunSpec:
  rules:
  - enforce: true

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

    • ‫PROJECT_ID: הפרויקט שבו רוצים לאכוף את האילוץ.
    • ‫CONSTRAINT_NAME: השם שהגדרתם לאילוץ המותאם אישית. לדוגמה, custom.denyHighNumvCPUs.
  2. כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, מריצים את הפקודה הבאה עם הדגל dryRunSpec: 
    3. gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec

    מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.

  3. אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמצופה, מגדירים את המדיניות הפעילה באמצעות הפקודה org-policies set-policy והדגל spec: 
    4. gcloud org-policies set-policy POLICY_PATH --update-mask=spec

    מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.

בדיקת מדיניות הארגון בהתאמה אישית

בדוגמה הבאה מוסבר איך לדחות עדכון של מאגר צמתים עם יותר מ-4 מעבדי vCPU באשכול משתמשים של VMware ב-Google Distributed Cloud (תוכנה בלבד).

לפני שמתחילים, חשוב לדעת את הדברים הבאים:

  • מזהה הארגון שלכם
  • מזהה פרויקט

יצירת האילוץ

  1. שומרים את הקובץ הבא בשם constraint-node-pool-vcpus.yaml:

    name: organizations/ORGANIZATION_ID/customConstraints/custom.denyHighNumvCPUs
resourceTypes:
- gkeonprem.googleapis.com/VmwareNodePool
methodTypes:
- CREATE
- UPDATE
condition: resource.config.cpus > 4
actionType: DENY
displayName: Node pool vCPU constraint
description: Node pools must have 4 or fewer vCPUs.

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

  2. מחילים את האילוץ:

    gcloud org-policies set-custom-constraint ~/constraint-node-pool-vcpus.yaml

  3. מוודאים שהאילוץ קיים:

    gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

    הפלט אמור להיראות כך:

    CUSTOM_CONSTRAINT         ACTION_TYPE  METHOD_TYPES   RESOURCE_TYPES                            DISPLAY_NAME
custom.denyHighNumvCPUs   DENY         CREATE         gkeonprem.googleapis.com/VmwareNodePool   Node pool vCPU constraint
...

יצירת המדיניות

  1. שומרים את הקובץ הבא בשם policy-deny-node-pool-high-vcpus.yaml:

    name: projects/PROJECT_ID/policies/custom.denyHighNumvCPUs
spec:
  rules:
  - enforce: true

    מחליפים את PROJECT_ID במזהה הפרויקט.

  2. מחילים את המדיניות:

    gcloud org-policies set-policy ~/policy-deny-node-pool-high-vcpus.yaml

  3. מוודאים שהמדיניות קיימת:

    gcloud org-policies list --project=PROJECT_ID

    הפלט אמור להיראות כך:

    CONSTRAINT               LIST_POLICY    BOOLEAN_POLICY    ETAG
custom.denyHighNumvCPUs  -              SET               COCsm5QGENiXi2E=

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

בדיקת המדיניות

מנסים לעדכן מאגר צמתים שמפר את המדיניות.

  1. אם רוצים, אפשר להציג את אשכולות המשתמשים כדי לקבל את שם האשכול והאזור:

    gcloud container vmware clusters list \
    --project=PROJECT_ID\
    --location=-

    כשמגדירים את --location=-, המערכת מציגה את כל אשכולות המשתמשים בכל האזורים. אם אתם צריכים לצמצם את הרשימה, הגדירו את --location לאזור שציינתם כשיצרתם את האשכול או כשנרשמתם ל-GKE On-Prem API.

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

    gcloud container vmware node-pools list \
    --cluster=USER_CLUSTER_NAME \
    --project=PROJECT_ID \
    --location=REGION

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

    • ‫USER_CLUSTER_NAME: השם של אשכול המשתמש שמכיל את מאגר הצמתים.

    • ‫REGION: האזור ב- Google Cloud שמשויך לאשכול המשתמש.

  3. מריצים את הפקודה הבאה כדי לנסות לעדכן את מספר המעבדים הווירטואליים ל-6:

    gcloud container vmware node-pools update NODE_POOL_NAME \
    --cluster=USER_CLUSTER_NAME  \
    --project=PROJECT_ID \
    --location=REGION \
    --cpus=6

    מחליפים את NODE_POOL_NAME בשם של מאגר הצמתים.

הפעולה נדחתה. הפלט שיתקבל:

Operation denied by custom org policy on resource 'projects/PROJECT_ID/locations/REGION/entryGroups/org-policy-test': ["customConstraints/custom.denyHighNumvCPUs"]

דוגמאות למדיניות ארגונית בהתאמה אישית לתרחישים נפוצים

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

תיאור תחביר האילוץ
דחיית גרסה 
    name: organizations/ORGANIZATION_ID/customConstraints/custom.VersionDeny
    resourceTypes:
    - gkeonprem.googleapis.com/BareMetalCluster
    methodTypes:
    - CREATE
    - UPDATE
    condition: resource.bareMetalVersion.startsWith("1.29")
    actionType: DENY
    displayName: Bare metal user cluster version denied
    description: The bare metal user cluster version is no longer supported
מותר רק אם יש מפתח 
    name: organizations/ORGANIZATION_ID/customConstraints/custom.AllowAnnotation
    resourceTypes:
    - gkeonprem.googleapis.com/BareMetalAdminCluster
    methodTypes:
    - CREATE
    - UPDATE
    condition: '"allowKey" in resource.annotations'
    actionType: ALLOW
    displayName: Bare metal admin cluster annotation keys allowed
    description: Annotation keys are allowed on bare metal admin clusters

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