diff --git a/calico/reference/resources/bgpconfig.mdx b/calico/reference/resources/bgpconfig.mdx index 0d8c904e73..a961a32ee5 100644 --- a/calico/reference/resources/bgpconfig.mdx +++ b/calico/reference/resources/bgpconfig.mdx @@ -1,5 +1,5 @@ --- -description: Reference for the BGPConfiguration resource in Calico Open Source that sets cluster-wide BGP options including the autonomous system number and route reflectors. +description: Reference for the BGPConfiguration resource in Calico Open Source that sets cluster-wide BGP options including the autonomous system number and the node-to-node mesh. --- # BGP configuration @@ -42,23 +42,24 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | --------------------------------------------------------- | --------------------------------------------------- | ------ | -| `name` | Unique name to describe this resource instance. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| `name` | Unique name to describe this resource instance. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | - The resource with the name `default` has a specific meaning - this contains the BGP global default configuration. -- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. When deleting a node the BGPConfiguration resource associated with the node will also be deleted. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. +- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. ### Spec | Field | Description | Accepted Values | Schema | Default | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------- | -| `logSeverityScreen` | Global log level | Debug, Info, Warning, Error, Fatal | string | `Info` | -| `nodeToNodeMeshEnabled` | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | string | true | -| `asNumber` | The default local AS Number that $[prodname] should use when speaking with BGP peers. Only valid on the global `default` BGPConfiguration; to set a per-node override, use the `bgp` field on the [Node resource](node.mdx). | A valid AS Number, may be specified in dotted notation. | integer/string | 64512 | +| `logSeverityScreen` | Global log level | Trace, Debug, Info, Warning, Error, Fatal | string | `Info` | +| `nodeToNodeMeshEnabled` | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | boolean | true | +| `asNumber` | The default local AS Number that $[prodname] should use when speaking with BGP peers. Only valid on the global `default` BGPConfiguration; to set a per-node override, use the `bgp` field on the [Node resource](node.mdx). | A valid AS Number. String values, including dotted notation, work through `calicoctl` or the $[prodname] API server, but not with `kubectl` on [native v3 CRDs](../../operations/native-v3-crds.mdx). | integer/string | 64512 | | `serviceClusterIPs` | The CIDR blocks for Kubernetes Service Cluster IPs to be advertised over BGP. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | `serviceExternalIPs` | The CIDR blocks for Kubernetes Service External IPs to be advertised over BGP. Kubernetes Service External IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | `serviceLoadBalancerIPs` | The CIDR blocks for Kubernetes Service status.LoadBalancer IPs to be advertised over BGP. Kubernetes LoadBalancer IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | +| `serviceLoadBalancerAggregation` | Controls how Kubernetes Service LoadBalancer IPs are advertised. When `Enabled`, $[prodname] advertises the CIDR blocks in `serviceLoadBalancerIPs`. When `Disabled`, it advertises an individual route for each LoadBalancer IP instead. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | Enabled, Disabled | string | Enabled | | `listenPort` | The port where BGP protocol should listen. | A valid port number. | integer | 179 | -| `bindMode` | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is manually restarted. | None, NodeIP. | string | None | +| `bindMode` | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is restarted. With an operator installation, the operator restarts calico-node automatically. | None, NodeIP. | string | None | | `communities` | List of BGP community names and their values, communities are not advertised unless they are used in [prefixAdvertisements](#prefixadvertisements). | | List of [communities](#communities) | | `prefixAdvertisements` | List of per-prefix advertisement properties, like BGP communities. | | List of [prefixAdvertisements](#prefixadvertisements) | | `nodeMeshPassword` | BGP password for the all the peerings in a full mesh configuration. | | [BGPPassword](bgppeer.mdx#bgppassword) | `nil` (no password) | @@ -68,7 +69,7 @@ spec: | `localWorkloadPeeringIPV6` | Single virtual IPv6 address that all nodes will use for peering with local workloads when using `BGPPeer`'s `localWorkloadSelector`. Must _not_ be a link-local address (because $[prodname] doesn't currently support the required "scope" suffix). See the [guide](../../networking/configuring/bgp-to-workload.mdx) for details. | An IPv6 address. | string | None | | `ipv4NormalRoutePriority` | The normal route priority (metric) that Felix uses for IPv4 workload routes. This must match the value configured in FelixConfiguration. BIRD uses this to identify elevated-priority routes during live migration and to override local workload routes with higher-priority BGP-learned routes. | 1-2147483646 | integer | 1024 | | `ipv6NormalRoutePriority` | The normal route priority (metric) that Felix uses for IPv6 workload routes. This must match the value configured in FelixConfiguration. BIRD uses this to identify elevated-priority routes during live migration and to override local workload routes with higher-priority BGP-learned routes. | 1-2147483646 | integer | 1024 | -| `programClusterRoutes` | Controls whether $[prodname] programs cluster routes for IP Pools with VXLAN or IP-in-IP enabled. Felix always programs such routes for IP Pools with `vxlanMode: Always` or `vxlanMode: CrossSubnet`. | Enabled, Disabled | string | Enabled | +| `programClusterRoutes` | Controls which cluster routes BIRD programs for IP Pools with `vxlanMode: Never`: `Disabled` programs none, `EnabledNoEncapOnly` programs them for unencapsulated IP Pools, `EnabledIPIPOnly` for IP-in-IP IP Pools, and `Enabled` for both. Felix always programs such routes for IP Pools with `vxlanMode: Always` or `vxlanMode: CrossSubnet`. | Enabled, Disabled, EnabledIPIPOnly, EnabledNoEncapOnly | string | EnabledNoEncapOnly | ### communities @@ -81,5 +82,5 @@ spec: | Field | Description | Accepted Values | Schema | | ----------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -| `cidr` | CIDR for which properties should be advertised. | `cidr: XXX.XXX.XXX.XXX/XX` | string | +| `cidr` | CIDR for which properties should be advertised. | A valid IPv4 or IPv6 CIDR. | string | | `communities` | BGP communities to be advertised. | Communities can be list of either community names already defined in [communities](#communities) or community value of format `aa:nn` or `aa:nn:mm`.
For standard community, value should be in `aa:nn` format, where both `aa` and `nn` are 16 bit integers.
For large community, value should be `aa:nn:mm` format, where `aa`, `nn` and `mm` are all 32 bit integers.
Where `aa` is an AS Number, `nn` and `mm` are per-AS identifier. | List of string | \ No newline at end of file diff --git a/calico_versioned_docs/version-3.31/reference/resources/bgpconfig.mdx b/calico_versioned_docs/version-3.31/reference/resources/bgpconfig.mdx index 364eb09efb..78e8115dca 100644 --- a/calico_versioned_docs/version-3.31/reference/resources/bgpconfig.mdx +++ b/calico_versioned_docs/version-3.31/reference/resources/bgpconfig.mdx @@ -42,23 +42,24 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | --------------------------------------------------------- | --------------------------------------------------- | ------ | -| name | Unique name to describe this resource instance. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| name | Unique name to describe this resource instance. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | - The resource with the name `default` has a specific meaning - this contains the BGP global default configuration. -- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. When deleting a node the BGPConfiguration resource associated with the node will also be deleted. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. +- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. ### Spec | Field | Description | Accepted Values | Schema | Default | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------- | -| logSeverityScreen | Global log level | Debug, Info, Warning, Error, Fatal | string | `Info` | -| nodeToNodeMeshEnabled | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | string | true | +| logSeverityScreen | Global log level | Trace, Debug, Info, Warning, Error, Fatal | string | `Info` | +| nodeToNodeMeshEnabled | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | boolean | true | | asNumber | The default local AS Number that $[prodname] should use when speaking with BGP peers. Only valid on the global `default` BGPConfiguration; to set a per-node override, use the `bgp` field on the [Node resource](node.mdx). | A valid AS Number, may be specified in dotted notation. | integer/string | 64512 | | serviceClusterIPs | The CIDR blocks for Kubernetes Service Cluster IPs to be advertised over BGP. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | serviceExternalIPs | The CIDR blocks for Kubernetes Service External IPs to be advertised over BGP. Kubernetes Service External IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | serviceLoadBalancerIPs | The CIDR blocks for Kubernetes Service status.LoadBalancer IPs to be advertised over BGP. Kubernetes LoadBalancer IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | +| serviceLoadBalancerAggregation | Controls how Kubernetes Service LoadBalancer IPs are advertised. When `Enabled`, $[prodname] advertises the CIDR blocks in `serviceLoadBalancerIPs`. When `Disabled`, it advertises an individual route for each LoadBalancer IP instead. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | Enabled, Disabled | string | Enabled | | listenPort | The port where BGP protocol should listen. | A valid port number. | integer | 179 | -| bindMode | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is manually restarted. | None, NodeIP. | string | None | +| bindMode | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is restarted. With an operator installation, the operator restarts calico-node automatically. | None, NodeIP. | string | None | | communities | List of BGP community names and their values, communities are not advertised unless they are used in [prefixAdvertisements](#prefixadvertisements). | | List of [communities](#communities) | | prefixAdvertisements | List of per-prefix advertisement properties, like BGP communities. | | List of [prefixAdvertisements](#prefixadvertisements) | | nodeMeshPassword | BGP password for the all the peerings in a full mesh configuration. | | [BGPPassword](bgppeer.mdx#bgppassword) | `nil` (no password) | @@ -78,5 +79,5 @@ spec: | Field | Description | Accepted Values | Schema | | ----------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -| cidr | CIDR for which properties should be advertised. | `cidr: XXX.XXX.XXX.XXX/XX` | string | +| cidr | CIDR for which properties should be advertised. | A valid IPv4 or IPv6 CIDR. | string | | communities | BGP communities to be advertised. | Communities can be list of either community names already defined in [communities](#communities) or community value of format `aa:nn` or `aa:nn:mm`.
For standard community, value should be in `aa:nn` format, where both `aa` and `nn` are 16 bit integers.
For large community, value should be `aa:nn:mm` format, where `aa`, `nn` and `mm` are all 32 bit integers.
Where `aa` is an AS Number, `nn` and `mm` are per-AS identifier. | List of string | \ No newline at end of file diff --git a/calico_versioned_docs/version-3.32/reference/resources/bgpconfig.mdx b/calico_versioned_docs/version-3.32/reference/resources/bgpconfig.mdx index 0d8c904e73..6cbb53b148 100644 --- a/calico_versioned_docs/version-3.32/reference/resources/bgpconfig.mdx +++ b/calico_versioned_docs/version-3.32/reference/resources/bgpconfig.mdx @@ -1,5 +1,5 @@ --- -description: Reference for the BGPConfiguration resource in Calico Open Source that sets cluster-wide BGP options including the autonomous system number and route reflectors. +description: Reference for the BGPConfiguration resource in Calico Open Source that sets cluster-wide BGP options including the autonomous system number and the node-to-node mesh. --- # BGP configuration @@ -42,23 +42,24 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | --------------------------------------------------------- | --------------------------------------------------- | ------ | -| `name` | Unique name to describe this resource instance. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| `name` | Unique name to describe this resource instance. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | - The resource with the name `default` has a specific meaning - this contains the BGP global default configuration. -- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. When deleting a node the BGPConfiguration resource associated with the node will also be deleted. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. +- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. ### Spec | Field | Description | Accepted Values | Schema | Default | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------- | -| `logSeverityScreen` | Global log level | Debug, Info, Warning, Error, Fatal | string | `Info` | -| `nodeToNodeMeshEnabled` | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | string | true | +| `logSeverityScreen` | Global log level | Trace, Debug, Info, Warning, Error, Fatal | string | `Info` | +| `nodeToNodeMeshEnabled` | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | boolean | true | | `asNumber` | The default local AS Number that $[prodname] should use when speaking with BGP peers. Only valid on the global `default` BGPConfiguration; to set a per-node override, use the `bgp` field on the [Node resource](node.mdx). | A valid AS Number, may be specified in dotted notation. | integer/string | 64512 | | `serviceClusterIPs` | The CIDR blocks for Kubernetes Service Cluster IPs to be advertised over BGP. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | `serviceExternalIPs` | The CIDR blocks for Kubernetes Service External IPs to be advertised over BGP. Kubernetes Service External IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | `serviceLoadBalancerIPs` | The CIDR blocks for Kubernetes Service status.LoadBalancer IPs to be advertised over BGP. Kubernetes LoadBalancer IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | +| `serviceLoadBalancerAggregation` | Controls how Kubernetes Service LoadBalancer IPs are advertised. When `Enabled`, $[prodname] advertises the CIDR blocks in `serviceLoadBalancerIPs`. When `Disabled`, it advertises an individual route for each LoadBalancer IP instead. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | Enabled, Disabled | string | Enabled | | `listenPort` | The port where BGP protocol should listen. | A valid port number. | integer | 179 | -| `bindMode` | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is manually restarted. | None, NodeIP. | string | None | +| `bindMode` | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is restarted. With an operator installation, the operator restarts calico-node automatically. | None, NodeIP. | string | None | | `communities` | List of BGP community names and their values, communities are not advertised unless they are used in [prefixAdvertisements](#prefixadvertisements). | | List of [communities](#communities) | | `prefixAdvertisements` | List of per-prefix advertisement properties, like BGP communities. | | List of [prefixAdvertisements](#prefixadvertisements) | | `nodeMeshPassword` | BGP password for the all the peerings in a full mesh configuration. | | [BGPPassword](bgppeer.mdx#bgppassword) | `nil` (no password) | @@ -68,7 +69,7 @@ spec: | `localWorkloadPeeringIPV6` | Single virtual IPv6 address that all nodes will use for peering with local workloads when using `BGPPeer`'s `localWorkloadSelector`. Must _not_ be a link-local address (because $[prodname] doesn't currently support the required "scope" suffix). See the [guide](../../networking/configuring/bgp-to-workload.mdx) for details. | An IPv6 address. | string | None | | `ipv4NormalRoutePriority` | The normal route priority (metric) that Felix uses for IPv4 workload routes. This must match the value configured in FelixConfiguration. BIRD uses this to identify elevated-priority routes during live migration and to override local workload routes with higher-priority BGP-learned routes. | 1-2147483646 | integer | 1024 | | `ipv6NormalRoutePriority` | The normal route priority (metric) that Felix uses for IPv6 workload routes. This must match the value configured in FelixConfiguration. BIRD uses this to identify elevated-priority routes during live migration and to override local workload routes with higher-priority BGP-learned routes. | 1-2147483646 | integer | 1024 | -| `programClusterRoutes` | Controls whether $[prodname] programs cluster routes for IP Pools with VXLAN or IP-in-IP enabled. Felix always programs such routes for IP Pools with `vxlanMode: Always` or `vxlanMode: CrossSubnet`. | Enabled, Disabled | string | Enabled | +| `programClusterRoutes` | Controls whether BIRD programs cluster routes for IP Pools with `vxlanMode: Never`, both IP-in-IP and unencapsulated. Felix always programs such routes for IP Pools with `vxlanMode: Always` or `vxlanMode: CrossSubnet`. | Enabled, Disabled | string | Enabled | ### communities @@ -81,5 +82,5 @@ spec: | Field | Description | Accepted Values | Schema | | ----------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -| `cidr` | CIDR for which properties should be advertised. | `cidr: XXX.XXX.XXX.XXX/XX` | string | +| `cidr` | CIDR for which properties should be advertised. | A valid IPv4 or IPv6 CIDR. | string | | `communities` | BGP communities to be advertised. | Communities can be list of either community names already defined in [communities](#communities) or community value of format `aa:nn` or `aa:nn:mm`.
For standard community, value should be in `aa:nn` format, where both `aa` and `nn` are 16 bit integers.
For large community, value should be `aa:nn:mm` format, where `aa`, `nn` and `mm` are all 32 bit integers.
Where `aa` is an AS Number, `nn` and `mm` are per-AS identifier. | List of string | \ No newline at end of file diff --git a/calico_versioned_docs/version-3.33/reference/resources/bgpconfig.mdx b/calico_versioned_docs/version-3.33/reference/resources/bgpconfig.mdx index 0d8c904e73..a961a32ee5 100644 --- a/calico_versioned_docs/version-3.33/reference/resources/bgpconfig.mdx +++ b/calico_versioned_docs/version-3.33/reference/resources/bgpconfig.mdx @@ -1,5 +1,5 @@ --- -description: Reference for the BGPConfiguration resource in Calico Open Source that sets cluster-wide BGP options including the autonomous system number and route reflectors. +description: Reference for the BGPConfiguration resource in Calico Open Source that sets cluster-wide BGP options including the autonomous system number and the node-to-node mesh. --- # BGP configuration @@ -42,23 +42,24 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | --------------------------------------------------------- | --------------------------------------------------- | ------ | -| `name` | Unique name to describe this resource instance. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| `name` | Unique name to describe this resource instance. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | - The resource with the name `default` has a specific meaning - this contains the BGP global default configuration. -- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. When deleting a node the BGPConfiguration resource associated with the node will also be deleted. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. +- The resources with the name `node.` contain the node-specific overrides, and will be applied to the node ``. Only prefixAdvertisements, listenPort, and logSeverityScreen can be overridden this way. ### Spec | Field | Description | Accepted Values | Schema | Default | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------- | -| `logSeverityScreen` | Global log level | Debug, Info, Warning, Error, Fatal | string | `Info` | -| `nodeToNodeMeshEnabled` | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | string | true | -| `asNumber` | The default local AS Number that $[prodname] should use when speaking with BGP peers. Only valid on the global `default` BGPConfiguration; to set a per-node override, use the `bgp` field on the [Node resource](node.mdx). | A valid AS Number, may be specified in dotted notation. | integer/string | 64512 | +| `logSeverityScreen` | Global log level | Trace, Debug, Info, Warning, Error, Fatal | string | `Info` | +| `nodeToNodeMeshEnabled` | Full BGP node-to-node mesh. Only valid on the global `default` BGPConfiguration. | true, false | boolean | true | +| `asNumber` | The default local AS Number that $[prodname] should use when speaking with BGP peers. Only valid on the global `default` BGPConfiguration; to set a per-node override, use the `bgp` field on the [Node resource](node.mdx). | A valid AS Number. String values, including dotted notation, work through `calicoctl` or the $[prodname] API server, but not with `kubectl` on [native v3 CRDs](../../operations/native-v3-crds.mdx). | integer/string | 64512 | | `serviceClusterIPs` | The CIDR blocks for Kubernetes Service Cluster IPs to be advertised over BGP. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | `serviceExternalIPs` | The CIDR blocks for Kubernetes Service External IPs to be advertised over BGP. Kubernetes Service External IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | | `serviceLoadBalancerIPs` | The CIDR blocks for Kubernetes Service status.LoadBalancer IPs to be advertised over BGP. Kubernetes LoadBalancer IPs will only be advertised if they are within one of these blocks. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | A list of valid IPv4 or IPv6 CIDR blocks. | List of `cidr: /` values. | Empty List | +| `serviceLoadBalancerAggregation` | Controls how Kubernetes Service LoadBalancer IPs are advertised. When `Enabled`, $[prodname] advertises the CIDR blocks in `serviceLoadBalancerIPs`. When `Disabled`, it advertises an individual route for each LoadBalancer IP instead. Only valid on the global `default` BGPConfiguration: will be ignored otherwise. | Enabled, Disabled | string | Enabled | | `listenPort` | The port where BGP protocol should listen. | A valid port number. | integer | 179 | -| `bindMode` | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is manually restarted. | None, NodeIP. | string | None | +| `bindMode` | Indicates whether to listen for BGP connections on all addresses (None) or only on the node's canonical IP address Node.Spec.BGP.IPvXAddress (NodeIP). If this field is changed when calico-node is already running, the change will not take effect until calico-node is restarted. With an operator installation, the operator restarts calico-node automatically. | None, NodeIP. | string | None | | `communities` | List of BGP community names and their values, communities are not advertised unless they are used in [prefixAdvertisements](#prefixadvertisements). | | List of [communities](#communities) | | `prefixAdvertisements` | List of per-prefix advertisement properties, like BGP communities. | | List of [prefixAdvertisements](#prefixadvertisements) | | `nodeMeshPassword` | BGP password for the all the peerings in a full mesh configuration. | | [BGPPassword](bgppeer.mdx#bgppassword) | `nil` (no password) | @@ -68,7 +69,7 @@ spec: | `localWorkloadPeeringIPV6` | Single virtual IPv6 address that all nodes will use for peering with local workloads when using `BGPPeer`'s `localWorkloadSelector`. Must _not_ be a link-local address (because $[prodname] doesn't currently support the required "scope" suffix). See the [guide](../../networking/configuring/bgp-to-workload.mdx) for details. | An IPv6 address. | string | None | | `ipv4NormalRoutePriority` | The normal route priority (metric) that Felix uses for IPv4 workload routes. This must match the value configured in FelixConfiguration. BIRD uses this to identify elevated-priority routes during live migration and to override local workload routes with higher-priority BGP-learned routes. | 1-2147483646 | integer | 1024 | | `ipv6NormalRoutePriority` | The normal route priority (metric) that Felix uses for IPv6 workload routes. This must match the value configured in FelixConfiguration. BIRD uses this to identify elevated-priority routes during live migration and to override local workload routes with higher-priority BGP-learned routes. | 1-2147483646 | integer | 1024 | -| `programClusterRoutes` | Controls whether $[prodname] programs cluster routes for IP Pools with VXLAN or IP-in-IP enabled. Felix always programs such routes for IP Pools with `vxlanMode: Always` or `vxlanMode: CrossSubnet`. | Enabled, Disabled | string | Enabled | +| `programClusterRoutes` | Controls which cluster routes BIRD programs for IP Pools with `vxlanMode: Never`: `Disabled` programs none, `EnabledNoEncapOnly` programs them for unencapsulated IP Pools, `EnabledIPIPOnly` for IP-in-IP IP Pools, and `Enabled` for both. Felix always programs such routes for IP Pools with `vxlanMode: Always` or `vxlanMode: CrossSubnet`. | Enabled, Disabled, EnabledIPIPOnly, EnabledNoEncapOnly | string | EnabledNoEncapOnly | ### communities @@ -81,5 +82,5 @@ spec: | Field | Description | Accepted Values | Schema | | ----------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -| `cidr` | CIDR for which properties should be advertised. | `cidr: XXX.XXX.XXX.XXX/XX` | string | +| `cidr` | CIDR for which properties should be advertised. | A valid IPv4 or IPv6 CIDR. | string | | `communities` | BGP communities to be advertised. | Communities can be list of either community names already defined in [communities](#communities) or community value of format `aa:nn` or `aa:nn:mm`.
For standard community, value should be in `aa:nn` format, where both `aa` and `nn` are 16 bit integers.
For large community, value should be `aa:nn:mm` format, where `aa`, `nn` and `mm` are all 32 bit integers.
Where `aa` is an AS Number, `nn` and `mm` are per-AS identifier. | List of string | \ No newline at end of file