기본 Service IP 범위 재구성하기
기본 Service IP 범위 재구성하기 (Reconfigure Default Service IP Ranges)
기능 상태: Kubernetes v1.29부터 Stable.
이 기능은 쿠버네티스에서 안정적이며 v1.29 버전부터 그래왔어요. v1.27 릴리스에서 처음 사용할 수 있었어요. 더 이상 이 기능이나 동작을 비활성화하거나 선택 해제할 수 없어요(잠겨 있음). 연관된 기능 게이트 MultiCIDRServiceAllocator에 값을 명시적으로 설정하면 쿠버네티스는 그것을 무시하지만 오류는 보고하지 않아요.
이 문서는 클러스터의 기존 Service IP 범위를 변경하는 방법을 공유해요.
출처: 문서
본문
시작하기 전에 (Before you begin)
- 관리자 권한이 필요하고,
kube-apiserver와kube-controller-manager가 실행 중인 컨트롤 플레인 호스트에 접근할 수 있어야 해요. - 쿠버네티스 서버가 최소 v1.29 버전이어야 해요.
동기 (Motivation)
기본 ServiceCIDR은 kube-apiserver의 --service-cluster-ip-range 플래그로 설정돼요. 기본 ServiceCIDR은 관리할 수 없는 상태(immutable)이며, 다른 ServiceCIDR을 교체할 수 없어요.
클러스터를 운영하다 보면 다음 시나리오에서 기본 Service 범위를 기존 범위로 바꾸고 싶을 수 있어요.
- 클러스터를 처음 시작할 때 잘못된 범위가 (예: /30으로) 구성됐다.
- 클러스터를 새 IP 대역으로 마이그레이션한다.
- 이전에 지원하지 않았던 서브넷 크기로 변경하고 싶다.
(이어서) 이 페이지는 ServiceCIDR 객체를 사용해 기본 서비스 IP 범위를 재구성하는 절차를 설명해요. 자세한 단계는 원문을 참고하세요.