Kubernetes 클러스터 변경 시 kubeconfig 재설정 방법 (Windows 11)

Kubernetes 클러스터를 재구성하거나
컨트롤플레인 IP, API Server 정보, 인증서가 변경되면
기존 kubectl 설정으로는 더 이상 클러스터에 접속할 수 없다.

이때 가장 간단하고 일반적인 해결 방법은
기존 kubeconfig를 백업하고, 새 클러스터의 admin.conf를 기본 kubeconfig로 교체하는 것이다.

---

1. admin.conf 준비

신규 클러스터의 컨트롤플레인 노드에는
관리자용 kubeconfig 파일이 다음 경로에 있다.

/etc/kubernetes/admin.conf

이 파일을 Windows 11 PC로 복사한다.

scp root@<CONTROL_PLANE_IP>:/etc/kubernetes/admin.conf C:\Users\<사용자>\Downloads\admin.conf

---

2. 기존 kubeconfig 백업

Windows 11에서 kubectl은 기본적으로 아래 파일을 사용한다.

C:\Users\<사용자>\.kube\config

기존 설정을 유지하기 위해 파일명을 변경하여 백업한다.

cd $HOME\.kube
rename config config.old

(파일 탐색기에서 이름만 바꿔도 동일)

---

3. 새 클러스터 설정 적용

다운받은 admin.conf 파일을 config라는 이름으로 변경하여
.kube 디렉토리에 복사한다.

copy C:\Users\<사용자>\Downloads\admin.conf $HOME\.kube\config

이제 kubectl은 자동으로 신규 클러스터를 사용한다.

---

4. 접속 확인

kubectl cluster-info
kubectl get nodes

정상적으로 노드 정보가 출력되면 설정 완료이다.

---

5. 이 방법이 가장 많이 쓰이는 이유

• 멀티 클러스터 설정 불필요
• 설정 과정 단순
• Windows 환경에서 직관적
• 문제 발생 시 복구 쉬움

기존 클러스터를 더 이상 사용하지 않는 환경에서는
이 방식이 가장 현실적인 선택이다.

---

6. 이전 설정으로 되돌리는 방법

필요 시 파일 이름만 다시 바꾸면 된다.

cd $HOME\.kube
rename config config.new
rename config.old config

---

핵심 요약

• 클러스터 변경 후 기존 kubeconfig 재사용은 위험
• admin.conf를 기본 kubeconfig(config)로 교체
• 기존 파일은 config.old로 백업
• Windows 11에서는 가장 빠르고 안정적인 방법