メインコンテンツへスキップ
このページでは、BYOC デプロイメントで利用できる各種インフラストラクチャ設定オプションについて説明します。これらの設定により、要件に応じてネットワーク、セキュリティ、コンピュートリソースをカスタマイズできます。

ロードバランサー

BYOC デプロイメントでは、Network Load Balancers (NLBs) を使用して、ClickHouse サービスへのトラフィックを管理・ルーティングします。ネットワーク構成に応じて、パブリック または プライベート のロードバランサーエンドポイントを選択できます。 パブリックロードバランサー:
  • ClickHouse サービスへのパブリック (インターネット向け) アクセスを提供します。
  • 通常、ClickHouse 管理の専用 VPC を使用する場合はデフォルトで有効になります。
  • セキュリティを強化するため、顧客管理 VPC を使用する場合はデフォルトで無効になります。
プライベートロードバランサー:
  • プライベート (内部) アクセスを提供し、接続されたネットワーク内からのみアクセスできます。
  • 通常、顧客管理 VPC を使用する場合はデフォルトで有効になります。
  • 通常、ClickHouse 管理の専用 VPC を使用する場合はデフォルトで無効になります。
BYOC インフラストラクチャのプライベートロードバランサーは、ClickHouse Cloud console で直接有効にできます。その他のエンドポイント調整 (たとえば、パブリックロードバランサーの削除) については、ClickHouse Cloud Support と連携してください。

AWS のプライベートロードバランサーのセキュリティグループ

BYOC デプロイメントでプライベートロードバランサーを使用する場合は、想定しているプライベートネットワーク (ピアリングされた VPC など) からのアクセスを許可するため、適切なセキュリティグループルールが設定されていることを確認する必要があります。デフォルトでは、このセキュリティグループは VPC 内からのトラフィックのみを許可します。 プライベートロードバランサーのセキュリティグループを設定するには、次の対応を行ってください。 ClickHouse Support に連絡して、特定の送信元ネットワークからのトラフィックを許可する受信セキュリティグループルールへの変更を依頼してください。
  • VPC Peering: ピアリングされた VPC の CIDR 範囲からのトラフィックを許可するルールを依頼してください。
  • PrivateLink: トラフィックはロードバランサーのセキュリティグループの制御対象ではないため、セキュリティグループの変更は不要です。
  • その他のネットワーク構成: ご利用の構成を伝えてください。状況に応じてサポートが対応します。
プライベートロードバランサーのセキュリティグループに対する変更は、すべて ClickHouse Support が実施する必要があります。これにより、設定の一貫性が確保され、ClickHouse Cloud 管理環境内での競合を回避できます。
ネットワーク分離とセキュリティを最大限に高めるため、BYOC デプロイでは AWS PrivateLink、GCP Private Service Connect、または Azure プライベートリンク を利用できます。これらのオプションを使用すると、VPC/VNet peering を必要とせず、エンドポイントをパブリックインターネットに公開することなく、アプリケーションから ClickHouse Cloud サービスにプライベート接続できます。 手順を追ったセットアップについては、Private Networking Setup guideを参照してください。

Kubernetes API のプライベート接続

デフォルトでは、BYOC クラスターの Kubernetes API サーバーのエンドポイントはパブリックインターネットからアクセス可能です。AWS では、IP フィルタリングにより、ClickHouse NAT ゲートウェイの IP からのアクセスのみに制限されています。GCP と Azure では、代わりにクラウドの IAM によって制御されます (Kubernetes API サーバーの公開を参照) 。より強固なセキュリティを実現するには、Kubernetes API サーバーをプライベートアクセスのみに制限できます。この場合、AWS と Azure ではプライベートネットワーク接続経由でのみアクセスできるようになります。GCP ではパブリック IP エンドポイントが無効化されますが、管理サービスは IAM で認可された DNS ベースのエンドポイントを使用します。このエンドポイントはお客様の VPC ネットワークの外部に置かれたままとなります。 利用可能なプライベート接続オプションは、クラウドプロバイダーによって異なります:

AWS VPC Lattice

AWS の Deployment では、サードパーティ製コンポーネントを使わずに、AWS VPC Lattice 経由で Kubernetes API サーバーにプライベート接続できます。
  • ClickHouse Cloud は、BYOC VPC 内の EKS API サーバーのエンドポイントを対象とする VPC Lattice Resource Gateway と Resource Configuration を自動的にプロビジョニングし、AWS Resource Access Manager (RAM) を通じて、その Resource Configuration を ClickHouse Cloud の管理アカウントと共有します。
  • ClickHouse の管理サービスとお使いの Kubernetes API サーバーとの間のトラフィックは、すべて AWS のプライベートネットワーク内にとどまります。
  • RAM 共有はお使いのアカウントから作成され、単一の BYOC クラスターに限定されます。これを削除すると、プライベートアクセス経路はただちに無効になります。
  • Kubernetes クラスター内で動作するエージェントにアクセスが依存しないため、クラスター内コンポーネントが利用できない場合でも、ClickHouse Support はトラブルシューティングのためのアクセスを維持できます。

Tailscale

EKS API サーバーへのプライベート接続として Tailscale を使用する方法は非推奨です。AWS では、代わりに AWS VPC Lattice を使用してください。現在、AWS 上のデプロイメントでプライベートな Kubernetes API アクセスに Tailscale を使用している場合は、ClickHouse Support に連絡して VPC Lattice へ移行してください。
プライベート API エンドポイントが有効になっている場合、ClickHouse 管理サービスは、トラブルシューティングアクセスに使用されるものと同じ Tailscale のゼロトラストネットワークを介して Kubernetes API サーバーに接続します。GCP では、デプロイ用ツール、監視、トラブルシューティングの通信は Tailscale が担い、管理サービスは DNS ベースのエンドポイントを使用します (GCP プライベート control-plane エンドポイント を参照) 。この接続の仕組みの詳細については、Tailscale Private Network を参照してください。
プライベート接続を Tailscale のみに依存している場合、Tailscale エージェントが利用できなくなると、ClickHouse Support がお使いの環境にアクセスできなくなるリスクがあります。その結果、トラブルシューティングやサポート対応に時間がかかる可能性があります。

