Skuber+ 이용약관

개요

Skuber Plus는 Kubernetes 클러스터 최적화를 위한 SaaS 플랫폼입니다. 클러스터에 Skuber Plus Agent를 설치하면 자동 확장(auto-scaling)과 리소스 최적화 기능을 즉시 활용할 수 있습니다.

지원 플랫폼

클라우드 서비스 제공자

- AWS EKS (Elastic Kubernetes Service)
- OCI OKE (Container Engine for Kubernetes)
- Azure AKS, GCP GKE - 추후 지원 예정

쿠버네티스 버전

지원 버전: 1.33.1 이하

Skuber Plus Agent 리소스 요구사항

유형	CPU	메모리	설명
최소	600m	700 MiB	기본 동작
권장	2.8 cores	2.5 GiB	최적의 성능

Type	CPU	Memory	Description
Minimum	600m	700 MiB	Basic operation
Recommended	2.8 cores	2.5 GiB	Optimal performance

‍

설치 전 요구사항

중요 안내

기존 솔루션 제거 필요

클러스터에 자동 확장, 스케줄링 최적화, 리소스 관리, 비용 최적화와 관련된 솔루션이 이미 설치되어 있다면, Skuber⁺ Agent 설치 전에 반드시 제거해야 합니다. Skuber⁺는 이러한 기능을 통합 제공하므로, 기존 솔루션을 제거하지 않으면 충돌이 발생할 수 있습니다.

필수 도구

- kubectl : Kubernetes 클러스터 접근
- helm : 3.0 이상
- curl, sed, jq : 설치 스크립트 실행
- CSP CLI : AWS CLI 또는 OCI CLI (구성됨)

필수 Kubernetes 권한

- cluster-admin 또는 이에 상응하는 권한
- Namespace, RBAC, CRD 생성 권한

권한 요구사항

Skuber⁺ Agent는 설치와 런타임에서 특정 클라우드 권한이 필요합니다.

권한 유형	AWS EKS	OCI OKE
설치 권한 (설치 후 제거 가능)	sts:GetCallerIdentity eks:DescribeCluster iam:CreateRole iam:GetRole iam:UpdateAssumeRolePolicy iam:PutRolePolicy iam:CreateOpenIDConnectProvider iam:GetOpenIDConnectProvider sqs:CreateQueue sqs:GetQueueAttributes sqs:GetQueueUrl events:PutRule events:PutTargets	tenancy 내 dynamic-groups 관리 tenancy 내 policy 관리 tenancy 내 clusters 사용 tenancy 내 compartments 조회
런타임 권한 (항상 유지 필요)	ec2:DescribeImages ec2:DescribeInstanceTypes ec2:DescribeSpotPriceHistory ec2:CreateTags ec2:DeleteTags eks:ListNodegroups eks:DescribeNodegroup eks:DescribeCluster eks:UpdateNodegroupConfig iam:CreateRole iam:DeleteRole iam:GetRole iam:PutRolePolicy iam:DeleteRolePolicy iam:AttachRolePolicy iam:DetachRolePolicy iam:GetOpenIDConnectProvider iam:UpdateAssumeRolePolicy iam:ListInstanceProfilesForRole iam:RemoveRoleFromInstanceProfile iam:ListAttachedRolePolicies sqs:CreateQueue sqs:DeleteQueue sqs:GetQueueAttributes sqs:GetQueueUrl events:PutRule events:PutTargets events:RemoveTargets events:DeleteRule pricing:GetProducts	tenancy 내 cluster-node-pools 관리 tenancy 내 cluster-node-pools 조회 tenancy 내 instance-family 관리 tenancy 내 instance-pools 관리 tenancy 내 instances 관리 tenancy 내 clusters 조회 tenancy 내 subnets 사용 tenancy 내 vnics 사용 tenancy 내 vnics 조회 tenancy 내 vcns 조회

