쿠버네티스 API 활성화 또는 비활성화하기

쿠버네티스 API 활성화 또는 비활성화하기 (Enable Or Disable A Kubernetes API)

이 페이지는 클러스터의 컨트롤 플레인에서 API 버전을 활성화 또는 비활성화하는 방법을 보여드려요.

특정 API 버전은 API 서버에 --runtime-config=api/<version>을 명령줄 인자로 전달해 켜거나 끌 수 있어요. 이 인자의 값은 쉼표로 구분된 API 버전 목록이에요. 나중에 나오는 값이 앞의 값을 재정의해요.

runtime-config 명령줄 인자는 두 가지 특수 키도 지원해요.

  • api/all — 알려진 모든 API를 나타냄
  • api/legacy — 레거시 API만을 나타냄. 레거시 API는 명시적으로 폐기된 모든 API예요.

예를 들어 v1을 제외한 모든 API 버전을 끄려면 kube-apiserver--runtime-config=api/all=false,api/v1=true를 전달해요.

출처: 문서

본문

쿠버네티스 API 서버는 --runtime-config 플래그를 사용해 특정 API 그룹/버전의 활성화 여부를 제어할 수 있어요. api/v1 같은 기본 API 그룹 뿐 아니라 apps/v1, batch/v1 같은 API 그룹도 이 방식으로 켜거나 끌 수 있어요.

버전을 끄면 해당 버전의 API 리소스에 접근하려는 요청이 실패하게 돼요. 따라서 API 버전을 비활성화하기 전에 그 버전을 사용하는 클라이언트나 워크로드가 없는지 확인하는 것이 중요해요.

다음 단계 (What's next)

kube-apiserver 컴포넌트에 대한 전체 문서를 읽어 보세요.

더 알아보기 (Learn more)