Node
A node resource (Node
) represents a node running Calico Enterprise. When adding a host
to a Calico Enterprise cluster, a node resource needs to be created which contains the
configuration for the cnx-node
instance running on the host.
When starting a cnx-node
instance, the name supplied to the instance should
match the name configured in the Node resource.
By default, starting a cnx-node
instance will automatically create a node resource
using the hostname
of the compute host.
This resource is not supported in kubectl
.
Sample YAML​
apiVersion: projectcalico.org/v3
kind: Node
metadata:
name: node-hostname
spec:
bgp:
asNumber: 64512
ipv4Address: 10.244.0.1/24
ipv6Address: 2001:db8:85a3::8a2e:370:7334/120
ipv4IPIPTunnelAddr: 192.168.0.1
Definition​
Metadata​
Field | Description | Accepted Values | Schema |
---|---|---|---|
name | The name of this node. Required. | Alphanumeric string with optional . , _ , or - . | string |
Spec​
Field | Description | Accepted Values | Schema | Default |
---|---|---|---|---|
bgp | BGP configuration for this node. Omit if using Calico Enterprise for policy only. | BGP | ||
ipv4VXLANTunnelAddr | IPv4 address of the VXLAN tunnel. This is system configured and should not be updated manually. | string | ||
ipv6VXLANTunnelAddr | IPv6 address of the VXLAN tunnel. This is system configured and should not be updated manually. | string | ||
vxlanTunnelMACAddr | MAC 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 | ||
wireguard | WireGuard configuration for this node. This is applicable only if WireGuard is enabled in Felix Configuration. | WireGuard |
OrchRef​
Field | Description | Accepted Values | Schema | Default |
---|---|---|---|---|
nodeName | Name of this node according to the orchestrator. | string | ||
orchestrator | Name of the orchestrator. | k8s | string |
BGP​
Field | Description | Accepted Values | Schema | Default |
---|---|---|---|---|
asNumber | The AS Number of your cnx-node . | Optional. If omitted the global value is used (see example modifying Global BGP settings for details about modifying the asNumber setting). | integer | |
ipv4Address | The IPv4 address and subnet exported as the next-hop for the Calico Enterprise endpoints on the host | The IPv4 address must be specified if BGP is enabled. | string | |
ipv6Address | The IPv6 address and subnet exported as the next-hop for the Calico Enterprise endpoints on the host | Optional | string | |
ipv4IPIPTunnelAddr | IPv4 address of the IP-in-IP tunnel. This is system configured and should not be updated manually. | Optional IPv4 address | string | |
routeReflectorClusterID | Enables this node as a route reflector within the given cluster | Optional IPv4 address | string |
WireGuard​
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 |
Supported operations​
Datastore type | Create/Delete | Update | Get/List | Notes |
---|---|---|---|---|
Kubernetes API server | No | Yes | Yes | cnx-node data is directly tied to the Kubernetes nodes. |