BFDProfile represents the settings of the bfd session that can be optionally associated with a BGP session.
| Field | Description |
|---|---|
apiVersion string |
metallb.io/v1beta1 |
kind string |
BFDProfile |
kind string |
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 |
apiVersion string |
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 |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec BFDProfileSpec |
BFDProfileSpec defines the desired state of BFDProfile.
Appears in: - BFDProfile
| Field | Description |
|---|---|
receiveInterval integer |
The minimum interval that this system is capable of receiving control packets in milliseconds. Defaults to 300ms. |
transmitInterval integer |
The minimum transmission interval (less jitter) that this system wants to use to send BFD control packets in milliseconds. Defaults to 300ms |
detectMultiplier integer |
Configures the detection multiplier to determine packet loss. The remote transmission interval will be multiplied by this value to determine the connection loss detection timer. |
echoInterval integer |
Configures the minimal echo receive transmission interval that this system is capable of handling in milliseconds. Defaults to 50ms |
echoMode boolean |
Enables or disables the echo transmission mode. This mode is disabled by default, and not supported on multi hops setups. |
passiveMode boolean |
Mark session as passive: a passive session will not attempt to start the connection and will wait for control packets from peer before it begins replying. |
minimumTtl integer |
For multi hop sessions only: configure the minimum expected TTL for an incoming BFD control packet. |
BGPAdvertisement allows to advertise the IPs coming from the selected IPAddressPools via BGP, setting the parameters of the BGP Advertisement.
| Field | Description |
|---|---|
apiVersion string |
metallb.io/v1beta1 |
kind string |
BGPAdvertisement |
kind string |
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 |
apiVersion string |
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 |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec BGPAdvertisementSpec |
BGPAdvertisementSpec defines the desired state of BGPAdvertisement.
Appears in: - BGPAdvertisement
| Field | Description |
|---|---|
aggregationLength integer |
The aggregation-length advertisement option lets you “roll up” the /32s into a larger prefix. Defaults to 32. Works for IPv4 addresses. |
aggregationLengthV6 integer |
The aggregation-length advertisement option lets you “roll up” the /128s into a larger prefix. Defaults to 128. Works for IPv6 addresses. |
localPref integer |
The BGP LOCAL_PREF attribute which is used by BGP best path algorithm, Path with higher localpref is preferred over one with lower localpref. |
communities string array |
The BGP communities to be associated with the announcement. Each item can be a standard community of the form 1234:1234, a large community of the form large:1234:1234:1234 or the name of an alias defined in the Community CRD. |
ipAddressPools string array |
The list of IPAddressPools to advertise via this advertisement, selected by name. |
ipAddressPoolSelectors LabelSelector array |
A selector for the IPAddressPools which would get advertised via this advertisement. If no IPAddressPool is selected by this or by the list, the advertisement is applied to all the IPAddressPools. |
nodeSelectors LabelSelector array |
NodeSelectors allows to limit the nodes to announce as next hops for the LoadBalancer IP. When empty, all the nodes having are announced as next hops. |
peers string array |
Peers limits the bgppeer to advertise the ips of the selected pools to. When empty, the loadbalancer IP is announced to all the BGPPeers configured. |
Community is a collection of aliases for communities. Users can define named aliases to be used in the BGPPeer CRD.
| Field | Description |
|---|---|
apiVersion string |
metallb.io/v1beta1 |
kind string |
Community |
kind string |
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 |
apiVersion string |
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 |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec CommunitySpec |
Appears in: - CommunitySpec
| Field | Description |
|---|---|
name string |
The name of the alias for the community. |
value string |
The BGP community value corresponding to the given name. Can be a standard community of the form 1234:1234 or a large community of the form large:1234:1234:1234. |
CommunitySpec defines the desired state of Community.
Appears in: - Community
| Field | Description |
|---|---|
communities CommunityAlias array |
IPAddressPool represents a pool of IP addresses that can be allocated to LoadBalancer services.
| Field | Description |
|---|---|
apiVersion string |
metallb.io/v1beta1 |
kind string |
IPAddressPool |
kind string |
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 |
apiVersion string |
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 |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec IPAddressPoolSpec |
IPAddressPoolSpec defines the desired state of IPAddressPool.
Appears in: - IPAddressPool
| Field | Description |
|---|---|
addresses string array |
A list of IP address ranges over which MetalLB has authority. You can list multiple ranges in a single pool, they will all share the same settings. Each range can be either a CIDR prefix, or an explicit start-end range of IPs. |
autoAssign boolean |
AutoAssign flag used to prevent MetallB from automatic allocation for a pool. |
avoidBuggyIPs boolean |
AvoidBuggyIPs prevents addresses ending with .0 and .255 to be used by a pool. |
serviceAllocation ServiceAllocation |
AllocateTo makes ip pool allocation to specific namespace and/or service. The controller will use the pool with lowest value of priority in case of multiple matches. A pool with no priority set will be used only if the pools with priority can’t be used. If multiple matching IPAddressPools are available it will check for the availability of IPs sorting the matching IPAddressPools by priority, starting from the highest to the lowest. If multiple IPAddressPools have the same priority, choice will be random. |
L2Advertisement allows to advertise the LoadBalancer IPs provided by the selected pools via L2.
| Field | Description |
|---|---|
apiVersion string |
metallb.io/v1beta1 |
kind string |
L2Advertisement |
kind string |
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 |
apiVersion string |
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 |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec L2AdvertisementSpec |
L2AdvertisementSpec defines the desired state of L2Advertisement.
Appears in: - L2Advertisement
| Field | Description |
|---|---|
ipAddressPools string array |
The list of IPAddressPools to advertise via this advertisement, selected by name. |
ipAddressPoolSelectors LabelSelector array |
A selector for the IPAddressPools which would get advertised via this advertisement. If no IPAddressPool is selected by this or by the list, the advertisement is applied to all the IPAddressPools. |
nodeSelectors LabelSelector array |
NodeSelectors allows to limit the nodes to announce as next hops for the LoadBalancer IP. When empty, all the nodes having are announced as next hops. |
interfaces string array |
A list of interfaces to announce from. The LB IP will be announced only from these interfaces. If the field is not set, we advertise from all the interfaces on the host. |
ServiceAllocation defines ip pool allocation to namespace and/or service.
Appears in: - IPAddressPoolSpec
| Field | Description |
|---|---|
priority integer |
Priority priority given for ip pool while ip allocation on a service. |
namespaces string array |
Namespaces list of namespace(s) on which ip pool can be attached. |
namespaceSelectors LabelSelector array |
NamespaceSelectors list of label selectors to select namespace(s) for ip pool, an alternative to using namespace list. |
serviceSelectors LabelSelector array |
ServiceSelectors list of label selector to select service(s) for which ip pool can be used for ip allocation. |
BGPPeer is the Schema for the peers API.
| Field | Description |
|---|---|
apiVersion string |
metallb.io/v1beta2 |
kind string |
BGPPeer |
kind string |
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 |
apiVersion string |
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 |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec BGPPeerSpec |
BGPPeerSpec defines the desired state of Peer.
Appears in: - BGPPeer
| Field | Description |
|---|---|
myASN integer |
AS number to use for the local end of the session. |
peerASN integer |
AS number to expect from the remote end of the session. |
peerAddress string |
Address to dial when establishing the session. |
sourceAddress string |
Source address to use when establishing the session. |
peerPort integer |
Port to dial when establishing the session. |
holdTime Duration |
Requested BGP hold time, per RFC4271. |
keepaliveTime Duration |
Requested BGP keepalive time, per RFC4271. |
connectTime Duration |
Requested BGP connect time, controls how long BGP waits between connection attempts to a neighbor. |
routerID string |
BGP router ID to advertise to the peer |
nodeSelectors LabelSelector array |
Only connect to this peer on nodes that match one of these selectors. |
password string |
Authentication password for routers enforcing TCP MD5 authenticated sessions |
passwordSecret SecretReference |
passwordSecret is name of the authentication secret for BGP Peer. the secret must be of type “kubernetes.io/basic-auth”, and created in the same namespace as the MetalLB deployment. The password is stored in the secret as the key “password”. |
bfdProfile string |
The name of the BFD Profile to be used for the BFD session associated to the BGP session. If not set, the BFD session won’t be set up. |
ebgpMultiHop boolean |
To set if the BGPPeer is multi-hops away. Needed for FRR mode only. |
vrf string |
To set if we want to peer with the BGPPeer using an interface belonging to a host vrf |
disableMP boolean |
To set if we want to disable MP BGP that will separate IPv4 and IPv6 route exchanges into distinct BGP sessions. |