클러스터 등록

최종 수정: 2026. 1. 19.

Skuber+ Cost Optimize - 클러스터 등록

새 클러스터를 Skuber+ Cost Optimize에 연결하는 방법을 안내합니다.


개요

클러스터 등록은 3단계로 진행됩니다.

클러스터 등록 프로세스

사전 요구사항

필수 조건

항목 요구사항
Kubernetes 버전 1.25 이상
kubectl 클러스터 접근 가능
권한 Cluster Admin
네트워크 아웃바운드 HTTPS (443)

지원 클라우드

클라우드 서비스 지원 상태
AWS EKS 지원
Oracle OKE 지원

Step 1: Console에서 클러스터 등록

1.1 클러스터 등록 시작

  1. Console에 로그인
  2. 대시보드에서 "+ 클러스터 등록" 버튼 클릭

1.2 클러스터 정보 입력

다음 정보를 입력합니다.

필드 설명 예시
클러스터 별칭 식별용 이름 prod-main
클러스터 이름 실제 클러스터 이름 my-eks-cluster
환경 환경 구분 Production / Staging / Development
클라우드 클라우드 제공자 AWS / Oracle
리전 클러스터 위치 ap-northeast-2

1.3 등록 완료

"등록" 버튼을 클릭하면 클러스터가 INITIALIZING 상태로 생성됩니다.

clusger-checking.png


Step 2: Agent 설치

2.1 설치 스크립트 복사

Console에서 제공되는 설치 스크립트를 복사합니다.

# 예시 스크립트 (실제 값은 Console에서 확인)
curl -sSL https://install.skuberplus.com/agent | bash -s -- \
  --cluster-id="sk:mycompany:aws:ap-northeast-2:prod-main" \
  --tenant-id="mycompany" \
  --api-endpoint="https://api.skuberplus.com"

2.2 터미널에서 실행

kubectl이 연결된 터미널에서 스크립트를 실행합니다.

# 1. 네임스페이스 생성 (필요한 경우)
kubectl create namespace skuber-system

# 2. 설치 스크립트 실행
curl -sSL https://install.skuberplus.com/agent | bash -s -- \
  --cluster-id="sk:mycompany:aws:ap-northeast-2:prod-main" \
  --tenant-id="mycompany" \
  --api-endpoint="https://api.skuberplus.com"

2.3 설치 확인

Agent Pod가 정상적으로 실행 중인지 확인합니다.

kubectl get pods -n skuber-system

예상 출력:

NAME                                    READY   STATUS    RESTARTS   AGE
skuber-agent-7d9f8b6c4d-xxxxx           1/1     Running   0          30s
skuber-agent-controller-5c8b7a6d3-yyyy  1/1     Running   0          30s

모든 Pod가 Running 상태이면 설치가 완료된 것입니다.


Step 3: 연결 확인

3.1 Console에서 상태 확인

Console에서 클러스터 상태가 변경되는 것을 확인합니다.

3.2 연결 완료

CONNECTED 상태가 되면 연결이 완료된 것입니다.

cluster_register.png


클러스터 삭제

삭제 순서

클러스터 연결을 해제하려면 다음 순서로 진행합니다.

  1. Console에서 취소 요청

    • 클러스터 상세 → "클러스터 삭제" 클릭
  2. Agent 제거

    kubectl delete namespace skuber-system
  3. Console에서 최종 삭제

    • Agent 제거 확인 후 삭제 완료

문제 해결

Agent 설치 실패

# Pod 상태 확인
kubectl get pods -n skuber-system

# 로그 확인
kubectl logs -n skuber-system -l app=skuber-agent

연결 상태가 DISCONNECTED

  1. Agent Pod 상태 확인
  2. 네트워크 연결 확인 (아웃바운드 HTTPS)
  3. Agent 로그 확인

자세한 내용은 문제 해결 가이드를 참조하세요.


다음 단계