A API IP Address Management (IPAM) usa recursos personalizados do Kubernetes e depende do modelo de recursos do Kubernetes (KRM). Ele gerencia a alocação de endereços IP em uma implantação do Google Distributed Cloud (GDC) com isolamento físico.
Para usar a API IPAM, recomendamos que você use a CLI gdcloud ou
chame a API diretamente usando a CLI kubectl. Se o aplicativo precisar usar
suas próprias bibliotecas para chamar essa API, use os exemplos a seguir e as
definições completas da API para criar as solicitações:
Endpoint de serviço e documento de descoberta
As APIs de IPAM são fornecidas em dois pacotes, dependendo da implantação zonal ou global.
Os endpoints de API para as APIs IPAM zonal e global são os seguintes, respectivamente:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/ipam.gdc.goog/v1https://MANAGEMENT_API_SERVER_ENDPOINT/apis/ipam.global.gdc.goog/v1
A variável MANAGEMENT_API_SERVER_ENDPOINT
é o endpoint do servidor de API Management.
Usando o comando kubectl proxy, é possível acessar esse URL no navegador ou
com uma ferramenta como curl para receber o documento de descoberta da API IPAM.
O comando kubectl proxy abre um proxy para o servidor de API Kubernetes na máquina local. Depois que o comando estiver em execução, você poderá acessar o documento nos
seguintes URLs:
http://127.0.0.1:8001/apis/ipam.gdc.goog/v1http://127.0.0.1:8001/apis/ipam.global.gdc.goog/v1
Exemplos de recursos personalizados
Veja a seguir um exemplo de objeto Subnet zonal:
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
Veja a seguir um exemplo de um objeto Subnet global para um CIDR raiz de VPC padrão:
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