前提条件
- アップグレード前にデータをバックアップしてください (MongoDB、ClickHouse の PVC)
- 現在の
values.yamlの上書き設定を確認してください — 多くのキーが移動または名称変更されています
2段階インストール
データの永続化
helm uninstall では削除されません。これは、意図しないデータ損失を防ぐための仕様です。アンインストール後に PVC をクリーンアップする方法については、以下を参照してください。
ストレージクラス
global.storageClassName と global.keepPVC は廃止されました。ストレージクラスは、各 オペレーター の CR スペックで直接設定するようになりました。
変更点
HyperDX values の再編
hyperdx: ブロックは、Kubernetes のリソースタイプごとに整理されるようになりました。
主な変更点
統合されたConfigMapとSecret
envFrom を介して HyperDX デプロイメント および OTel collector で共有される、固定名の 2 つのリソースを通して渡されます。
clickstack-configConfigMap —hyperdx.configから生成されますclickstack-secretSecret —hyperdx.secretsから生成されます
MongoDB の移行
削除された値
mongodb.* 値は廃止されました。
新しい値
MongoDBCommunity カスタムリソースを通じて MCK オペレーターによって管理されます。CR スペックは mongodb.spec からそのまま反映されます。
hyperdx.secrets.MONGODB_PASSWORD に設定します (mongodb.password ではありません) 。この値は、password Secret と mongoUri テンプレートから自動的に参照されます。
永続化を追加するには、mongodb.spec の中に statefulSet ブロックを追加します:
mongodb-operator: 配下で設定します (mongodb-kubernetes: ではありません) 。利用可能なすべての CRD フィールドについては、MCK documentation を参照してください。
ClickHouseへの移行
削除された値
clickhouse.* values は廃止されました:
新しい値
ClickHouseCluster および KeeperCluster のカスタムリソースを通じて ClickHouse オペレーター によって管理されます。両方の CR スペックは、values からそのままレンダリングされます。
clickhouse.config.users ではなく hyperdx.secrets から取得するようになりました。クラスター仕様では、テンプレート式でそれらを参照します。
ClickHouse オペレーター のサブチャートは、clickhouse-operator: の下で設定します。webhooks と cert-manager はデフォルトで無効になっています。利用可能なすべての CRD フィールドについては、オペレーター の設定ガイドを参照してください。
OTel collector の移行
削除された値
otel: ブロック全体が削除されました:
新しい値
otel-collector: サブチャートとしてデプロイされるようになりました。親チャートの otel: ラッパーはないため、サブチャートを直接設定してください。
環境変数 (ClickHouse endpoint、OpAMP URL など) は、共通の clickstack-config ConfigMap と clickstack-secret Secret を通じて共有されます。サブチャートの extraEnvsFrom はあらかじめ設定されています:
otel.resources) :
otel.replicas) :
otel.nodeSelector/otel.tolerations) :
変更のない値
global.*(imageRegistry, imagePullSecrets)
新規インストールとインプレースアップグレード
- オペレーター (MCK、ClickHouse Operator) は、ネームスペース内に新しいデプロイメントとしてインストールされます
- 既存の MongoDB デプロイメントと ClickHouse デプロイメントは Helm によって削除されます (これらは chart のテンプレートに含まれなくなったためです)
- オペレーターは、MongoDB と ClickHouse を管理するための新しい StatefulSets を作成します
- 古い chart の PVC は、オペレーターが管理する StatefulSets では自動的に再利用されません
次のステップ
- メインの Helm ガイド - v2.x を使用した基本的なインストール
- 設定ガイド - API keys、シークレット、イングレス
- 追加マニフェスト - カスタム Kubernetes オブジェクト
- ClickStack Helm チャートリポジトリ - チャートのソースコードと values リファレンス