סקירה כללית על IP Address Management API

הממשק IP Address Management ‏ (IPAM) API משתמש במשאבים מותאמים אישית של Kubernetes ומסתמך על Kubernetes Resource Model ‏ (KRM). הוא מנהל את הקצאת כתובות ה-IP בפריסת מכשיר במודל Air-gapped של Google Distributed Cloud‏ (GDC).

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

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

כתובת ה-URL הבאה היא נקודת קצה ל-API של IPAM KRM:

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

מחליפים את הערך MANAGEMENT_API_SERVER_ENDPOINT בנקודת הקצה של שרת Management API.

אפשר להשתמש בפקודה kubectl proxy כדי לגשת לכתובת ה-URL הזו בדפדפן או באמצעות כלי כמו curl כדי לקבל את מסמך Discovery של IPAM API. הפקודה kubectl proxy פותחת פרוקסי לשרת Kubernetes API במחשב המקומי. אחרי שמריצים את הפקודה, אפשר לגשת למסמך בכתובת ה-URL הבאה: http://127.0.0.1:8001/apis/ipam.gdc.goog/v1.

דוגמאות למשאבים מותאמים אישית

דוגמה לאובייקט Subnet:

apiVersion: ipam.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/overlay-network-type: External
    ipam.gdc.goog/category-type: ExternalOverlayNetwork
  name: test-subnet
  namespace: root
spec:
  type: Root
  ipv4Request:
    cidr: 10.0.0.0/16
  networkSpec:
    staticVLANID: 100
    enableVLANID: true
    enableGateway: true