סקירה כללית על Resource Manager API

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

כדי להשתמש ב-Resource Manager API, מומלץ להשתמש במסוף GDC, ב-gdcloud CLI או להתקשר ל-API ישירות באמצעות kubectl CLI. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא ל-API הזה, תוכלו להשתמש בדוגמאות הבאות ובהגדרות המלאות של ה-API כדי ליצור את הבקשות:

נקודת קצה של שירות ומסמך Discovery

ממשקי ה-API של מנהל המשאבים מסופקים בשתי חבילות, בהתאם לפריסה אזורית או לפריסה גלובלית.

נקודות הקצה של ה-API של מנהל המשאבים ברמת האזור וברמה הגלובלית הן:

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.global.gdc.goog/v1

נקודת קצה ל-API של מנהל המשאבים View היא:

https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1

המשתנה MANAGEMENT_API_SERVER_ENDPOINT הוא נקודת הקצה של שרת Management API.

אפשר להשתמש בפקודה kubectl proxy כדי לגשת לכתובות ה-URL של נקודות קצה ל-API בדפדפן או בכלי כמו curl כדי לקבל את מסמך Discovery של מנהל המשאבים API. הפקודה kubectl proxy פותחת פרוקסי לשרת Kubernetes API במחשב המקומי. אחרי הרצת הפקודה, אפשר לגשת למסמכים בכתובות ה-URL הבאות:

  • http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1
  • http://127.0.0.1:8001/apis/resourcemanager.global.gdc.goog/v1
  • http://127.0.0.1:8001/apis/resourcemanagerview.gdc.goog/v1

דוגמה למשאב פרויקט

בדוגמה הבאה מוצג אובייקט Project שהוגדר כמשאב פרויקט GDC. כשמשתמשים ב-API של מנהל המשאבים כדי ליצור פרויקט דרך מסוף GDC, נוצר אובייקט Project כברירת מחדל. אפשר לשנות אותו רק כדי לשקף את המצב הרצוי של הפרויקט.

apiVersion: resourcemanager.global.gdc.goog/v1
kind: Project
metadata:
  namespace: platform
  name: test-project