From c23960199107ff3481e6e8f658fcc03914a1b916 Mon Sep 17 00:00:00 2001 From: Chris Tauchen Date: Tue, 20 Oct 2026 07:55:32 +0100 Subject: [PATCH 1/4] Fix inaccuracies on the Node reference for next Correct statements on the Node page that a kind cluster running the release showed to be wrong. --- calico/reference/resources/node.mdx | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/calico/reference/resources/node.mdx b/calico/reference/resources/node.mdx index 826f4c8811..f9d2eefa57 100644 --- a/calico/reference/resources/node.mdx +++ b/calico/reference/resources/node.mdx @@ -4,15 +4,16 @@ description: Reference for the Node resource in Calico Open Source that represen # Node -A node resource (`Node`) represents a node running $[prodname]. When adding a host -to a $[prodname] cluster, a node resource needs to be created which contains the +A node resource (`Node`) represents a node running $[prodname]. Each host +in a $[prodname] cluster has a node resource which contains the configuration for the `$[nodecontainer]` instance running on the host. When starting a `$[nodecontainer]` instance, the name supplied to the instance should match the name configured in the Node resource. By default, starting a `$[nodecontainer]` instance will automatically create a node resource -using the `hostname` of the compute host. +using the `hostname` of the compute host. With the Kubernetes API datastore, the node resource is instead +the Kubernetes node of the same name, and you cannot create a node resource with `calicoctl`. ## Sample YAML @@ -35,7 +36,7 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | -------------------------------- | --------------------------------------------------- | ------ | -| name | The name of this node. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| name | The name of this node. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | ### Spec @@ -43,11 +44,13 @@ spec: | -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------- | ------- | | bgp | BGP configuration for this node. Omit if using $[prodname] for policy only. | | [BGP](#bgp) | | ipv4VXLANTunnelAddr | IPv4 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | -| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. This is system configured and should not be updated manually. | | string | +| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. If not set, Felix generates the MAC address from the node name. | | string | | ipv6VXLANTunnelAddr | IPv6 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | | vxlanTunnelMACAddrV6 | MAC address of the IPv6 VXLAN tunnel. This is system configured and should not be updated manually. | | string | | orchRefs | Correlates this node to a node in another orchestrator. | | list of [OrchRefs](#orchref) | | wireguard | WireGuard configuration for this node. This is applicable only if WireGuard is enabled in [Felix Configuration](felixconfig.mdx). | | [WireGuard](#wireguard) | +| addresses | Addresses at which the node can be reached. With the Kubernetes API datastore, this is system configured and should not be updated manually. | | list | +| interfaces | Interfaces on the node and their addresses. This is system configured and should not be updated manually. | | list | ### OrchRef @@ -70,5 +73,5 @@ spec: | Field | Description | Accepted Values | Schema | Default | | -------------------- | ----------------------------------------------------------------------------------------- | --------------- | ------ | ------- | -| interfaceIPv4Address | The IP address and subnet for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | -| interfaceIPv6Address | The IP address and subnet for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file +| interfaceIPv4Address | The IP address for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | +| interfaceIPv6Address | The IP address for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file From 218e387352d48b04bfb7e1ef04d87fd965c2e9c3 Mon Sep 17 00:00:00 2001 From: Chris Tauchen Date: Tue, 20 Oct 2026 07:55:32 +0100 Subject: [PATCH 2/4] Fix inaccuracies on the Node reference for 3.33 Correct statements on the Node page that a kind cluster running the release showed to be wrong. --- .../version-3.33/reference/resources/node.mdx | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/calico_versioned_docs/version-3.33/reference/resources/node.mdx b/calico_versioned_docs/version-3.33/reference/resources/node.mdx index 826f4c8811..f9d2eefa57 100644 --- a/calico_versioned_docs/version-3.33/reference/resources/node.mdx +++ b/calico_versioned_docs/version-3.33/reference/resources/node.mdx @@ -4,15 +4,16 @@ description: Reference for the Node resource in Calico Open Source that represen # Node -A node resource (`Node`) represents a node running $[prodname]. When adding a host -to a $[prodname] cluster, a node resource needs to be created which contains the +A node resource (`Node`) represents a node running $[prodname]. Each host +in a $[prodname] cluster has a node resource which contains the configuration for the `$[nodecontainer]` instance running on the host. When starting a `$[nodecontainer]` instance, the name supplied to the instance should match the name configured in the Node resource. By default, starting a `$[nodecontainer]` instance will automatically create a node resource -using the `hostname` of the compute host. +using the `hostname` of the compute host. With the Kubernetes API datastore, the node resource is instead +the Kubernetes node of the same name, and you cannot create a node resource with `calicoctl`. ## Sample YAML @@ -35,7 +36,7 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | -------------------------------- | --------------------------------------------------- | ------ | -| name | The name of this node. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| name | The name of this node. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | ### Spec @@ -43,11 +44,13 @@ spec: | -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------- | ------- | | bgp | BGP configuration for this node. Omit if using $[prodname] for policy only. | | [BGP](#bgp) | | ipv4VXLANTunnelAddr | IPv4 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | -| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. This is system configured and should not be updated manually. | | string | +| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. If not set, Felix generates the MAC address from the node name. | | string | | ipv6VXLANTunnelAddr | IPv6 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | | vxlanTunnelMACAddrV6 | MAC address of the IPv6 VXLAN tunnel. This is system configured and should not be updated manually. | | string | | orchRefs | Correlates this node to a node in another orchestrator. | | list of [OrchRefs](#orchref) | | wireguard | WireGuard configuration for this node. This is applicable only if WireGuard is enabled in [Felix Configuration](felixconfig.mdx). | | [WireGuard](#wireguard) | +| addresses | Addresses at which the node can be reached. With the Kubernetes API datastore, this is system configured and should not be updated manually. | | list | +| interfaces | Interfaces on the node and their addresses. This is system configured and should not be updated manually. | | list | ### OrchRef @@ -70,5 +73,5 @@ spec: | Field | Description | Accepted Values | Schema | Default | | -------------------- | ----------------------------------------------------------------------------------------- | --------------- | ------ | ------- | -| interfaceIPv4Address | The IP address and subnet for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | -| interfaceIPv6Address | The IP address and subnet for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file +| interfaceIPv4Address | The IP address for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | +| interfaceIPv6Address | The IP address for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file From c8eb0b9ca41055a3e498baec3e80a1e76bc7b78b Mon Sep 17 00:00:00 2001 From: Chris Tauchen Date: Tue, 20 Oct 2026 07:55:32 +0100 Subject: [PATCH 3/4] Fix inaccuracies on the Node reference for 3.32 Correct statements on the Node page that a kind cluster running the release showed to be wrong. --- .../version-3.32/reference/resources/node.mdx | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/calico_versioned_docs/version-3.32/reference/resources/node.mdx b/calico_versioned_docs/version-3.32/reference/resources/node.mdx index 826f4c8811..f9d2eefa57 100644 --- a/calico_versioned_docs/version-3.32/reference/resources/node.mdx +++ b/calico_versioned_docs/version-3.32/reference/resources/node.mdx @@ -4,15 +4,16 @@ description: Reference for the Node resource in Calico Open Source that represen # Node -A node resource (`Node`) represents a node running $[prodname]. When adding a host -to a $[prodname] cluster, a node resource needs to be created which contains the +A node resource (`Node`) represents a node running $[prodname]. Each host +in a $[prodname] cluster has a node resource which contains the configuration for the `$[nodecontainer]` instance running on the host. When starting a `$[nodecontainer]` instance, the name supplied to the instance should match the name configured in the Node resource. By default, starting a `$[nodecontainer]` instance will automatically create a node resource -using the `hostname` of the compute host. +using the `hostname` of the compute host. With the Kubernetes API datastore, the node resource is instead +the Kubernetes node of the same name, and you cannot create a node resource with `calicoctl`. ## Sample YAML @@ -35,7 +36,7 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | -------------------------------- | --------------------------------------------------- | ------ | -| name | The name of this node. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| name | The name of this node. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | ### Spec @@ -43,11 +44,13 @@ spec: | -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------- | ------- | | bgp | BGP configuration for this node. Omit if using $[prodname] for policy only. | | [BGP](#bgp) | | ipv4VXLANTunnelAddr | IPv4 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | -| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. This is system configured and should not be updated manually. | | string | +| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. If not set, Felix generates the MAC address from the node name. | | string | | ipv6VXLANTunnelAddr | IPv6 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | | vxlanTunnelMACAddrV6 | MAC address of the IPv6 VXLAN tunnel. This is system configured and should not be updated manually. | | string | | orchRefs | Correlates this node to a node in another orchestrator. | | list of [OrchRefs](#orchref) | | wireguard | WireGuard configuration for this node. This is applicable only if WireGuard is enabled in [Felix Configuration](felixconfig.mdx). | | [WireGuard](#wireguard) | +| addresses | Addresses at which the node can be reached. With the Kubernetes API datastore, this is system configured and should not be updated manually. | | list | +| interfaces | Interfaces on the node and their addresses. This is system configured and should not be updated manually. | | list | ### OrchRef @@ -70,5 +73,5 @@ spec: | Field | Description | Accepted Values | Schema | Default | | -------------------- | ----------------------------------------------------------------------------------------- | --------------- | ------ | ------- | -| interfaceIPv4Address | The IP address and subnet for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | -| interfaceIPv6Address | The IP address and subnet for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file +| interfaceIPv4Address | The IP address for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | +| interfaceIPv6Address | The IP address for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file From f45e310e2d6c726e1bcb9c11d9603717f8140ffe Mon Sep 17 00:00:00 2001 From: Chris Tauchen Date: Tue, 20 Oct 2026 07:55:32 +0100 Subject: [PATCH 4/4] Fix inaccuracies on the Node reference for 3.31 Correct statements on the Node page that a kind cluster running the release showed to be wrong. --- .../version-3.31/reference/resources/node.mdx | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/calico_versioned_docs/version-3.31/reference/resources/node.mdx b/calico_versioned_docs/version-3.31/reference/resources/node.mdx index 8b41cce574..04f7acf591 100644 --- a/calico_versioned_docs/version-3.31/reference/resources/node.mdx +++ b/calico_versioned_docs/version-3.31/reference/resources/node.mdx @@ -4,15 +4,16 @@ description: API for this Calico resource. # Node -A node resource (`Node`) represents a node running $[prodname]. When adding a host -to a $[prodname] cluster, a node resource needs to be created which contains the +A node resource (`Node`) represents a node running $[prodname]. Each host +in a $[prodname] cluster has a node resource which contains the configuration for the `$[nodecontainer]` instance running on the host. When starting a `$[nodecontainer]` instance, the name supplied to the instance should match the name configured in the Node resource. By default, starting a `$[nodecontainer]` instance will automatically create a node resource -using the `hostname` of the compute host. +using the `hostname` of the compute host. With the Kubernetes API datastore, the node resource is instead +the Kubernetes node of the same name, and you cannot create a node resource with `calicoctl`. ## Sample YAML @@ -35,7 +36,7 @@ spec: | Field | Description | Accepted Values | Schema | | ----- | -------------------------------- | --------------------------------------------------- | ------ | -| name | The name of this node. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | +| name | The name of this node. Required. | Lowercase alphanumeric string with optional `.` or `-`. | string | ### Spec @@ -43,11 +44,13 @@ spec: | -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------- | ------- | | bgp | BGP configuration for this node. Omit if using $[prodname] for policy only. | | [BGP](#bgp) | | ipv4VXLANTunnelAddr | IPv4 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | -| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. This is system configured and should not be updated manually. | | string | +| vxlanTunnelMACAddr | MAC address of the IPv4 VXLAN tunnel. If not set, Felix generates the MAC address from the node name. | | string | | ipv6VXLANTunnelAddr | IPv6 address of the VXLAN tunnel. This is system configured and should not be updated manually. | | string | | vxlanTunnelMACAddrV6 | MAC address of the IPv6 VXLAN tunnel. This is system configured and should not be updated manually. | | string | | orchRefs | Correlates this node to a node in another orchestrator. | | list of [OrchRefs](#orchref) | | wireguard | WireGuard configuration for this node. This is applicable only if WireGuard is enabled in [Felix Configuration](felixconfig.mdx). | | [WireGuard](#wireguard) | +| addresses | Addresses at which the node can be reached. With the Kubernetes API datastore, this is system configured and should not be updated manually. | | list | +| interfaces | Interfaces on the node and their addresses. This is system configured and should not be updated manually. | | list | ### OrchRef @@ -70,5 +73,5 @@ spec: | Field | Description | Accepted Values | Schema | Default | | -------------------- | ----------------------------------------------------------------------------------------- | --------------- | ------ | ------- | -| interfaceIPv4Address | The IP address and subnet for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | -| interfaceIPv6Address | The IP address and subnet for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file +| interfaceIPv4Address | The IP address for the IPv4 WireGuard interface created by Felix on this node. | Optional | string | +| interfaceIPv6Address | The IP address for the IPv6 WireGuard interface created by Felix on this node. | Optional | string | \ No newline at end of file