ネットワーク要件
このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。
ScalarDB をデプロイする前に、通常はファイアウォールルールを設定して、クライアント、ScalarDB コンポーネント、およびその他の Scalar 製品間で必要なネットワークトラフィックが許可されるようにする必要があります。このページでは、ScalarDB Cluster の機能ごとに整理された、許可が必要な接続の一覧を、各接続の方向、デフォルトポート、ユースケースとともに示します。
以下のテーブルに記載されているポート番号はデフォルト値です。設定でデフォルトポートを変更している場合は、ファイアウォールルールの設定時にカスタムポート番号を使用してください。
ScalarDB Core に関連する接続
ScalarDB Cluster をデプロイするのではなく、ScalarDB Core をアプリケーションにライブラリとして埋め込む場合は、以下の接続を許可する必要があります。
| 接続元 | 接続先 | ポート (デフォルト) | ユースケース例 |
|---|---|---|---|
| クライアントアプリケーション | バックエンドデータベース | データベースによる | Coordinator テーブルのトランザクションメタデータを含む読み取り/書き込みリクエスト |
Coordinator テーブルの詳細については、Consensus Commit プロトコルを参照してください。
ScalarDB Cluster に関連する接続
ScalarDB Cluster をデプロイする場合は、以下の接続を許可する必要があります。
| 接続元 | 接続先 | ポート (デフォルト) | ユースケース例 |
|---|---|---|---|
| クライアント (ユーザーアプリケーション) | ScalarDB Cluster ノード | 60053/TCP | トランザクションの実行 |
| ScalarDB Cluster ノード | ScalarDB Cluster ノード | 60053/TCP | クラスター内部でのトランザクションリクエストのルーティング |
| Scalar Admin for Kubernetes | ScalarDB Cluster ノード | 60053/TCP | バックアップ操作のための一時停止/再開リクエストの実行 |
| Scalar Admin for Kubernetes | Kubernetes API サーバー | 443/TCP | Pod、Service、Deployment 情報の取得 |
| クライアント (モニタリングツール) | ScalarDB Cluster ノード | 9080/TCP | ScalarDB Cluster ノードのメトリクス収集 |
| ScalarDB Cluster ノード | バックエンドデータベース | データベースによる | バックエンドデータベースへの読み取り/書き込みリクエスト |
| ScalarDB Cluster ノード | Kubernetes API サーバー | 443/TCP | クラスターノードを検出するための Endpoints リソースの監視 |
| クライアント (direct-kubernetes モード) | Kubernetes API サーバー | 443/TCP | 接続先のクラスターノード IP アドレスの解決 |
| ScalarDB Cluster ノード | クラスター DNS (Kubernetes) | 53/UDP、53/TCP | DNS を通じたホスト名解決 |
以下のプロパティを設定することで、これらのデフォルトポートを変更できます:
scalar.db.cluster.node.port: Administrative API、Transaction API、SQL API、および管理者サービス (デフォルト:60053)scalar.db.graphql.port: GraphQL インターフェース (デフォルト:8080)scalar.db.cluster.node.prometheus_exporter_port: メトリクス (デフォルト:9080)
scalar.db.cluster.node.admin.port を設定して、管理者サービス (pause、unpause、checkPaused) を専用ポートで実行する場合、そのポートにもアクセスできる必要があります。この場合、管理者サービスのみがそのポートで実行され、scalar.db.cluster.node.port は他の gRPC API のために引き続きアクセス可能である必要があります。
暗号化に関連する接続
列の値を暗号化する場合は、使用する暗号化キーのストレージタイプに応じて、以下の接続を許可する必要があります。
| 接続元 | 接続先 | ポート (デフォルト) | ユースケース例 |
|---|---|---|---|
| ScalarDB Cluster ノード | HashiCorp Vault | vault.address によって異なる | 書き込み前の列の値の暗号化 (type=vault) |
| ScalarDB Cluster ノード | Kubernetes API サーバー | 443/TCP | Kubernetes シークレットとして保存されたデータ暗号化キーの読み取り/書き込み (type=self) |
詳細については、保存データの暗号化を参照してください。
GraphQL インターフェースに関連する接続
GraphQL インターフェースを使用する場合は、以下の接続を許可する必要があります。
| 接続元 | 接続先 | ポート (デフォルト) | ユースケース例 |
|---|---|---|---|
| クライアント (ユーザーアプリケーション) | ScalarDB Cluster ノード | 8080/TCP | GraphQL クエリの実行 |
詳細については、ScalarDB Cluster GraphQL をはじめようを参照してください。
OpenTelemetry に関連する接続
OpenTelemetry を使用してメトリクスとトレースをエクスポートする場合は、以下の接続を許可する必要があります。
| 接続元 | 接続先 | ポート (デフォルト) | ユースケース例 |
|---|---|---|---|
| ScalarDB Cluster ノード | OTLP エンドポイント (メトリクス用 Collector) | エンドポイント URL によって異なる | トランザクションのメトリクスのエクスポート |
| ScalarDB Cluster ノード | OTLP エンドポイント (トレース用 Collector) | エンドポイント URL によって異なる | トランザクションのトレースのエクスポート |