클러스터 연결

개요

QKS 클러스터에는 kubeconfig 파일을 사용하여 kubectl 또는 다른 Kubernetes 도구로 연결할 수 있습니다. kubeconfig에는 클러스터 API 서버 주소, 인증 토큰, TLS 인증서 정보가 포함되어 있습니다.

---

kubeconfig 다운로드

1. 왼쪽 메뉴에서 클러스터를 선택합니다.
2. 연결할 클러스터를 클릭합니다.
3. 클러스터 상세 페이지에서 kubeconfig 다운로드 버튼을 클릭합니다.
4. .kubeconfig 파일이 다운로드됩니다.

---

kubectl로 연결

단일 클러스터 사용

다운로드한 kubeconfig 파일을 환경 변수로 지정하여 사용합니다.

export KUBECONFIG=~/Downloads/my-cluster.kubeconfig
kubectl get nodes

정상 연결되면 노드 목록이 출력됩니다:

NAME           STATUS   ROLES    AGE   VERSION
node-1         Ready    <none>   5m    v1.36.1
node-2         Ready    <none>   5m    v1.36.1
node-3         Ready    <none>   5m    v1.36.1

기본 kubeconfig로 사용

~/.kube/config가 없는 경우, 파일을 복사하여 기본 위치에 저장합니다.

mkdir -p ~/.kube
cp ~/Downloads/my-cluster.kubeconfig ~/.kube/config
kubectl get nodes

---

여러 클러스터 관리 (kubeconfig 병합)

여러 QKS 클러스터를 사용하는 경우 kubeconfig를 병합하여 kubectl config use-context로 전환할 수 있습니다.

# 기존 config와 새 클러스터 config 병합
KUBECONFIG=~/.kube/config:~/Downloads/new-cluster.kubeconfig \
  kubectl config view --merge --flatten > /tmp/merged.kubeconfig

mv /tmp/merged.kubeconfig ~/.kube/config

# 현재 context 목록 확인
kubectl config get-contexts

# 클러스터 전환
kubectl config use-context <context-name>

---

kubeadm, Lens, k9s 등과 연결

모든 KUBECONFIG 환경 변수 또는 --kubeconfig 플래그를 지원하는 도구에서 동일하게 사용할 수 있습니다.

# k9s
k9s --kubeconfig ~/Downloads/my-cluster.kubeconfig

# helm
helm list --kubeconfig ~/Downloads/my-cluster.kubeconfig

---

보안 주의사항

• kubeconfig 파일에는 클러스터 접근 자격증명이 포함됩니다.
• Git 등 버전 관리 시스템에 커밋하지 마세요.
• 더 이상 사용하지 않는 kubeconfig는 삭제하세요.
• 클러스터가 삭제되면 해당 kubeconfig는 자동으로 무효화됩니다.