메인 콘텐츠로 건너뛰기
지원 중단 — v1.x 차트이 페이지는 유지보수 모드에 있는 v1.x 인라인 템플릿 Helm 차트를 사용한 Cloud 배포를 설명합니다. v2.x 차트는 Helm Cloud 배포를 참조하십시오. 마이그레이션 방법은 업그레이드 가이드를 참조하십시오.
이 가이드는 관리형 Kubernetes 서비스에 ClickStack을 배포할 때 필요한 Cloud 전용 구성을 다룹니다. 기본 설치는 기본 Helm 배포 가이드를 참조하십시오.

Google Kubernetes Engine (GKE)

GKE에 배포할 때는 클라우드별 네트워킹 동작으로 인해 일부 값을 재정의해야 할 수 있습니다.

LoadBalancer DNS 이름 확인 문제

GKE의 LoadBalancer 서비스는 파드 간 통신이 클러스터 네트워크 내부에 머무르지 않고 외부 IP로 확인되는 내부 DNS 이름 확인 문제를 일으킬 수 있습니다. 이는 특히 OTel collector의 OpAMP 서버 연결에 영향을 줍니다. 증상:
  • 클러스터 IP 주소와 함께 “connection refused” 오류가 표시되는 OTel collector 로그
  • 다음과 같은 OpAMP 연결 실패: dial tcp 34.118.227.30:4320: connect: connection refused
해결 방법: OpAMP 서버 URL에 정규화된 도메인 이름(FQDN)을 사용하십시오:

기타 GKE 관련 고려 사항

Amazon EKS

EKS 배포에서는 다음과 같은 일반적인 구성을 고려할 수 있습니다:

Azure AKS

AKS에 배포하는 경우:

프로덕션 Cloud 배포 체크리스트

클라우드 제공업체와 관계없이 ClickStack을 프로덕션 환경에 배포하기 전에 다음 사항을 확인하십시오.
  • 외부 도메인/IP에 맞게 frontendUrl을 올바르게 구성
  • HTTPS 접속을 위해 TLS가 적용된 인그레스 설정
  • 연결 문제가 발생하는 경우(특히 GKE에서) otel.opampServerUrl을 FQDN으로 재정의
  • 파드 네트워크 CIDR에 맞게 clickhouse.config.clusterCidrs 조정
  • 프로덕션 워크로드용 영구 스토리지 구성
  • 적절한 리소스 요청량 및 제한 설정
  • 모니터링 및 알림 활성화
  • 백업 및 재해 복구 구성
  • 적절한 시크릿 관리 구현

프로덕션 환경 모범 사례

리소스 관리

고가용성

영구 스토리지

데이터 보존을 위해 영구 볼륨이 구성되어 있는지 확인하세요:
Cloud 환경별 스토리지 클래스:
  • GKE: pd-ssd 또는 pd-balanced
  • EKS: gp3 또는 io2
  • AKS: managed-premium 또는 managed-csi

브라우저 호환성 참고 사항

HTTP 전용 배포(개발/테스트)에서는 보안 컨텍스트 요구 사항 때문에 일부 브라우저에서 crypto API 오류가 표시될 수 있습니다. 프로덕션 배포에서는 항상 인그레스 구성을 통해 올바른 TLS 인증서와 함께 HTTPS를 사용하십시오. TLS 설정 방법은 인그레스 구성을 참조하십시오.

다음 단계

마지막 수정일 2026년 6월 10일