클러스터 등록
최종 수정: 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 클러스터 등록 시작
- Console에 로그인
- 대시보드에서 "+ 클러스터 등록" 버튼 클릭
1.2 클러스터 정보 입력
다음 정보를 입력합니다.
| 필드 | 설명 | 예시 |
|---|---|---|
| 클러스터 별칭 | 식별용 이름 | prod-main |
| 클러스터 이름 | 실제 클러스터 이름 | my-eks-cluster |
| 환경 | 환경 구분 | Production / Staging / Development |
| 클라우드 | 클라우드 제공자 | AWS / Oracle |
| 리전 | 클러스터 위치 | ap-northeast-2 |
1.3 등록 완료
"등록" 버튼을 클릭하면 클러스터가 INITIALIZING 상태로 생성됩니다.

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 상태가 되면 연결이 완료된 것입니다.

클러스터 삭제
삭제 순서
클러스터 연결을 해제하려면 다음 순서로 진행합니다.
Console에서 취소 요청
- 클러스터 상세 → "클러스터 삭제" 클릭
Agent 제거
kubectl delete namespace skuber-systemConsole에서 최종 삭제
- Agent 제거 확인 후 삭제 완료
문제 해결
Agent 설치 실패
# Pod 상태 확인
kubectl get pods -n skuber-system
# 로그 확인
kubectl logs -n skuber-system -l app=skuber-agent연결 상태가 DISCONNECTED
- Agent Pod 상태 확인
- 네트워크 연결 확인 (아웃바운드 HTTPS)
- Agent 로그 확인
자세한 내용은 문제 해결 가이드를 참조하세요.