calicoctl node checksystem

원문 보기 위키 갱신 2026.10.11

calicoctl node checksystem 명령어는 호스트가 Calico node 인스턴스를 실행할 시스템 요건을 충족하는지 검증해요. 커널 버전과 필요한 모듈을 단계별로 점검합니다. 이 문서는 명령어의 도움말, 절차, 예제를 소개해요.

출처: 문서

본문

이 섹션은 calicoctl node checksystem 명령어를 설명합니다.

calicoctl 명령어 전체 목록은 calicoctl 개요를 읽어보세요.

'calicoctl node checksystem' 명령어 도움말 표시하기

calicoctl node checksystem --help를 실행하면 명령어의 다음 도움말 메뉴가 표시돼요.

Verify that this host meets the system requirements to run a Calico node instance.

Usage:
  calicoctl node checksystem [flags]

Examples:
  calicoctl node checksystem

Flags:
  -h, --help                   help for checksystem
  -f, --kernel-config string   Override the Kernel config file location.

Global Flags:
      --allow-version-mismatch   Allow client and cluster versions mismatch
      --context string           The name of the kubeconfig context to use
  -l, --log-level string         Set the log level (panic, fatal, error, warn, info, debug) (default "panic")

절차

다음은 calicoctl이 시스템에서 어떤 모듈을 사용할 수 있는지 파악하기 위해 수행하는 단계들이에요.

calicoctl이 커널 버전을 확인합니다.
lsmod를 실행해 어떤 모듈이 활성화되어 있는지 파악하려고 시도해요.
2단계에서 매칭되지 않은 모듈은 /lib/modules/<YOUR_KERNEL_VERSION>/modules.dep 파일과 대조됩니다.
2단계와 3단계에서 매칭되지 않은 모듈은 /lib/modules/<YOUR_KERNEL_VERSION>/modules.builtin 파일과 대조돼요.
앞선 단계에서 매칭되지 않은 모듈은 kernelconfig 파일인 /usr/src/linux/.config와 대조됩니다.
남은 모듈은 /proc/net/ip_tables_matches의 로드된 iptables 모듈과 대조돼요.

예제

calicoctl node checksystem

응답 예제는 다음과 같아요.

xt_conntrack                                            OK
xt_u32                                                  OK
WARNING: Unable to detect the xt_set module. Load with `modprobe xt_set`
WARNING: Unable to detect the ipip module. Load with `modprobe ipip`

--kernel-config 인자로 kernel-config 파일을 재정의할 수도 있어요. 이 경우 calicoctl은 지정된 파일을 기준으로 모듈을 확인하고 기본 위치는 건너뜁니다.

calicoctl node checksystem --kernel-config /root/MYKERNELFILE

더 알아보기 (Learn more)

checksystem은 커널 모듈(xt_set, ipip 등) 누락을 미리 잡아주는 사전 점검 도구예요. WARNING이 나오면 안내된 modprobe 명령으로 모듈을 로드하세요.