Amazon EKS 설치

무료 티어 클러스터도 AWS Marketplace Metered를 사용하지 않는 한 무료 라이선스 키가 필요합니다. 무료 키 요청하기

사전 요구사항

Amazon EKS 클러스터, Kubernetes 1.26+
대상 클러스터에 설정된 kubectl
helm 3
AWS CLI 로그인 (Marketplace 방식 사용 시)

방법 1: AWS Marketplace (Metered)

⚠️

라이선스 키가 필요하지 않습니다. AWS Marketplace 구독이 필요합니다. 요금은 AWS Marketplace를 통해 종량 과금되며, 클러스터 vCPU가 200을 초과할 때만 과금이 시작됩니다.

제품: Wave Autoscale - Kubernetes AI-Driven Autoscaling (Metered) (opens in a new tab)
Helm 차트: AWS Marketplace를 통해 제공됩니다.
이미지 레지스트리: AWS Marketplace ECR
라이선스: Marketplace 메터링 제품에서 처리합니다.

values-aws-marketplace-metering.yaml

spec:
  # Option A: create a new PVC and specify a StorageClass.
  storageClassName: "<STORAGE_CLASS_NAME>"
 
  # Option B: use a pre-existing PVC.
  # existingPvcName: "<EXISTING_PVC_NAME>"

설치

위 Marketplace 제품을 구독한 뒤 AWS Marketplace의 "Continuous Delivery" / "Configure software" 흐름을 따라가면 구독에 맞는 정확한 helm install 명령어가 제공됩니다. 위의 values-*.yaml을 사용하세요.

방법 2: AWS Marketplace (BYOL)

⚠️

라이선스 키가 필요합니다. 무료 티어도 예외가 아닙니다. 200 vCPU 미만 클러스터는 무료 키를 요청하세요. 더 큰 클러스터는 가격 정책을 참고하세요.

제품: Wave Autoscale - Kubernetes AI-Driven Autoscaling (BYOL) (opens in a new tab)
Helm 차트: AWS Marketplace를 통해 제공됩니다.
이미지 레지스트리: AWS Marketplace ECR
라이선스: license.key에 설정하는 Wave 발급 라이선스 키

values-aws-marketplace-byol.yaml

license:
  key: "<LICENSE_KEY>"
 
spec:
  # Option A: create a new PVC and specify a StorageClass.
  storageClassName: "<STORAGE_CLASS_NAME>"
 
  # Option B: use a pre-existing PVC.
  # existingPvcName: "<EXISTING_PVC_NAME>"

설치

위 BYOL Marketplace 제품을 구독한 뒤 이 섹션의 values 파일을 사용해 Marketplace의 설치 흐름을 따라가세요.

방법 3: GHCR

⚠️

라이선스 키가 필요합니다. 무료 티어도 예외가 아닙니다. 200 vCPU 미만 클러스터는 무료 키를 요청하세요.

Helm 차트: https://release.waveautoscale.io/helm-chart
이미지 레지스트리: ghcr.io/stclab-inc/*
Pull secret: Wave 팀이 제공하는 GHCR pull secret

values-ghcr.yaml

ghcr:
  enabled: true
  dockerconfigjson: "<GHCR_PULL_SECRET_DOCKERCONFIGJSON>"
 
license:
  key: "<LICENSE_KEY>"
 
spec:
  # Option A: create a new PVC and specify a StorageClass.
  storageClassName: "<STORAGE_CLASS_NAME>"
 
  # Option B: use a pre-existing PVC.
  # existingPvcName: "<EXISTING_PVC_NAME>"

설치

<CHART_VERSION>을 원하는 Wave Autoscale Helm 차트 버전으로 바꾸세요.

CMD

helm repo add wave-autoscale-helm https://release.waveautoscale.io/helm-chart
helm repo update
 
helm install wave-autoscale-helm wave-autoscale-helm/wave-autoscale-helm \
  -f values-ghcr.yaml \
  --version <CHART_VERSION> \
  --create-namespace \
  -n wave-autoscale

설치 확인

CMD

kubectl get pods -n wave-autoscale

port-forward로 웹 콘솔을 엽니다:

CMD

kubectl port-forward -n wave-autoscale svc/wave-autoscale-svc 3025:3025

http://localhost:3025로 접속합니다.

기본 로그인 정보: 사용자 이름 admin, 비밀번호 waveautoscale. 설정이 끝나는 대로 웹 콘솔의 사용자 관리 UI에서 반드시 변경하세요.

업데이트 (GHCR 방식)

CMD

helm repo update
 
helm upgrade wave-autoscale-helm wave-autoscale-helm/wave-autoscale-helm \
  -f values-ghcr.yaml \
  --version <CHART_VERSION> \
  -n wave-autoscale

Marketplace 방식을 사용 중이라면 Marketplace의 업데이트 흐름을 따라가세요.

제거

CMD

helm uninstall wave-autoscale-helm -n wave-autoscale

⚠️

PVC 보존: StatefulSet의 보존 정책에 따라 제거 후에도 PVC는 유지됩니다. 저장된 데이터가 더 이상 필요 없을 때만 PVC를 수동으로 삭제하세요.

다음 단계

중요: 시작하기 전에: 알아둬야 할 런타임 동작입니다.
Helm Values & 환경 변수: 전체 환경 변수와 Helm 값입니다.
문제 해결: 자주 발생하는 문제입니다.

빠른 시작 Red Hat OpenShift