Rancher Kubernetes Engine 클러스터의 Windows용 Calico

원문 보기 위키 갱신 2026.10.11

Rancher Kubernetes Engine(RKE) 클러스터에 Windows용 Calico를 설치하는 방법을 안내해 드릴게요. 네트워크 플러그인 없이 프로비저닝된 RKE 클러스터에 Calico를 먼저 설치하고, Windows 노드에 Windows용 Calico를 얹는 순서로 진행해요. VXLAN과 BGP 두 가지 네트워킹 예시 설정까지 함께 살펴볼게요.

출처: 문서

본문

전체 그림

Rancher Kubernetes Engine(RKE) 클러스터에 Windows용 Calico를 설치해요.

값얻기

Calico와 함께 RKE 클러스터에서 Linux와 Windows 워크로드를 실행해요.

시작하기 전에

지원됨

RKE Kubernetes 1.20, 1.19, 또는 1.18

지원되는 네트워킹

캡슐화 없는 BGP
VXLAN

필요한 것

네트워크 플러그인 없음으로 프로비저닝되고, 그 외에는 Windows용 Calico Kubernetes 클러스터 요구사항을 충족하는 RKE 클러스터. 이 가이드는 RKE v1.18.9로 테스트했어요.
요구사항을 충족하는 하나 이상의 Windows 노드.

방법

다음 단계에서는 RKE 클러스터에 Calico 네트워킹을 설치한 다음, Windows 노드에 Windows용 Calico를 설치하는 과정을 살펴봐요.

Calico 커스텀 리소스 정의를 설치해요.

클러스터가 Kubernetes 1.36 이상 기반이라면:

kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/v3_projectcalico_org.yaml

클러스터가 Kubernetes 1.34 또는 1.35 기반이라면:

kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/v3_projectcalico_org-v1beta1.yaml

Tigera Operator를 설치해요.

kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/tigera-operator.yaml

필요한 Installation 커스텀 리소스를 내려받아요.

wget https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/custom-resources.yaml

calicoNetwork 옵션을 갱신하고 올바른 pod CIDR이 설정됐는지 확인해요. (Rancher는 기본값으로 10.42.0.0/16을 사용해요.) 다음은 기본 Rancher pod CIDR을 사용하는 VXLAN과 BGP 네트워킹 설치 예시예요:

VXLAN

apiVersion: operator.tigera.io/v1
kind: Installation
metadata:
  name: default
spec:
   # Configures Calico networking.
  calicoNetwork:
    bgp: Disabled
    ipPools:
    - blockSize: 26
      cidr: 10.42.0.0/16
      encapsulation: VXLAN
      natOutgoing: Enabled
      nodeSelector: all()

BGP

apiVersion: operator.tigera.io/v1
kind: Installation
metadata:
  name: default
spec:
   # Configures Calico networking.
  calicoNetwork:
    ipPools:
    - blockSize: 26
      cidr: 10.42.0.0/16
      encapsulation: None
      natOutgoing: Enabled
      nodeSelector: all()

SECONDARY: 이 매니페스트에서 사용할 수 있는 구성 옵션에 대한 자세한 내용은 Tigera Operator API 레퍼런스를 참고하세요.

갱신한 커스텀 리소스를 적용해요:
```
kubectl create -f custom-resources.yaml
```

strict affinity를 구성해요:

kubectl patch ipamconfigurations default --type merge --patch='{"spec": {"strictAffinity": true}}'

마지막으로 Windows용 Calico를 설치해요. operator 설치라면 operator 가이드를 따르세요. VXLAN 클러스터라면 "Kubernetes VXLAN" 탭의 지침을, BGP 클러스터라면 "Kubernetes BGP" 탭의 지침을 따르면 돼요.

SECONDARY: 서비스 CIDR과 DNS 클러스터 IP의 Rancher 기본값은 Rancher kube-api 서비스 옵션을 참고하세요.
kubectl get nodes로 노드 상태를 확인해요. Windows 노드 상태가 Ready로 보이면 Linux와 Windows 워크로드를 띄울 준비가 된 RKE 클러스터용 Windows용 Calico가 완성된 거예요!

다음 단계

더 알아보기 (Learn more)

핵심 순서는 CRD 설치 → Tigera Operator → 커스텀 리소스 → strict affinity → Windows용 Calico예요. 클러스터 Kubernetes 버전에 따라 CRD 매니페스트 파일이 달라진다는 점만 유의하세요.