Calico 노드 상태

Calico 노드 상태 (Calico node status)

CalicoNodeStatus 리소스는 노드별 상태 정보를 보고해 주는 리소스로, 문제를 해결할 때 활용할 수 있어요. 검사하려는 노드에 대해 CalicoNodeStatus 리소스를 만들면 Calico가 주기적으로 수집한 정보를 리소스의 status 필드에 기록해 줘요. BGP 에이전트, BGP 세션, BGP 에이전트에 노출된 라우트 상태는 Linux 노드에서만 수집되며, 현재는 Windows 노드를 지원하지 않아요. 이 리소스는 Calico BGP 네트워킹을 사용 중일 때만 유효해요.

출처: 문서

본문

주의 사항 (Notes)

CalicoNodeStatus를 업데이트하면 노드의 CPU와 메모리 사용량에 약간의 성능 영향이 있고, Kubernetes API 서버에도 부하를 더해요.

10노드 풀 메시(full mesh) 클러스터에서 테스트한 결과, 업데이트 주기를 10초로 설정해 각 노드에 CalicoNodeStatus 리소스를 하나씩 만들었을 때 노드마다 CPU 사용량이 vCPU의 5%씩, 메모리는 4MB씩 늘어났어요. 컨트롤 플레인 노드에서는 이 10개 노드 때문에 CPU 사용량이 vCPU의 5% 증가했어요.

경고 (WARNING): CalicoNodeStatus 구현은 소수의 노드(10개 미만 권장)가 같은 시점에 상태를 보고하는 상황을 다루도록 설계됐어요. 많은 노드에 짧은 업데이트 주기로 CalicoNodeStatus를 만들면 Kubernetes API 서버가 느려지고 반응성이 떨어질 수 있어요. 따라서 관심 있는 노드에만, 디버깅 목적으로만 CalicoNodeStatus를 만들어야 해요. 디버깅이 끝나면 CalicoNodeStatus 리소스는 반드시 삭제하세요.

샘플 YAML

이 기능을 사용하려면 노드에 대해 CalicoNodeStatus 객체를 만들면서 수집할 정보와 수집 주기를 지정하면 돼요. 다음 예제는 노드 "my-kadm-node-0"에 대해 업데이트 주기 10초로 정보를 수집하는 예시예요.

kubectl apply -f -<<EOF
apiVersion: projectcalico.org/v3
kind: CalicoNodeStatus
metadata:
  name: my-caliconodestatus-1
spec:
  classes:
    - Agent
    - BGP
    - Routes
  node: my-kadm-node-0
  updatePeriodSeconds: 10
EOF

그다음 kubectl get caliconodestatus my-caliconodestatus-1 -o yaml 명령으로 같은 리소스를 다시 읽으면, 수집된 정보를 status 필드에서 확인할 수 있어요. 예를 들면 다음과 같아요.

apiVersion: projectcalico.org/v3
kind: CalicoNodeStatus
metadata:
  annotations:
    kubectl.kubernetes.io/last-applied-configuration: |
      {"apiVersion":"crd.projectcalico.org/v1","kind":"CalicoNodeStatus","metadata":{"annotations":{},"name":"my-caliconodestatus-1"},"spec":{"classes":["Agent","BGP","Routes"],"node":"my-kadm-node-0","updatePeriodSeconds":10}}
    projectcalico.org/metadata: '{"uid":"6e3b676b-546a-41db-aeda-ad44f25ff73f","generation":2,"creationTimestamp":"2021-10-18T10:30:43Z","managedFields":[{"manager":"kubectl-client-side-apply","operation":"Update","apiVersion":"projectcalico.org/v3","time":"2021-10-18T10:30:43Z","fieldsType":"FieldsV1","fieldsV1":{"f:metadata":{"f:annotations":{".":{},"f:kubectl.kubernetes.io/last-applied-configuration":{}}},"f:spec":{".":{},"f:node":{},"f:updatePeriodSeconds":{}}}},{"manager":"kubectl-edit","operation":"Update","apiVersion":"crd.projectcalico.org/v1","time":"2021-10-18T12:59:25Z","fieldsType":"FieldsV1","fieldsV1":{"f:spec":{"f:classes":{}}}}]}'
  creationTimestamp: '2021-10-18T10:30:43Z'
  generation: 139
  name: my-caliconodestatus-1
  resourceVersion: '203255'
  uid: 6e3b676b-546a-41db-aeda-ad44f25ff73f
spec:
  classes:
    - Agent
    - BGP
    - Routes
  node: my-kadm-node-0
  updatePeriodSeconds: 10
status:
  agent:
    birdV4:
      lastBootTime: '2021-10-18 09:23:19'
      lastReconfigurationTime: '2021-10-18 09:23:19'
      routerID: 10.128.0.240
      state: Ready
      version: v0.3.3+birdv1.6.8
    birdV6:
      lastBootTime: '2021-10-18 09:23:19'
      lastReconfigurationTime: '2021-10-18 09:23:19'
      routerID: 10.128.0.240
      state: Ready
      version: v0.3.3+birdv1.6.8
  bgp:
    numberEstablishedV4: 2
    numberEstablishedV6: 0
    numberNotEstablishedV4: 1
    numberNotEstablishedV6: 0
    peersV4:
      - peerIP: 10.128.0.242
        since: '09:23:22'
        state: Established
        type: NodeMesh
      - peerIP: 10.128.0.200
        since: '09:23:21'
        state: Established
        type: NodeMesh
      - peerIP: 10.128.0.241
        since: '09:23:22'
        state: OpenSent
        type: NodeMesh
  lastUpdated: '2021-10-18T13:22:03Z'
  routes:
    routesV4:
      - destination: 0.0.0.0/0
        gateway: 172.18.0.1
        interface: eth0
        learnedFrom:
          sourceType: Kernel
        type: FIB
      - destination: 192.168.82.0/26
        gateway: 10.128.0.200
        interface: eth0
        learnedFrom:
          peerIP: 10.128.0.200
          sourceType: NodeMesh
        type: FIB
      - destination: 192.168.36.0/26
        gateway: 10.128.0.242
        interface: eth0
        learnedFrom:
          peerIP: 10.128.0.242
          sourceType: NodeMesh
        type: FIB
      - destination: 10.128.0.5/16
        gateway: N/A
        interface: eth0
        learnedFrom:
          sourceType: Direct
        type: FIB

Calico 노드 상태 정의

메타데이터 (Metadata)

스펙 (Spec)

상태 (Status)

클래스 (Classes)

BGPDaemonStatus

BGPStatus

RouteStatus

BGPPeer

Route

LearnedFrom

더 알아보기 (Learn more)

CalicoNodeStatus는 BGP 문제를 디버깅할 때 노드 상태를 한눈에 보게 해주는 진단용 리소스예요. 소수의 노드에만, 짧지 않은 업데이트 주기로 사용하고 디버깅이 끝나면 삭제하는 것이 좋아요. Windows 노드에서는 지원되지 않는다는 점도 기억해 두세요.