사전 요구 사항
- 업그레이드하기 전에 데이터를 백업하세요 (MongoDB, ClickHouse PVC)
- 현재
values.yamloverride 설정을 검토하세요 — 대부분의 키가 다른 위치로 이동했거나 이름이 변경되었습니다
2단계 설치
데이터 영속성
helm uninstall로 삭제되지 않습니다. 이는 실수로 데이터가 손실되는 것을 방지하기 위한 설계입니다. 제거 후 PVC를 정리하려면 다음을 참조하십시오.
스토리지 클래스
global.storageClassName 및 global.keepPVC가 제거되었습니다. 이제 스토리지 클래스는 각 operator의 CR spec에 직접 설정합니다:
변경 사항
HyperDX values 재구성
hyperdx: 블록은 Kubernetes 리소스 유형별로 정리되었습니다.
주요 변경 사항
통합 ConfigMap 및 시크릿
envFrom을 통해 HyperDX 배포 및 OTel collector가 공유하는, 이름이 고정된 두 리소스를 통해 전달됩니다.
clickstack-configConfigMap —hyperdx.config를 기반으로 채워집니다clickstack-secret시크릿 —hyperdx.secrets를 기반으로 채워집니다
MongoDB 마이그레이션
제거된 값
mongodb.* 값은 더 이상 존재하지 않습니다:
새로 추가된 값
MongoDBCommunity 사용자 지정 리소스를 통해 MCK operator에서 관리됩니다. CR spec은 mongodb.spec의 내용을 그대로 반영해 렌더링됩니다:
hyperdx.secrets.MONGODB_PASSWORD에 설정합니다(mongodb.password가 아님). 이 값은 비밀번호 시크릿과 mongoUri 템플릿에서 자동으로 참조됩니다.
데이터 지속성을 추가하려면 mongodb.spec 내부에 statefulSet 블록을 추가하세요:
mongodb-operator: 아래에서 구성합니다(mongodb-kubernetes:가 아님). 사용 가능한 모든 CRD 필드는 MCK 문서에서 확인하십시오.
ClickHouse 마이그레이션
제거된 값
clickhouse.* 값은 더 이상 존재하지 않습니다:
새로운 값
ClickHouseCluster 및 KeeperCluster 사용자 지정 리소스를 통해 ClickHouse Operator로 관리됩니다. 두 CR spec은 values에 정의된 내용이 그대로 반영됩니다:
clickhouse.config.users가 아니라 hyperdx.secrets에서 가져옵니다. 클러스터 사양에서는 템플릿 표현식을 사용해 이를 참조합니다.
ClickHouse Operator 서브차트는 clickhouse-operator: 아래에서 구성됩니다. 웹훅과 cert-manager는 기본적으로 비활성화되어 있습니다. 사용 가능한 모든 CRD 필드는 operator 구성 가이드를 참조하십시오.
OTEL Collector 마이그레이션
삭제된 값
otel: 블록 전체가 더 이상 존재하지 않습니다:
새로운 값
otel-collector: 서브차트로 배포됩니다. 상위 차트 otel: 래퍼는 없으므로 서브차트를 직접 구성하십시오.
환경 변수(ClickHouse 엔드포인트, OpAMP URL 등)는 통합된 clickstack-config ConfigMap과 clickstack-secret 시크릿을 통해 공유됩니다. 서브차트의 extraEnvsFrom은 이미 연결되어 있습니다:
otel.resources):
otel.replicas 사용):
otel.nodeSelector/otel.tolerations):
변경되지 않는 값
global.*(imageRegistry, imagePullSecrets)
신규 설치와 인플레이스 업그레이드
- 오퍼레이터(MCK, ClickHouse Operator)는 네임스페이스에 새 배포로 설치됩니다
- 기존 MongoDB 배포와 ClickHouse 배포는 Helm에 의해 삭제됩니다(더 이상 chart의 templates에 포함되지 않음)
- 오퍼레이터가 MongoDB와 ClickHouse를 관리하기 위해 새로운 StatefulSet을 생성합니다
- 이전 chart의 PVC는 오퍼레이터가 관리하는 StatefulSet에서 자동으로 재사용되지 않습니다
다음 단계
- 기본 Helm 가이드 - v2.x를 사용한 기본 설치
- 구성 가이드 - API Key, 시크릿 및 인그레스
- 추가 매니페스트 - 사용자 정의 Kubernetes 객체
- ClickStack Helm 차트 리포지토리 - 차트 소스 코드 및 values 참고