Permission Type	AWS EKS	OCI OKE
Installation Permissions (Can be removed after installation)	sts:GetCallerIdentity eks:DescribeCluster iam:CreateRole iam:GetRole iam:UpdateAssumeRolePolicy iam:PutRolePolicy iam:CreateOpenIDConnectProvider iam:GetOpenIDConnectProvider sqs:CreateQueue sqs:GetQueueAttributes sqs:GetQueueUrl events:PutRule events:PutTargets	manage dynamic-groups in tenancy manage policy in tenancy use clusters in tenancy inspect compartments in tenancy
Runtime Permissions (Must be retained)	ec2:DescribeImages ec2:DescribeInstanceTypes ec2:DescribeSpotPriceHistory ec2:CreateTags ec2:DeleteTags eks:ListNodegroups eks:DescribeNodegroup eks:DescribeCluster eks:UpdateNodegroupConfig iam:CreateRole iam:DeleteRole iam:GetRole iam:PutRolePolicy iam:DeleteRolePolicy iam:AttachRolePolicy iam:DetachRolePolicy iam:GetOpenIDConnectProvider iam:UpdateAssumeRolePolicy iam:ListInstanceProfilesForRole iam:RemoveRoleFromInstanceProfile iam:ListAttachedRolePolicies sqs:CreateQueue sqs:DeleteQueue sqs:GetQueueAttributes sqs:GetQueueUrl events:PutRule events:PutTargets events:RemoveTargets events:DeleteRule pricing:GetProducts	manage cluster-node-pools in tenancy read cluster-node-pools in tenancy manage instance-family in tenancy manage instance-pools in tenancy manage instances in tenancy read clusters in tenancy use subnets in tenancy use vnics in tenancy read vnics in tenancy read vcns in tenancy

‍

네트워크 요구사항

Outbound 연결 (필수)

아웃바운드 인터넷 연결을 위해 다음 포트가 열려 있어야 합니다:

- TCP 443 (HTTPS)
- TCP 80 (HTTP)

Firewall 구성

- Agent → Internet: TCP 443, 80 (아웃바운드만 필요)
- 추가적인 인바운드 규칙은 필요하지 않음

Quick Start Guide

1단계: 사전 점검


# Check Kubernetes version
kubectl version --short

# Verify cluster access permissions
kubectl auth can-i '*' '*' --all-namespaces

2단계: Skuber 포털에 클러스터 등록

Skuber portal에 로그인하세요
"새 클러스터 추가"를 클릭하세요
클러스터 정보 (이름, 리전, CSP)를 입력하세요
생성된 설치 명령어를 복사하세요

3단계: 에이전트 설치


# Execute the command copied from Portal
curl -sSL https://skuber-plus-file.s3.ap-northeast-1.amazonaws.com/install/agent/agent-install.sh | \
  bash -s -- -c "YOUR_CLUSTER_TOKEN" -h "https://api.skuber.io/apis/v1/agent/cluster-info"

4단계: 설치 확인


# Check Agent Pod status
kubectl get pods -n skuber-system

# Verify all components are running
kubectl get all -n skuber-system

CMS Collection - Techfy X Webflow Template

Ecommerce Content - Techfy X Webflow Template

Ecommerce Collection - Techfy X Webflow Template

Ecommerce Page - Techfy X Webflow Template

체크리스트

Kubernetes 버전 1.33.1 이하
kubectl cluster-admin 권한 보유
CSP CLI 구성 완료
필요한 IAM 권한/정책 부여
아웃바운드 포트 443, 80 열려 있음
Agent 리소스 확보 (최소 600m CPU, 700 MiB 메모리)

Kubernetes version 1.33.1 or below
kubectl cluster-admin permissions
CSP CLI configured
Required IAM permissions/policies granted
Outbound ports 443, 80 open
Agent resources available (minimum 600m CPU, 700 MiB Memory)

Responsive Design - Techfy X Webflow Template

문제 해결

일반적인 문제

권한 오류


Error: Insufficient permissions

→ 클러스터 관리자 권한 및 CSP IAM 권한 확인

‍

네트워크 연결 실패


Error: Unable to connect to Skuber API

→ 아웃바운드 포트 443, 80 및 DNS 확인

‍

리소스 부족


Error: Insufficient resources

→ 노드 리소스 확인: `kubectl top nodes`

지원

기술 지원 : support@skuberplus.com

Skuber Plus 시스템 요구사항

개요