Organization Policy API משתמש במשאבים מותאמים אישית של Kubernetes ומסתמך על Kubernetes Resource Model (KRM). הוא משמש לניהול מחזור החיים של כללי מדיניות הארגון, כמו יצירה, עדכון ומחיקה.
כדי להשתמש ב-Organization Policy API, מומלץ להשתמש ב-Kubernetes CLI kubectl. אם האפליקציה שלכם צריכה להשתמש בספריות משלה כדי לקרוא ל-API הזה, תוכלו להיעזר בדוגמה הבאה, בהגדרה המלאה של ה-API ובדף הייעודי של התאמת המדיניות כדי ליצור את הבקשות.
נקודת קצה של שירות ומסמך Discovery
נקודת קצה ל-API של Organization Policy היא:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/constraints.gatekeeper.sh/v1beta1
כאשר MANAGEMENT_API_SERVER_ENDPOINT היא נקודת הקצה של שרת Management API.
באמצעות הפקודה kubectl proxy, אפשר לגשת לכתובת ה-URL הזו בדפדפן או באמצעות כלי כמו curl כדי לקבל את מסמך Discovery של Organization Policy API. הפקודה kubectl proxy פותחת פרוקסי לשרת Kubernetes API במחשב המקומי. אחרי שהפקודה הזו תפעל, תוכלו לגשת למסמך בכתובת ה-URL הבאה:
http://127.0.0.1:8001/apis/constraints.gatekeeper.sh/v1beta1.
דוגמה ל-KRM
בדוגמה הבאה מוצג אובייקט GDCHRestrictedServices ב-Organization Policy API שמגביל את השימוש בשירותי מסדי הנתונים לפרויקטים עם התווית owner: dba-team.
apiVersion: constraints.gatekeeper.sh/v1beta1
kind: GDCHRestrictedService
metadata:
name: db-restricted-to-dbas
spec:
match:
scope: Namespaced
namespaceSelector:
matchExpressions:
# We are restricting the use of the service in namespaces that
# DON'T have the owner: dba-team label
- key: owner
operator: NotIn
values:
- dba-team
kinds:
- apiGroups:
- "postgresql.dbadmin.gdc.goog"
kinds:
- Dbclusters
- Backupplans
- Imports
- Restores
- apiGroups:
- "oracle.dbadmin.gdc.goog"
kinds:
- Dbclusters
- Backupplans
- Imports
parameters:
disabledOperations:
- "UPDATE"
- "CREATE"