סקירה כללית על 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

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

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

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/ipam.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/ipam.global.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
  • http://127.0.0.1:8001/apis/ipam.global.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

זו דוגמה לאובייקט Subnet גלובלי עבור CIDR של שורש VPC שמוגדר כברירת מחדל:

apiVersion: ipam.global.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
    ipam.gdc.goog/usage: network-root-range
  name: default-vpc-root-cidr
  namespace: platform
spec:
  ipv4Request:
    cidr: 10.200.0.0/23
  type: Root