GCP のプライベートな control-plane エンドポイント

GCP では、ClickHouse 管理サービスはデフォルトで GKE control-plane のパブリック IP エンドポイント経由で接続します。このエンドポイントを無効化すると、パブリック IP アドレスから control-plane に接続できなくなります。
  • 無効化後も、control-plane には VPC ネットワーク内からのみ接続可能な内部 IP エンドポイントと、常に有効な DNS ベースのエンドポイント (*.gke.goog) が残ります。
  • ClickHouse 管理サービスは、DNS ベースのエンドポイント経由で control-plane に接続します。このアクセスは、送信元 IP の許可リストではなく、ClickHouse がお客様のプロジェクト内で権限借用する service account に付与された container.clusters.connect IAM アクセス許可によって認可されます。そのため、このアクセス許可を取り消せば、この経路も遮断されます。リクエストは VPC ネットワーク内ではなく Google のフロントエンドで終端されるため、ネットワーク的にプライベートな接続ではなく、control-plane へのアクセス経路の 1 つとして評価してください。
  • デプロイ用ツール、監視、および ClickHouse エンジニアによるトラブルシューティングアクセスは、Tailscale 経由で内部 IP エンドポイントに接続します。Tailscale エージェントは初期セットアップ時にクラスターへデプロイされるため、このモードを有効化できるのはセットアップ完了後のみです。
  • container.googleapis.com を制限する VPC Service Controls の境界を設定している場合、DNS ベースのエンドポイントも制限されます。ClickHouse の管理用アイデンティティを許可するイングレスルールを追加してください。対象のアイデンティティは、お客様のデプロイメントに応じて ClickHouseチームが提供します。

Azure プライベートリンク

Azure 上のデプロイメントでは、Azure プライベートリンク を介して AKS API サーバーにプライベートに接続できます。
  • クラスターは API Server VNet Integration を有効にしたプライベートクラスターとして作成され、パブリック FQDN は無効化されます。
  • ClickHouse Cloud は、お客様のサブスクリプション内で API サーバーの内部ロードバランサーの前段に Private Link Service をプロビジョニングし、あわせて ClickHouse Cloud の管理用 VNet 内に対応するプライベート エンドポイントを作成します。この接続が自動承認されるのは、ClickHouse Cloud の管理用サブスクリプションからの接続に限られます。
  • ClickHouse の管理サービスとお客様の API サーバー間のトラフィックは、Azure のバックボーンネットワーク内で完結します。
  • ClickHouse エンジニアによるトラブルシューティングアクセスには、引き続き Tailscale を使用します。
プライベート API エンドポイントの設定をご希望の場合は、ClickHouse Support にお問い合わせください。

ノードグループ

Kubernetes のノードグループは、BYOC デプロイメントで ClickHouse サービスを実行するために必要なリソースを提供するコンピュートインスタンスの集まりです。ClickHouse Cloud はこれらのノードグループを管理し、設定とスケーリングを自動的に行います。

デフォルト設定

BYOCクラスターは、2種類の主要なノードグループでプロビジョニングされます。
  • システムノードグループ ClickHouse Operator、Istio (サービスメッシュ用) 、監視コンポーネント (Prometheus、Grafana、AlertManager) 、クラスターオートスケーラー、そのほかの中核サービスなど、重要なシステムワークロードをホストします。これらのノードでは通常、標準的な x86 のインスタンスタイプが使用されます。
  • ワークロードノードグループ server や Keeper サービスを含む、ClickHouse のデータワークロード専用のノードグループです。デフォルトでは、ワークロードノードは ARM ベースのインスタンス上で稼働し、パフォーマンスとコスト効率のバランスに優れています。ただし、別の CPU/メモリプロファイルを指定したり、要望に応じて x86 アーキテクチャに切り替えたりすることもできます。

ノードグループのカスタマイズ

特殊なリソースやアーキテクチャが必要な場合は、以下のカスタマイズに対応できます。ご相談や導入については、ClickHouse Support までお問い合わせください。
  • インスタンスタイプの選択 パフォーマンス、コンプライアンス、高メモリ/CPU、予約済みリソースの活用などの要件に合わせて、特定のインスタンスタイプを選択できます。
  • CPU/メモリ比率 必要に応じて、ワークロードノードグループのコンピュートプロファイルを調整できます。
  • アーキテクチャ 必要に応じて、ワークロードノードグループのアーキテクチャを ARM から x86 に切り替えられます。
注: Spot (プリエンプト可能) インスタンスはサポートされていません。すべての BYOC ノードグループは、デフォルトでオンデマンドインスタンス上で実行されます。
ノードグループのカスタマイズや設定変更は、すべて ClickHouse Support と連携して実施する必要があります。これにより、互換性、安定性、最適なパフォーマンスを確保できます。

自動スケーリング

クラスターのノードグループは、クラスターオートスケーラーによって、次の要素に基づいて自動的にスケールされます。
  • ポッドのリソースリクエストと上限
  • クラスター全体の容量と使用率
  • ClickHouse サービス のスケーリング要件
手動での対応は不要です。デプロイメントにおける継続的なリソース管理とスケーリング管理は、ClickHouse Cloud が行います。