Package v1alpha1 contains API Schema definitions for the frrk8s v1alpha1 API group
Appears in:
| Field | Description |
|---|---|
allowed AllowedOutPrefixes |
Allowed is is the list of prefixes allowed to be propagated to this neighbor. They must match the prefixes defined in the router. |
withLocalPref LocalPrefPrefixes array |
PrefixesWithLocalPref is a list of prefixes that are associated to a local preference when being advertised. The prefixes associated to a given local pref must be in the prefixes allowed to be advertised. |
withCommunity CommunityPrefixes array |
PrefixesWithCommunity is a list of prefixes that are associated to a bgp community when being advertised. The prefixes associated to a given local pref must be in the prefixes allowed to be advertised. |
Appears in:
| Field | Description |
|---|---|
prefixes PrefixSelector array |
|
mode AllowMode |
Mode is the mode to use when handling the prefixes. When set to "filtered", only the prefixes in the given list will be allowed. When set to "all", all the prefixes configured on the router will be allowed. |
Appears in:
| Field | Description |
|---|---|
prefixes string array |
|
mode AllowMode |
Mode is the mode to use when handling the prefixes. When set to "filtered", only the prefixes in the given list will be allowed. When set to "all", all the prefixes configured on the router will be allowed. |
BFDProfile is the configuration related to the BFD protocol associated to a BGP session.
Appears in:
| Field | Description |
|---|---|
name string |
The name of the BFD Profile to be referenced in other parts of the configuration. |
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. |
BGPConfig is the configuration related to the BGP protocol.
Appears in:
| Field | Description |
|---|---|
routers Router array |
Routers is the list of routers we want FRR to configure (one per VRF). |
bfdProfiles BFDProfile array |
BFDProfiles is the list of bfd profiles to be used when configuring the neighbors. |
CommunityPrefixes is a list of prefixes associated to a community.
Appears in:
| Field | Description |
|---|---|
prefixes string array |
Prefixes is the list of prefixes associated to the community. |
community string |
Community is the community associated to the prefixes. |
FRRConfiguration is a piece of FRR configuration.
| Field | Description |
|---|---|
apiVersion string |
frrk8s.metallb.io/v1beta1 |
kind string |
FRRConfiguration |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec FRRConfigurationSpec |
|
status FRRConfigurationStatus |
FRRConfigurationSpec defines the desired state of FRRConfiguration.
Appears in:
| Field | Description |
|---|---|
bgp BGPConfig |
BGP is the configuration related to the BGP protocol. |
raw RawConfig |
Raw is a snippet of raw frr configuration that gets appended to the one rendered translating the type safe API. |
nodeSelector LabelSelector |
NodeSelector limits the nodes that will attempt to apply this config. When specified, the configuration will be considered only on nodes whose labels match the specified selectors. When it is not specified all nodes will attempt to apply this config. |
FRRConfigurationStatus defines the observed state of FRRConfiguration.
Appears in:
FRRNodeState exposes the status of the FRR instance running on each node.
| Field | Description |
|---|---|
apiVersion string |
frrk8s.metallb.io/v1beta1 |
kind string |
FRRNodeState |
metadata ObjectMeta |
Refer to Kubernetes API documentation for fields of metadata. |
spec FRRNodeStateSpec |
|
status FRRNodeStateStatus |
FRRNodeStateSpec defines the desired state of FRRNodeState.
Appears in:
FRRNodeStateStatus defines the observed state of FRRNodeState.
Appears in:
| Field | Description |
|---|---|
runningConfig string |
RunningConfig represents the current FRR running config, which is the configuration the FRR instance is currently running with. |
lastConversionResult string |
LastConversionResult is the status of the last translation between the FRRConfigurations resources and FRR's configuration, contains "success" or an error. |
lastReloadResult string |
LastReloadResult represents the status of the last configuration update operation by FRR, contains "success" or an error. |
LocalPrefPrefixes is a list of prefixes associated to a local preference.
Appears in:
| Field | Description |
|---|---|
prefixes string array |
Prefixes is the list of prefixes associated to the local preference. |
localPref integer |
LocalPref is the local preference associated to the prefixes. |
Neighbor represents a BGP Neighbor we want FRR to connect to.
Appears in:
| Field | Description |
|---|---|
asn integer |
ASN is the AS number to use for the local end of the session. |
address string |
Address is the IP address to establish the session with. |
port integer |
Port is the port to dial when establishing the session. Defaults to 179. |
password string |
Password to be used for establishing the BGP session. Password and PasswordSecret are mutually exclusive. |
passwordSecret SecretReference |
PasswordSecret is name of the authentication secret for the neighbor. the secret must be of type "kubernetes.io/basic-auth", and created in the same namespace as the frr-k8s daemon. The password is stored in the secret as the key "password". Password and PasswordSecret are mutually exclusive. |
holdTime Duration |
HoldTime is the requested BGP hold time, per RFC4271. Defaults to 180s. |
keepaliveTime Duration |
KeepaliveTime is the requested BGP keepalive time, per RFC4271. Defaults to 60s. |
ebgpMultiHop boolean |
EBGPMultiHop indicates if the BGPPeer is multi-hops away. |
bfdProfile string |
BFDProfile is 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. |
toAdvertise Advertise |
ToAdvertise represents the list of prefixes to advertise to the given neighbor and the associated properties. |
toReceive Receive |
ToReceive represents the list of prefixes to receive from the given neighbor. |
PrefixSelector is a filter of prefixes to receive.
Appears in:
| Field | Description |
|---|---|
prefix string |
|
le integer |
The prefix length modifier. This selector accepts any matching prefix with length less or equal the given value. |
ge integer |
The prefix length modifier. This selector accepts any matching prefix with length greater or equal the given value. |
RawConfig is a snippet of raw frr configuration that gets appended to the rendered configuration.
Appears in:
| Field | Description |
|---|---|
priority integer |
Priority is the order with this configuration is appended to the bottom of the rendered configuration. A higher value means the raw config is appended later in the configuration file. |
rawConfig string |
Config is a raw FRR configuration to be appended to the configuration rendered via the k8s api. |
Receive represents a list of prefixes to receive from the given neighbor.
Appears in:
| Field | Description |
|---|---|
allowed AllowedInPrefixes |
Allowed is the list of prefixes allowed to be received from this neighbor. |
Router represent a neighbor router we want FRR to connect to.
Appears in:
| Field | Description |
|---|---|
asn integer |
ASN is the AS number to use for the local end of the session. |
id string |
ID is the BGP router ID |
vrf string |
VRF is the host vrf used to establish sessions from this router. |
neighbors Neighbor array |
Neighbors is the list of neighbors we want to establish BGP sessions with. |
prefixes string array |
Prefixes is the list of prefixes we want to advertise from this router instance. |