[CKA] 39. kubeconfig 구조 분석 및 관리
개요
k8s의 설정 파일인 kubeconfig의 구조 분석 및 필요 성을 알아보겠습니다.
파일의 위치
kubeadmn으로 설치를 하였다면 kubeconfig파일의 위치는 아래와 같습니다.
원본 파일
/etc/kubernetes/admin.conf
복사된 파일
kubectl은 기본적으로 아래 경로에있는 설정 파일을 사용합니다. 그래서 kubeadm로 설치시 마지막에 원본파일을 아래 경로에 복사하게 합니다.
$HOME/.kube/config
kubeconfig 목적
kubectl이 다양한 사용자 및 cluster의 조합을 사용하여 k8s 접근을 위해서 사용하는 설정 파일입니다.
kubeconfig 주요 정보
cluster 연결 정보 제공
cluster의 API 서버 주소 및 CA 인증서 정보를 제공합니다.
인증 정보 제공
cluster에 접근하기 위한 사용자의 인증 정보 (예: 인증서, 토큰, 사용자명/비밀번호)를 저장합니다.
context 관리
여러 cluster 및 사용자에 대한 접근을 관리하며, 어떤 cluster를 어떤 사용자의 인증 정보로 접근할지 결정합니다.
기본 설정 정의
현재 사용 중인 cluster, 사용자, 네임스페이스 등을 지정하여 kubectl 명령어의 기본 동작을 정의합니다.
kubeconfig 구조
아래 명령을 사용하면 kubeconfig 파일의 내용을 간약하게 볼 수 있습니다.
kubectl config view
$HOME/.kube/config 파일의 내용에서 인증서 관련 정보만 요약하여 보여주는 정보입니다.
파일 내용
cat ~/.kube/config 파일 내용
apiVersion: v1
clusters:
- cluster:
certificate-authority-data: DATA+OMITTED
server: https://192.168.0.26:6443
name: kubernetes
contexts:
- context:
cluster: kubernetes
namespace: default
user: kubernetes-admin
name: kubernetes-admin@kubernetes
current-context: kubernetes-admin@kubernetes
kind: Config
preferences: {}
users:
- name: kubernetes-admin
user:
client-certificate-data: REDACTED
client-key-data: REDACTED
파일 주요 내용 분석
clusters
cluster에 대한 연결 정보를 포함합니다.
name
cluster의 이름
server
cluster의 API 서버 주소.
certificate-authority-data
cluster의 CA base64 정보
/etc/kubernetes/pki/ca.crt 를 base64로 encoding한 값입니다.
base64 -w0 /etc/kubernetes/pki/ca.crt
contexts
cluster와 사용자의 조합을 포함하여 `kubectl`이 어떻게 동작해야 하는지를 정의합니다.
name
context의 이름.
cluster
사용할 cluster의 이름.
user
사용할 사용자의 이름.
namespace
기본 네임스페이스.
current-context
현재 사용 중인 context의 이름. 이 context는 `kubectl` 명령어를 실행할 때 기본적으로 사용됩니다.
users
cluster에 접근하기 위한 사용자의 인증 정보를 포함합니다.
name
사용자의 이름.
client-certificate-data
cluster의 CA base64 정보
/etc/kubernetes/pki/ca.crt 를 base64로 encoding한 값입니다.
base64 -w0 /etc/kubernetes/pki/ca.crt
client-key
키의 경로.
token
bearer token.
username
기본 인증에 사용되는 사용자명
password
기본 인증에 사용되는 비밀번호.
이 외에도 `kubeconfig` 파일에는 기타 설정과 확장 가능한 기능을 위한 여러 옵션이 포함될 수 있습니다. 파일은 YAML 형식으로 작성되며, 한 개 이상의 `kubeconfig` 파일을 병합하여 사용할 수도 있습니다.
kubeconfig 파일 내용 간의 관계
unser와 cluster 관계
kubeconfig 파일에서 cluster와 user의 관계는 context가 연결해 줍니다.
context - name을 보면 연결관계를 알 수 있습니다.
{user-name}@{cluster name}
관계입니다.
그리고 현재 용 중인 context는 current-context로 확인이 가능합니다.
namespace 지정
context를 통해서 사용하려는 기본 namespace 또한 지정이 가능합니다.
kubeconfig 관리 명령어
kubeconfig 파일은 kubectl을 통하여 관리가 가능합니다. 다음은 kubeconfig관련하여 유용한 명령어입니다.
사용 중인 kubeconfig 파일 확인
kubectl config view
현재 context의 cluseter와 user 확인
kubectl config current-context
모든 context 목록 확인
kubectl config get-contexts
특정 context로 전환
kubectl config use-context [CONTEXT_NAME]
새로운 context추가
kubectl config set-context [CONTEXT_NAME] --cluster=[CLUSTER_NAME] --user=[USER_NAME] --namespace=[NAMESPACE]
context 이름 변경
kubectl config rename-context [OLD_NAME] [NEW_NAME]
context 삭제
kubectl config delete-context [CONTEXT_NAME]
cluster 정보 설정
kubectl config set-cluster [CLUSTER_NAME] --server=[API_SERVER_URL] --certificate-authority=[CA_FILE_PATH]
user 정보 추가
kubectl config set-credentials [USER_NAME] --client-certificate=[CERT_FILE_PATH] --client-key=[KEY_FILE_PATH]
특정 namespace를 context의 기본값으로 설정
kubectl config set-context --current --namespace=[NAMESPACE]
kubeconfig 파일 병합
여러 kubeconfig 파일들을 하나로 병합하려면 KUBECONFIG 환경 변수를 사용하면 됩니다.
export KUBECONFIG=~/.kube/config:~/.kube/kubconfig2
kubectl config view --flatten > ~/.kube/merged_kubeconfig
다른 kubeconfig 파일 확인
기본 kubeconfig 파일이 아닌 다른 kubeconfig파일의 내용을 보려면 --kubeconfig {파일명} 을 사용하면 됩니다.
kubectl config --kubeconfig ./my-kube-config get-clusters
정리
kubeconfig 파일은 kubelet이 cluster를 사용하기 편하게 하기 위한 설명 파일이다.
kubeoncifg의 구조는 cluster, user, context로 이루어져 있는데. context를 통하여 cluster와 user를 연결하는 구조로 되어있다.