EKS에서 AWS Marketplace 라이선스 활성화

EKS에서 AWS Marketplace 라이선스 활성화 (Activate a Grafana Enterprise license from AWS Marketplace on EKS)

AWS Marketplace를 통해 Grafana Enterprise 구독을 구매했다면, Grafana에서 Enterprise 데이터 소스 플러그인과 기능을 사용하려면 라이선스를 활성화해야 해요. 이 문서는 Amazon EKS에 Grafana Enterprise를 배포하고 라이선스를 활성화하는 4단계를 안내합니다.

출처: 문서

본문

AWS Marketplace를 통해 Grafana Enterprise 구독을 구매했다면, Grafana에서 Grafana Enterprise 데이터 소스 플러그인과 기능을 사용하려면 라이선스를 활성화해야 해요.

시작하기 전에:

  • AWS Marketplace에서 Grafana Enterprise 구독을 구매합니다.
  • Grafana Enterprise를 구매할 때 사용한 IAM 사용자가 구독 관리, 새 IAM 사용자·역할 생성, 접근 정책 생성 권한이 있는지 확인합니다.

작업 1: Amazon EKS에 Grafana Enterprise 배포

Amazon EKS에 Grafana Enterprise를 배포합니다.

  • Amazon EKS에 애플리케이션 배포에 대한 자세한 내용은 Getting started with Amazon EKS – AWS Management Console and AWS CLI 문서를 참고하세요.
  • Helm Chart로 Kubernetes에 Grafana를 설치하는 방법은 Grafana Helm Chart를 참고하세요.
  • kubectl set image deployment/my-release grafana=grafana/grafana-enterprise:<version> 로 컨테이너 이미지를 업데이트합니다. 예를 들어 grafana/grafana-enterprise:11.3.0 을 입력하세요.
  • AWS Marketplace를 통해 부여된 라이선스를 지원하는 Grafana Enterprise 버전은 8.3.0 이상만 가능해요.

작업 2: 고가용성을 위해 Grafana 구성

Grafana는 대시보드, 사용자, 기타 영구 데이터를 보관할 데이터베이스 구성이 필요해요.

고가용성을 위한 Grafana 구성을 위해 다음 옵션 중 하나를 선택하세요:

옵션 1: kubectl edit configmap grafana 로 grafana.ini 를 편집해 설정에 다음 섹션을 추가합니다:

[database]
type = [database type]
host = [database address and port]
name = [database name]
user = [database username]
password = [database password]

옵션 2: kubectl edit deployment my-release 로 pod env 변수를 편집해 다음 데이터베이스 변수를 추가합니다:

- name: GF_DATABASE_TYPE
  value: [database type]
- name: GF_DATABASE_HOST
  value: [database address and port]
- name: GF_DATABASE_NAME
  value: [database name]
- name: GF_DATABASE_USER
  value: [database username]
- name: GF_DATABASE_PASSWORD
  value: [database password]

Grafana 고가용성 설정에 대한 자세한 내용은 Set up Grafana for high availability 문서를 참고하세요.

작업 3: Grafana Enterprise가 AWS로 라이선스를 검증하도록 구성

이 작업에서는 Grafana Enterprise가 Grafana Labs 대신 AWS로 라이선스를 검증하도록 구성합니다.

AWS IAM에서 Node IAM 역할(Node Group 사용 시) 또는 Pod Execution 역할(Fargate profile 사용 시)에 다음 권한을 할당합니다:

"license-manager:CheckoutLicense"
"license-manager:ListReceivedLicenses"
"license-manager:GetLicenseUsage"
"license-manager:CheckInLicense"

접근 정책 생성에 대한 자세한 내용은 Creating IAM policies (console)를 참고하세요. AWS 라이선스 권한에 대한 자세한 내용은 Actions, resources, and condition keys for AWS License Manager를 참고하세요.

license_validation_type 설정을 aws 로 업데이트하려면 다음 옵션 중 하나를 선택합니다:

옵션 1: kubectl edit configmap grafana 로 grafana.ini 를 편집해 다음 섹션을 추가합니다:

[enterprise]
license_validation_type=aws

옵션 2: kubectl edit deployment my-release 로 pod env 변수를 편집해 다음 변수를 추가합니다:

name: GF_ENTERPRISE_LICENSE_VALIDATION_TYPE
value: aws

작업 4: Grafana 시작 또는 재시작

Grafana Enterprise 기능을 활성화하려면 Grafana를 시작(또는 재시작)해야 해요. Kubernetes 클러스터에서 Grafana를 재시작하려면 kubectl rollout restart deployment my-release 명령을 실행합니다.

서비스 업데이트 후 Grafana 인스턴스로 이동해 Grafana Admin 자격 증명으로 로그인하고 Administration > General > Stats and license 로 이동해 라이선스가 활성화됐는지 확인합니다. Grafana 재시작에 대한 자세한 내용은 Restart Grafana 문서를 참고하세요.

EKS 클러스터 업데이트 중 문제가 발생하면 Amazon EKS troubleshooting을 참고하세요.

더 알아보기 (Learn more)