--- title: "클러스터 접속 및 관리" slug: "k8s-k8suse-cluster" tags: ["container", "Ncloud Kubernetes Service", "Ncloud Kubernetes Service 사용"] updated: 2026-07-23T09:02:32Z published: 2026-07-23T09:02:32Z canonical: "guide-fin.ncloud-docs.com/k8s-k8suse-cluster" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 클러스터 접속 및 관리 클러스터 생성을 완료하면 Ncloud Kubernetes Service 대시보드에서 클러스터 목록을 확인할 수 있으며, 클러스터에 접속할 수 있습니다. 클러스터 목록에서 클러스터의 상세 정보 확인, 파일 재설정, 클러스터 삭제 등 개별 클러스터와 관련된 작업을 수행할 수 있습니다. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Containers** > **Ncloud Kubernetes Service** 메뉴를 차례대로 클릭하면 생성된 클러스터의 목록이 표시됩니다. :::(info) (참고) 클러스터에 접속하려면 SSL VPN이 연결된 클라이언트 환경이어야 합니다. SSL VPN에 접속하려면 [SSL VPN 접속 방법](https://www.fin-ncloud.com/intro/userGuide){target="_blank"}을 참고해 주십시오. ::: ## 클러스터 접속 생성된 클러스터에 kubectl 명령어를 사용하여 접속할 수 있습니다. kubectl 명령어를 사용하여 클러스터에 접속하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Containers** > **Ncloud Kubernetes Service** 메뉴를 차례대로 클릭해 주십시오. 2. 클러스터 목록에서 접속할 클러스터의 행을 클릭한 인증 방식에 따라 설정파일을 구성해 주십시오. - Admin 인증 : **[다운로드]** 버튼을 클릭하여 클러스터의 설정 파일을 다운로드해 주십시오. - IAM 인증 : **[IAM인증 가이드]** 버튼을 클릭하여 ncp-iam-authenticator 설치 후 kubeconfig 파일을 생성해 주십시오. :::(info) (참고) Admin 인증은 2022년 2월 13일 이전에 생성된 클러스터만 지원됩니다. ::: 3. 아래 예시와 같이 `kubectl` 명령어에 `--kubeconfig` 옵션을 사용하여 다운로드한 설정 파일의 경로를 지정한 후 실행해 주십시오. ``` $ kubectl --kubeconfig "설정파일" get nodes ``` :::(info) (참고) `$HOME/.kube/config` 경로에 설정 파일을 직접 추가하는 방법도 있습니다. ::: 4. 아래 코드를 참조하여 사용 중인 운영 체제에 알맞은 방법으로 환경변수를 설정해 주십시오. * Mac 또는 Linux 운영 체제에서 `$KUBE_CONFIG` 환경변수 설정 ```Shell $ export KUBE_CONFIG="${HOME}/Downloads/kubeconfig-1865.yaml" $ echo $KUBE_CONFIG /Users/user/Downloads/kubeconfig-1865.yaml $ kubectl --kubeconfig $KUBE_CONFIG get nodes ``` * Windows Powershell에서 `$KUBE_CONFIG` 환경변수 설정 ```Shell > $KUBE_CONFIG=$HOME+"\Downloads\kubeconfig-1865.yaml" > $KUBE_CONFIG C:\Users\NAVER\Downloads\kubeconfig-1865.yaml > kubectl --kubeconfig $KUBE_CONFIG get nodes ``` * Windows 명령 프롬프트에서 `$KUBE_CONFIG` 환경변수 설정 ```Shell > SET KUBE_CONFIG=%USERPROFILE%\Downloads\kubeconfig-1865.yaml > kubectl --kubeconfig %KUBE_CONFIG% get nodes ```
정상적으로 설정된 경우 아래 예시와 같이 결과가 표시됩니다. ``` NAME STATUS ROLES AGE nks-pool-0000-w-001 Ready node 5h22m nks-pool-0000-w-002 Ready node 5h22m nks-pool-0000-w-003 Ready node 5h22m ``` *** ## 클러스터 상세 정보 보기 클러스터 목록에서 개별 클러스터 행을 클릭하면 상세 정보를 확인할 수 있습니다. * **[가이드 보기]** 버튼을 클릭해 클러스터에 접속하는 방법에 대한 가이드를 확인할 수 있습니다. 해당 가이드에서 설명하는 내용은 [클러스터 접속](#클러스터접속)에서 더 자세히 확인할 수 있습니다. * **Audit Log** 오른쪽에 있는 **[수정]** 버튼을 클릭하여 활성화 여부를 변경할 수 있습니다. **Audit Log**를 활성화하면 Cloud Log Analytics에서 로그를 수집할 수 있습니다. 단, 활성화하려면 먼저 Cloud Log Analytics 서비스를 신청해야 합니다([CLA 사용 가이드](/docs/cla-overview) 참조). *** ## kubeconfig 파일 재설정 kubeconfig 설정 파일을 재설정할 수 있습니다. 재설정 기능을 사용할 경우 기존 파일은 더 이상 사용할 수 없으며, 재설정을 통해 만들어진 새 설정 파일을 다운로드해서 사용해야 합니다. kubeconfig 설정 파일을 재설정하는 방법은 다음과 같습니다. 1. 클러스터 목록에서 개별 클러스터 행을 클릭해 주십시오. 2. 클러스터 상세 정보 탭에서 **[재설정]** 버튼을 클릭해 주십시오. 3. 인증 파일을 재설정할 클러스터의 이름을 입력한 후 **[재설정]** 버튼을 클릭해 주십시오. :::(info) (참고) Admin 인증을 지원하는 클러스터에서만 kubeconfig 파일을 재설정할 수 있습니다. ::: *** ## 클러스터 삭제 클러스터를 삭제하는 방법은 다음과 같습니다. 1. 클러스터 목록에서 삭제하려는 클러스터의 행을 클릭해 주십시오. 2. 클러스터 목록 왼쪽 위에 있는 **[삭제]** 버튼을 클릭해 주십시오. 3. 확인 팝업창에 해당 클러스터의 이름을 입력한 후 **[삭제]** 버튼을 클릭해 주십시오. *** ## 클러스터 Autoscaler 사용 클러스터 Autoscaler를 사용하여 워커 노드 개수가 자동으로 증감되도록 하려면 [Cluster Autoscaler 이용](/docs/k8s-k8suse-clusterautoscaler)을 참조해 주십시오. ## 클러스터 업그레이드 클러스터를 업그레이드하여 내부 관리 마스터 영역을 신규 버전으로 교체할 수 있습니다. 업그레이드 이후에 추가하는 노드풀은 업그레이드 이후의 버전이 적용됩니다. 업그레이드 도중에는 일시적으로 리소스 조회, 수정, 삭제가 불가능할 수 있습니다. ### 업그레이드 전 점검 클러스터를 업그레이드하기 전 아래의 사항을 확인하여 서비스에 영향을 줄 수 있는 요소를 점검해 주십시오. * 신규 버전 변경 사항: [Kubernetes changelog](https://github.com/kubernetes/kubernetes/tree/master/CHANGELOG){target="_blank"}를 참조하여 신규 버전에서 변경된 사항들이 서비스에 영향을 줄 수 있는지 확인하십시오. * 버전 차이 정책: [Version Skew Policy](https://kubernetes.io/releases/version-skew-policy/)를 참조하여 클러스터 및 구성 요소의 버전 간 호환성을 확인하십시오. * Admission Webhook: 클러스터 내에 Webhook이 있는 경우 업그레이드 도중 교착 상태에 빠질 수 있으므로, [Dynamic Admission Control](https://kubernetes.io/docs/reference/access-authn-authz/extensible-admission-controllers/#avoiding-deadlocks-in-self-hosted-webhooks){target="_blank"}을 참조하여 업그레이드 전 미리 조치를 취하십시오. * 가용 서버 확보: 안정적인 업그레이드를 위해 가용 서버를 3개 이상 확보하십시오. * 리소스 백업/복구 : nodelocaldns, coredns ConfigMap과 같은 kube-system 리소스와 StorageClass 등은 업그레이드시에 유지되지 않으며, 새 버전으로 대체됩니다. 수정된 리소스가 있다면 백업하여 업그레이드 완료 후 다시 적용 하십시오. 다음 사항을 참고하여 업그레이드와 관련된 세부 사항을 설정할 수 있습니다. * PodDisruptionBudget: [Specifying a Disruption Budget](https://kubernetes.io/docs/tasks/run-application/configure-pdb/){target="_blank"}을 참고하여 클러스터 업그레이드 중에도 서비스 중인 Pod을 원하는 비율 또는 개수로 유지할 수 있습니다. * Readiness Probe: [Define readiness probes](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/#define-readiness-probes){target="_blank"}를 참고하여 노드풀 교체 중 Pod가 재배치될 때 Pod가 서비스 가능 상태일때만 Ncloud Kubernetes Service 리소스를 통해 접근 가능하도록 설정할 수 있습니다. ### 업그레이드 방법 클러스터를 업그레이드하는 방법은 다음과 같습니다. 1. 클러스터 목록에서 업그레이드하려는 클러스터의 행을 클릭해 주십시오. 2. 클러스터 상세 정보 탭에서 **[업그레이드]** 버튼을 클릭해 주십시오. 3. 설정 팝업 창에서 업그레이드할 버전을 선택한 후 해당 클러스터의 이름을 입력해 주십시오. 4. **[업그레이드]** 버튼을 클릭해 주십시오. ## Kubernetes 대시보드 사용 Kubernetes 대시보드를 사용하면 CLI 대신 GUI 인터페이스를 사용하여 클러스터를 제어할 수 있습니다. Kubernetes 대시보드는 브라우저를 통해 접속할 수 있습니다. Kubernetes 대시보드에 접속하는 방법은 다음과 같습니다. 1. 아래 명령어를 실행하여 프록시를 구동해 주십시오. ```shell $ kubectl --kubeconfig $KUBE_CONFIG proxy ``` 2. 브라우저를 실행하여 아래 링크로 접속해 주십시오. * http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/#/login 3. 표시되는 대시보드 초기 화면에서 **Token**을 선택한 후 관리자용 토큰 값을 입력해 주십시오. * 관리자용 토큰 값을 생성하는 방법은 [Kubernetes 대시보드 설치](/docs/k8s-k8sstart#Kubernetes대시보드설치)를 참고하십시오. 4. [**Sign In**]을 클릭해 주십시오. 로그인을 완료하면 대시보드 화면에서 클러스터를 제어할 수 있습니다. ![k8s-k8suse-cluster_kubedashbaord_vpc_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/k8s-k8suse-cluster_kubedashbaord_vpc_ko.png){height="" width=""}