Skip to content

Kubeconfig 준비

플랫폼 관리자 계정으로 다운로드한 Kubeconfig 파일을 사용하면 클러스터의 모든 네임스페이스에 접근할 수 있습니다. 이 파일을 통해 kubectl, helm, K9s 등의 CLI 도구로 플랫폼 상태를 파악하고 운영 작업을 수행합니다.

플랫폼 관리자 계정으로 다운로드

일반 사용자 계정의 Kubeconfig는 해당 사용자가 속한 프로젝트 네임스페이스에만 접근 가능합니다.
플랫폼 운영을 위해서는 플랫폼 관리자 계정으로 다운로드한 Kubeconfig를 사용해야 합니다.

Kubeconfig 다운로드

  1. 플랫폼 관리자 계정으로 Runway에 로그인합니다.

  2. 오른쪽 상단 프로필 아이콘 > 계정 설정 > 다운로드 Kubeconfig 메뉴를 선택합니다.

    Kubeconfig 다운로드

  3. 다운로드 Kubeconfig 버튼을 클릭합니다.

  4. config.yml 파일이 다운로드됩니다.

    다운로드된 파일

사전 요구 사항

Kubeconfig를 사용하려면 다음 도구가 설치되어 있어야 합니다.

도구 설명
kubectl Kubernetes CLI. 클러스터와 ±1 minor 범위 버전 설치 권장
kubelogin kubectl oidc-login 플러그인. Keycloak OIDC 인증에 필요

Kubeconfig 적용

기존 Kubeconfig 덮어쓰기 주의

~/.kube/config 경로에 이미 다른 클러스터의 설정이 있는 경우, 덮어쓰면 기존 설정이 유실됩니다. 여러 클러스터를 사용하는 경우 KUBECONFIG 환경 변수로 파일을 지정하세요.

방법 1: 기본 경로에 배치
cp config.yml ~/.kube/config
방법 2: 환경 변수로 지정
export KUBECONFIG=~/kubeconfigs/config.yml

클러스터 접근 확인

kubectl get namespaces

최초 실행 시 브라우저가 열리며 Keycloak 로그인 페이지로 이동합니다. 플랫폼 관리자 계정으로 로그인하면 인증이 완료됩니다.

이후 전체 네임스페이스 접근이 가능한지 확인합니다.

# 전체 네임스페이스 파드 상태 확인
kubectl get pods -A

# 플랫폼 구성 요소 버전 확인
helm list -A