[k8s] kind로 Kubernetes 실습 환경 구성하기

Kind란?

Kind는 로컬 컴퓨터 환경에 쿠버네티스 클러스터를 손쉽고 빠르게 설치하기 위해 만들어진 도구입니다.

Kind는 Go 언어를 기반으로 만들어졌으며, Docker이미지를 기반으로 kubeadm을 이용하여 클러스터를 배포합니다.

자세한 내용은 위 이미지를 통해 kind 공식 홈페이지에서 확인하시면 됩니다.

Kind 설치하기

설치 가이드 원본 URL : https://kind.sigs.k8s.io/docs/user/quick-start/#installation

MacOS

brew install kind

Windows

choco install kind

# 25.08.08 추가
winget install kubernetes.kind

Linux

curl.exe -Lo kind-windows-amd64.exe https://kind.sigs.k8s.io/dl/v0.15.0/kind-windows-amd64
Move-Item .\kind-windows-amd64.exe c:\some-dir-in-your-PATH\kind.exe

Kind로 클러스터 생성

클러스터 생성

kind create cluster # Default cluster context 이름은 'kind' 로 생성
kind create cluster --name lucy # cluster context 이름을 'lucy' 로 지정

클러스터 생성 확인

kind get clusters
kubectl cluster-info --context lucy

클러스터 삭제

kind delete cluster # 클러스터 한 개 삭제

kind delete clusters kind-local-cluster # 클러스터 하나 이상 삭제

설정 파일을 이용한 Kind 클러스터 생성

클러스터 생성

설정 파일을 이용한 클러스터 생성

설정파일을 이용해서 kind 클러스터를 생성할 수 있습니다.

kind create cluster --config kind-example-config.yaml

3개 노드 클러스터 생성

3개 노드(1 controller, 2worker) 클러스터 설정

# three node (two workers) cluster config
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
- role: worker
- role: worker

6개 노드 클러스터 생성

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
- role: control-plane
- role: control-plane
- role: worker
- role: worker
- role: worker

쿠버네티스 버전 설정

쿠버네티스 버전에 따른 이미지는 https://github.com/kubernetes-sigs/kind/releases에서 확인 가능합니다.

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
  image: kindest/node:v1.16.4@sha256:b91a2c2317a000f3a783489dfb755064177dbc3a0b2f4147d50f04825d016f55
- role: worker
  image: kindest/node:v1.16.4@sha256:b91a2c2317a000f3a783489dfb755064177dbc3a0b2f4147d50f04825d016f55

네트워크 설정

• Pod Subnet 설정

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
networking:
  podSubnet: {IP 주소}

기본적으로 IPv4 pod subnet으로 "10.244.0.0/16"을 사용합니다.

• Service Subnet 설정

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
networking:
  serviceSubnet: {IP 주소}

기본적으로 IPv4 pod subnet으로 "10.96.0.0/16"을 사용합니다.

• Default CNI 설정

Calico와 같은 3rd party CNI 사용을 위해서는 default CNI 설치를 하지 말아야 합니다..

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
networking:
  # default CNI가 설치 되지 않는다.
  disableDefaultCNI: true

• kube-proxy 모드 설정

iptables 또는 IPVS 중에 선택해서 사용 가능하고 default 는 iptables입니다.

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
networking:
  kubeProxyMode: "ipvs"

최종 클러스터 생성

• 클러스터 yaml 작성

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
name: cwave-cluster
nodes:
- role: control-plane
  kubeadmConfigPatches:
  - |
    kind: InitConfiguration
    nodeRegistration:
      kubeletExtraArgs:
        node-labels: "ingress-ready=true"
  image: kindest/node:{{쿠버네티스 버전}}
  extraPortMappings:
  - containerPort: 80
    hostPort: 80
    protocol: TCP
  - containerPort: 443
    hostPort: 443
    protocol: TCP
- role: worker
  image: kindest/node:{{쿠버네티스 버전}}
- role: worker
  image: kindest/node:{{쿠버네티스 버전}}
networking:
  serviceSubnet: {IP 주소}
  podSubnet: {IP 주소}

• 클러스터 생성

# 생성
kind create cluster  --config {yaml 파일}

# 삭제
kind delete cluster --name {클러스터 이름}

• 클러스터 접속 정보 확인

kind get kubeconfig --internal --name {클러스터 이름}

클러스터 생성 결과

$ kind create cluster --config .\set-cluster.yaml
Creating cluster "lab-cluster" ...
 • Ensuring node image (kindest/node:v1.31.0) 🖼  ...
 ✓ Ensuring node image (kindest/node:v1.31.0) 🖼
 • Preparing nodes 📦 📦 📦 📦   ...
 ✓ Preparing nodes 📦 📦 📦 📦
 • Writing configuration 📜  ...
 ✓ Writing configuration 📜
 • Starting control-plane 🕹️  ...
 ✓ Starting control-plane 🕹️
 • Installing CNI 🔌  ...
 ✓ Installing CNI 🔌
 • Installing StorageClass 💾  ...
 ✓ Installing StorageClass 💾
 • Joining worker nodes 🚜  ...
 ✓ Joining worker nodes 🚜
Set kubectl context to "kind-lab-cluster"
You can now use your cluster with:

kubectl cluster-info --context kind-lab-cluster

Have a nice day! 👋