Node
Node 리소스(Node)는 Calico가 실행 중인 노드를 나타내요. 호스트를 Calico 클러스터에 추가할 때는 그 호스트에서 실행되는 calico/node 인스턴스의 구성을 담은 노드 리소스를 만들어야 해요. 이 문서는 Node 리소스의 구조와 필드를 참조 형식으로 정리한 레퍼런스예요.
출처: 문서
본문
노드 리소스(Node)는 Calico가 실행 중인 노드를 나타내요. Calico 클러스터에 호스트를 추가할 때는, 그 호스트에서 실행되는 calico/node 인스턴스의 구성을 담은 노드 리소스를 만들어야 해요.
calico/node 인스턴스를 시작할 때, 인스턴스에 제공하는 이름은 Node 리소스에 구성된 이름과 일치해야 해요.
기본적으로 calico/node 인스턴스를 시작하면 컴퓨트 호스트의 hostname을 사용해서 노드 리소스가 자동으로 만들어져요.
샘플 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
정의
메타데이터 (Metadata)
| 필드 | 설명 | 허용 값 | 스키마 |
|---|---|---|---|
| name | 이 노드의 이름이에요. 필수예요. | ., _, -를 선택적으로 포함하는 영숫자 문자열 |
string |
스펙 (Spec)
| 필드 | 설명 | 허용 값 | 스키마 | 기본값 |
|---|---|---|---|---|
| bgp | 이 노드의 BGP 구성이에요. Calico를 정책 전용으로 사용한다면 생략하세요. | BGP | ||
| ipv4VXLANTunnelAddr | VXLAN 터널의 IPv4 주소예요. 시스템이 구성하는 값이라 수동으로 업데이트하면 안 돼요. | string | ||
| vxlanTunnelMACAddr | IPv4 VXLAN 터널의 MAC 주소예요. 시스템이 구성하는 값이라 수동으로 업데이트하면 안 돼요. | string | ||
| ipv6VXLANTunnelAddr | VXLAN 터널의 IPv6 주소예요. 시스템이 구성하는 값이라 수동으로 업데이트하면 안 돼요. | string | ||
| vxlanTunnelMACAddrV6 | IPv6 VXLAN 터널의 MAC 주소예요. 시스템이 구성하는 값이라 수동으로 업데이트하면 안 돼요. | string | ||
| orchRefs | 이 노드를 다른 오케스트레이터의 노드와 연결(상관 관계)해요. | OrchRefs 목록 | ||
| wireguard | 이 노드의 WireGuard 구성이에요. Felix 구성에서 WireGuard가 활성화된 경우에만 적용돼요. | WireGuard |
OrchRef
| 필드 | 설명 | 허용 값 | 스키마 | 기본값 |
|---|---|---|---|---|
| nodeName | 오케스트레이터 관점에서 이 노드의 이름이에요. | string | ||
| orchestrator | 오케스트레이터의 이름이에요. | k8s | string |
BGP
| 필드 | 설명 | 허용 값 | 스키마 | 기본값 |
|---|---|---|---|---|
| asNumber | 여러분의 calico/node의 AS Number예요. |
선택 사항이에요. 생략하면 전역 값이 사용돼요 (asNumber 설정을 수정하는 방법은 전역 BGP 설정 수정 예시를 참고하세요). |
integer | |
| ipv4Address | 호스트에 있는 Calico 엔드포인트의 다음 홉(next-hop)으로 내보낼 IPv4 주소와 서브넷이에요 | BGP가 활성화되어 있다면 IPv4 주소를 반드시 지정해야 해요. | string | |
| ipv6Address | 호스트에 있는 Calico 엔드포인트의 다음 홉(next-hop)으로 내보낼 IPv6 주소와 서브넷이에요 | 선택 사항 | string | |
| ipv4IPIPTunnelAddr | IP-in-IP 터널의 IPv4 주소예요. 시스템이 구성하는 값이라 수동으로 업데이트하면 안 돼요. | 선택적인 IPv4 주소 | string | |
| routeReflectorClusterID | 주어진 클러스터 안에서 이 노드를 라우트 리플렉터로 동작하게 해요 | 선택적인 IPv4 주소 | string |
WireGuard
| 필드 | 설명 | 허용 값 | 스키마 | 기본값 |
|---|---|---|---|---|
| interfaceIPv4Address | 이 노드에서 Felix가 만드는 IPv4 WireGuard 인터페이스의 IP 주소와 서브넷이에요. | 선택 사항 | string | |
| interfaceIPv6Address | 이 노드에서 Felix가 만드는 IPv6 WireGuard 인터페이스의 IP 주소와 서브넷이에요. | 선택 사항 | string |
더 알아보기 (Learn more)
Node 리소스는 calico/node 인스턴스의 이름과 BGP·WireGuard 설정이 만나는 지점이에요. VXLAN 터널 주소·MAC은 시스템이 관리하니 절대 손으로 고치지 마세요. 노드별 AS 번호나 BGP 주소가 필요하면 BGP 섹션의 필드를 활용하세요.