Node

A node resource (Node) represents a node running Calico. Each host in a Calico cluster has a node resource which contains the configuration for the calico/node instance running on the host.

When starting a calico/node instance, the name supplied to the instance should match the name configured in the Node resource.

By default, starting a calico/node instance will automatically create a node resource 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

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.	Lowercase alphanumeric string with optional . or -.	string

Spec

Field	Description	Accepted Values	Schema	Default
bgp	BGP configuration for this node. Omit if using Calico for policy only.		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. 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
wireguard	WireGuard configuration for this node. This is applicable only if WireGuard is enabled in Felix Configuration.		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

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 calico/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 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 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 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