CiliumLoadBalancerIPPool is a Kubernetes third-party resource which is used to defined pools of IPs which the operator can use to allocate and advertise IPs for Services of type LoadBalancer.
5 top-level fields, 2 required · last changed in Cilium 1.20.0
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
Spec is a human readable description for a BGP load balancer ip pool.
AllowFirstLastIPs, if set to `Yes` or undefined means that the first and last IPs of each CIDR will be allocatable. If `No`, these IPs will be reserved. This field is ignored for /{31,32} and /{127,128} CIDRs since reserving the first and last IPs would make the CIDRs unusable.
Blocks is a list of CIDRs comprising this IP Pool
Disabled, if set to true means that no new IPs will be allocated from this pool. Existing allocations will not be removed from services.
ServiceSelector selects a set of services which are eligible to receive IPs from this
matchExpressions is a list of label selector requirements. The requirements are ANDed.
key is the label key that the selector applies to.
operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
Status is the status of the IP Pool. It might be possible for users to define overlapping IP Pools, we can't validate or enforce non-overlapping pools during object creation. The Cilium operator will do this validation and update the status to reflect the ability to allocate IPs from this pool.
Current service state
lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
message is a human readable message indicating details about the transition. This may be an empty string.
observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
status of the condition, one of True, False, Unknown.
type of condition in CamelCase or in foo.example.com/CamelCase.
Source: ciliumloadbalancerippools.yaml
Changes to CiliumLoadBalancerIPPool (cilium.io/v2alpha1) in each Cilium version, compared to the version before it.
The description of CiliumLoadBalancerIPPool has changed
Released · View CiliumLoadBalancerIPPool in 1.20.0
1 property is now required
The description of CiliumLoadBalancerIPPool has changed
14 properties have changed the description
Released · View CiliumLoadBalancerIPPool in 1.17.0
1 property has changed the description
Released · View CiliumLoadBalancerIPPool in 1.16.2
1 property has been removed
Released · View CiliumLoadBalancerIPPool in 1.16.0
4 properties have been added
2 properties are no longer required
1 property has changed the description
Released · View CiliumLoadBalancerIPPool in 1.15.0
CiliumLoadBalancerIPPool was first seen on this version of Cilium
Released · View CiliumLoadBalancerIPPool in 1.13.0
No examples of CiliumLoadBalancerIPPool yet. Contribute one on GitHub.
kubespec.dev