본문으로 바로가기 본문 바로가기
WIKI 기술 지식 베이스

calicoctl ipam split

원문 보기 위키 갱신

calicoctl ipam split은 하나의 IP 풀을 지정한 개수의 같은 크기 작은 풀로 쪼개는 명령이에요. 큰 풀을 존(zone)별 또는 노드별 풀로 나눌 때 유용해요. 실행 전에 데이터스토어 락이 필요하다는 점도 이 문서에서 다뤄요.

출처: 문서

본문

이 섹션은 calicoctl ipam split 명령을 설명해요.

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

calicoctl ipam split 명령의 도움말 표시하기

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

Split an IP pool into the given number of smaller pools of equal size. Useful
for carving a large pool into per-zone or per-node pools.

Usage:
  calicoctl ipam split NUMBER [flags]

Examples:
  # Split a pool into 4 smaller pools.
  calicoctl ipam split 4 --name my-pool

Flags:
      --cidr string     CIDR of the IP pool to split.
  -c, --config string   Path to the file containing connection configuration in YAML or JSON format. (default "/etc/calico/calicoctl.cfg")
  -h, --help            help for split
      --name string     Name of the IP pool to split.

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")

사전 요구 사항

IP 풀을 쪼개려면 먼저, 분할 동안 IPAM 데이터가 변경되지 않도록 Calico 데이터베이스를 잠가야 해요. 이는 calicoctl datastore migrate lock 명령으로 수행해요. 분할 후 정상적인 IPAM 동작으로 돌아가려면, calicoctl datastore migrate unlock 명령으로 calico 데이터스토어의 잠금을 해제해야 해요.

예시

Calico 데이터스토어를 잠가요.

calicoctl datastore migrate lock

172.0.0.0/15로 지정된 IP 풀을 2개의 작은 풀로 쪼개요.

calicoctl ipam split --cidr=172.0.0.0/15 2

그러면 CIDR 172.0.0.0/16을 커버하는 풀 하나와 CIDR 172.1.0.0/16을 커버하는 풀 하나, 총 2개의 IP 풀이 만들어져야 해요.

정상적인 IPAM 동작을 복원하기 위해 Calico 데이터스토어의 잠금을 해제해요.

calicoctl datastore migrate unlock

일반 옵션

  -c, --config string   Path to the file containing connection configuration in YAML or JSON format. (default "/etc/calico/calicoctl.cfg")

함께 보기

더 알아보기 (Learn more)

split은 lock → split → unlock 순서로 진행하는 게 필수 절차예요. --cidr 또는 --name으로 대상 풀을 지정하고, 개수만큼 균등한 크기의 풀이 만들어져요.