Kubernetes

[쿠버네티스] kubeconfig 파일

✅ kubeconfig 파일이란?

kubeconfig 파일은 쿠버네티스 정보들을 담아놓은 설정 파일(configuration file) 로 kubectl 명령어가 쿠버네티스로 명령어를 보낼때 사용되는 참조 파일입니다.

설정 파일은 일반적으로 홈 폴더내 /.kube 폴더 안에 config 파일로 위치해 있습니다.

✅ config 파일 역할

kubeconfig 파일에는 접속을 위한한 클러스터의 API 서버 주소, 클러스터의 인증서 경로, 보안 설정 등의 정보를 갖고 있어 Kubernetes 클라이언트가 올바른 클러스터에 연결할 수 있도록 합니다.

또한, 사용자가 클러스터에 접근 및 인증을 위한 클라이언트 인증서와 개인 키나 인증 토큰등의 정보를 이용해 사용자 인증 및 권한 부여를 수행합니다.

마지막으로 어느 클러스터에 어떤 사용자 접근할지에 대한 정보를 조합해 컨텍스트로 정의 및 관리합니다.

✅ config 파일 주요 구성 요소

kubeconfig 파일은 아래와 같은 항목들로 구성돼 있습니다.

  • clusters
    접속을 위한 클러스터 정보들를 담고 있으며, 각 클러스터별로 클러스터 이름, API 서버의 주소 및 인증서 파일 경로를 포함합니다.
  • users
    클러스터에 접근하는 사용자의 인증 정보 를 담고 있습니다. 여러 사용자 정보를 관리할 수 있으며, 각 사용자 별로 이름, 클라이언트 인증서, 개인 키, 토큰, 또는 기타 인증 방식이 명시될 수 있습니다.
  • contexts
    클러스터와 사용자 조합을 매핑하여 정의합니다. 하나의 context 에는 어느 클러스터에, 어떤 사용자로, 어떤 네임스페이스를 사용해서 접근할지에 대한 정보가 명시돼 있습니다.
  • current-context
    현재 사용하기 위한 context 를 지정합니다. 이 값은 kubectl 명령 실행 시 기본적으로 사용될 context 정보입니다.
apiVersion: v1
kind: Config
clusters:
  - name: example-cluster
    cluster:
      server: https://<클러스터 주소>
      certificate-authority: <클러스터 인증서 경로>
users:
  - name: example-user
    user:
      client-certificate: <클라이언트 인증서 위치>
      client-key: <클라이언트 개인키 위치>
contexts:
  - name: example-context
    context:
      cluster: example-cluster
      user: example-user
      namespace: default
current-context: example-context
Share