클러스터 접속 및 관리

Prev Next

클러스터 생성을 완료하면 Ncloud Kubernetes Service 대시보드에서 클러스터 목록을 확인할 수 있으며, 클러스터에 접속할 수 있습니다. 클러스터 목록에서 클러스터의 상세 정보 확인, 파일 재설정, 클러스터 삭제 등 개별 클러스터와 관련된 작업을 수행할 수 있습니다.

네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Services > Container > Ncloud Kubernetes Service 메뉴를 차례대로 클릭하면 생성된 클러스터의 목록이 표시됩니다.

참고

클러스터에 접속하려면 SSL VPN이 연결된 클라이언트 환경이어야 합니다. SSL VPN에 접속하려면 SSL VPN 접속 방법을 참고해 주십시오.

클러스터 접속

생성된 클러스터에 kubectl 명령어를 사용하여 접속할 수 있습니다.

kubectl 명령어를 사용하여 클러스터에 접속하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Services > Container > Ncloud Kubernetes Service 메뉴를 차례대로 클릭해 주십시오.

  2. 클러스터 목록에서 접속할 클러스터의 행을 클릭한 인증 방식에 따라 설정파일을 구성해 주십시오.

    • Admin 인증 : [다운로드] 버튼을 클릭하여 클러스터의 설정 파일을 다운로드해 주십시오.
    • IAM 인증 : [IAM인증 가이드] 버튼을 클릭하여 ncp-iam-authenticator 설치 후 kubeconfig 파일을 생성해 주십시오.
    참고

    Admin 인증은 2022년 2월 13일 이전에 생성된 클러스터만 지원됩니다.

  3. 아래 예시와 같이 kubectl 명령어에 --kubeconfig 옵션을 사용하여 다운로드한 설정 파일의 경로를 지정한 후 실행해 주십시오.

    $ kubectl --kubeconfig "설정파일" get nodes
    
    참고

    $HOME/.kube/config 경로에 설정 파일을 직접 추가하는 방법도 있습니다.

  4. 아래 코드를 참조하여 사용 중인 운영 체제에 알맞은 방법으로 환경변수를 설정해 주십시오.

    • Mac 또는 Linux 운영 체제에서 $KUBE_CONFIG 환경변수 설정
    $ 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 환경변수 설정
    > $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 환경변수 설정
    > 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 사용 가이드 참조).

kubeconfig 파일 재설정

kubeconfig 설정 파일을 재설정할 수 있습니다. 재설정 기능을 사용할 경우 기존 파일은 더 이상 사용할 수 없으며, 재설정을 통해 만들어진 새 설정 파일을 다운로드해서 사용해야 합니다.

kubeconfig 설정 파일을 재설정하는 방법은 다음과 같습니다.

  1. 클러스터 목록에서 개별 클러스터 행을 클릭해 주십시오.
  2. 클러스터 상세 정보 탭에서 [재설정] 버튼을 클릭해 주십시오.
  3. 인증 파일을 재설정할 클러스터의 이름을 입력한 후 [재설정] 버튼을 클릭해 주십시오.
참고

Admin 인증을 지원하는 클러스터에서만 kubeconfig 파일을 재설정할 수 있습니다.


클러스터 삭제

클러스터를 삭제하는 방법은 다음과 같습니다.

  1. 클러스터 목록에서 삭제하려는 클러스터의 행을 클릭해 주십시오.
  2. 클러스터 목록 왼쪽 위에 있는 [삭제] 버튼을 클릭해 주십시오.
  3. 확인 팝업창에 해당 클러스터의 이름을 입력한 후 [삭제] 버튼을 클릭해 주십시오.

클러스터 Autoscaler 사용

클러스터 Autoscaler를 사용하여 워커 노드 개수가 자동으로 증감되도록 하려면 Cluster Autoscaler 이용을 참조해 주십시오.

클러스터 업그레이드

클러스터를 업그레이드하여 내부 관리 마스터 영역을 신규 버전으로 교체할 수 있습니다. 업그레이드 이후에 추가하는 노드풀은 업그레이드 이후의 버전이 적용됩니다. 업그레이드 도중에는 일시적으로 리소스 조회, 수정, 삭제가 불가능할 수 있습니다.

업그레이드 전 점검

클러스터를 업그레이드하기 전 아래의 사항을 확인하여 서비스에 영향을 줄 수 있는 요소를 점검해 주십시오.

  • 신규 버전 변경 사항: Kubernetes changelog를 참조하여 신규 버전에서 변경된 사항들이 서비스에 영향을 줄 수 있는지 확인하십시오.
  • 버전 차이 정책: Version Skew Policy를 참조하여 클러스터 및 구성 요소의 버전 간 호환성을 확인하십시오.
  • Admission Webhook: 클러스터 내에 Webhook이 있는 경우 업그레이드 도중 교착 상태에 빠질 수 있으므로, Dynamic Admission Control을 참조하여 업그레이드 전 미리 조치를 취하십시오.
  • 가용 서버 확보: 안정적인 업그레이드를 위해 가용 서버를 3개 이상 확보하십시오.
  • 리소스 백업/복구 : nodelocaldns, coredns ConfigMap과 같은 kube-system 리소스와 StorageClass 등은 업그레이드시에 유지되지 않으며, 새 버전으로 대체됩니다. 수정된 리소스가 있다면 백업하여 업그레이드 완료 후 다시 적용 하십시오.

다음 사항을 참고하여 업그레이드와 관련된 세부 사항을 설정할 수 있습니다.

  • PodDisruptionBudget: Specifying a Disruption Budget을 참고하여 클러스터 업그레이드 중에도 서비스 중인 Pod을 원하는 비율 또는 개수로 유지할 수 있습니다.
  • Readiness Probe: Define readiness probes를 참고하여 노드풀 교체 중 Pod가 재배치될 때 Pod가 서비스 가능 상태일때만 Ncloud Kubernetes Service 리소스를 통해 접근 가능하도록 설정할 수 있습니다.

업그레이드 방법

클러스터를 업그레이드하는 방법은 다음과 같습니다.

  1. 클러스터 목록에서 업그레이드하려는 클러스터의 행을 클릭해 주십시오.
  2. 클러스터 상세 정보 탭에서 [업그레이드] 버튼을 클릭해 주십시오.
  3. 설정 팝업 창에서 업그레이드할 버전을 선택한 후 해당 클러스터의 이름을 입력해 주십시오.
  4. [업그레이드] 버튼을 클릭해 주십시오.

Kubernetes 대시보드 사용

Kubernetes 대시보드를 사용하면 CLI 대신 GUI 인터페이스를 사용하여 클러스터를 제어할 수 있습니다. Kubernetes 대시보드는 브라우저를 통해 접속할 수 있습니다.

Kubernetes 대시보드에 접속하는 방법은 다음과 같습니다.

  1. 아래 명령어를 실행하여 프록시를 구동해 주십시오.
    $ kubectl --kubeconfig $KUBE_CONFIG proxy
    
  2. 브라우저를 실행하여 아래 링크로 접속해 주십시오.
    • http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/#/login
  3. 표시되는 대시보드 초기 화면에서 Token을 선택한 후 관리자용 토큰 값을 입력해 주십시오.
  4. [Sign In]을 클릭해 주십시오.

로그인을 완료하면 대시보드 화면에서 클러스터를 제어할 수 있습니다.
k8s-k8suse-cluster_kubedashbaord_vpc_ko