Skip to main content
Calico Open Source 3.33 (latest) documentation

IPAM configuration

An IP address management (IPAM) configuration resource (IPAMConfiguration) represents global IPAM configuration options.

Sample YAML​

apiVersion: projectcalico.org/v3
kind: IPAMConfiguration
metadata:
name: default
spec:
strictAffinity: false
maxBlocksPerHost: 4
kubeVirtVMAddressPersistence: Enabled

IPAM configuration definition​

Metadata​

FieldDescriptionAccepted ValuesSchema
nameUnique name to describe this resource instance. Required.defaultstring

The resource is a singleton which must have the name default.

Spec​

FieldDescriptionAccepted ValuesSchemaDefault
strictAffinityWhen StrictAffinity is true, borrowing IP addresses is not allowed.true, falseboolfalse
maxBlocksPerHostThe max number of blocks that can be affine to each host.0 - 1000000int20
kubeVirtVMAddressPersistenceControls whether KubeVirt VMs retain persistent IP addresses across lifecycle events such as restart or migration. Requires KubeVirt.Enabled, DisabledstringEnabled
ipCooldownSecondsThe minimum age, in seconds, of a released IP address in a block before it is reused. If 0, IP addresses can be reused immediately.0 - 1200int0