変数リファレンス — データレイクが読むもの
データレイク コンテナが 実際に読む 変数だけを集めました。基本値の正本はコンテナ内の plantpulse-datalake-cli/config/defaults.env で、ホストから渡された値がそれを上書きします。ホスト側の値全体(DOCKER_* を含む)は 環境変数リファレンス にあります。
下表の「ホストから変更できるか」列が いいえ の変数は、サイドカーに少なくともコンテナに入りません。compose がその名前をデータレイクに渡さないためです。その値は defaults.env またはテンプレートが決めます。
シークレット — ないとどうなるか
pd が知るシークレットは 3 つのリストです。値はどこにも基本値がなく、サイドカー → compose → 環境変数でのみ入ります。
| リスト | 変数 | ない場合 |
|---|---|---|
| 必須 | PP_REDIS_PASSWORD PP_PG_PASSWORD PP_CASSANDRA_PASSWORD PP_MINIO_PASSWORD PP_MQ_PASSWORD PP_TSE_PASSWORD PP_SPARK_PASSWORD PP_HIVE_PASSWORD PP_GRAVITINO_PASSWORD PP_TEMPORAL_PASSWORD PP_KESTRA_DB_PASSWORD PP_KESTRA_ADMIN_PASSWORD PP_TLS_KEYSTORE_PASSWORD PP_CEP_API_KEY PP_DATA_GATEWAY_API_KEY | pd start が exit 3 で停止し、不足している名前をすべて列挙します。compose も :? で要求するため、スタックがまったく起動しません |
| ワーカー追加 | PP_PG_REPLICA_PASSWORD | WORKER ノードでのみ必須 |
| オプション | PP_DATALAKE_ADMIN_PASSWORD PP_DATALAKE_ADMIN_API_KEY PP_DATA_GATEWAY_WEB_PASSWORD PP_CEP_WEB_PASSWORD | その機能だけ 無効になります。スタックは正常に起動。pd doctor が名前を教えます |
変更する方法は パスワード・APIキー変更 にあります。派生値セット(PP_TLS_TRUSTSTORE_PASSWORD · PP_REDIS_TRUSTSTORE_PASSWORD · PP_MQ_TRUSTSTORE_PASSWORD)はキーストア パスワードから生成され、個別に設定しません。
ノード・アドレス
| 変数 | 基本値 | 意味 | ホストから変更できるか |
|---|---|---|---|
PP_MODE | MASTER | MASTER / WORKER。ワーカーは worker-add.sh で決まります | ノード ファイル |
PP_HOST_IP | 10.99.0.100 (compose ネットワーク固定 IP) | このコンテナのアドレス。アドバタイズ アドレスの基盤 | DOCKER_PP_IP で |
PP_MASTER_IP | PP_HOST_IP | 別のボックスがこのデータレイクに接続するアドレス | ノード ファイル |
PP_SERVICE_IP | 空の値 | NAT 配下のグローバル IP。TLS SAN に入ります | ノード ファイル DOCKER_PP_EXTERNAL_IP |
PP_KAFKA_ADVERTISED_HOST | 起動時に導出 | Kafka がクライアントに通知するアドレス | ノード ファイル (NAT・第 2 インターフェイス時のみ) |
PP_CLUSTER_CORES | ホスト コア − 2 (4～30) | Spark などに通知するコア数 | DOCKER_PP_CLUSTER_CORES |
PP_DATA_DISK_NAME | ホストから検出 | ディスク使用率を測定するデバイス | DOCKER_PP_DATA_DISK_NAME |
PP_DATA_DIR · PP_TEMP_DIR · PP_BACKUP_DIR | /data1/pp-data · /data1/pp-temp · /data1/pp-backup | ボリューム マウント位置 | いいえ (compose リテラル) |
PP_LANG · PP_TZ | en · Asia/Seoul | 言語・タイムゾーン | サイドカー |
ストレージ
| 変数 | 基本値 | ホストから変更できるか |
|---|---|---|
PP_REDIS_USER · PP_REDIS_PORT | redis · 6379 | アカウント名のみ (ポートは不可) |
PP_PG_USER · PP_POSTGRES_PORT · PP_DB_NAME | plantpulse · 5432 · pp | アカウント名・DB 名 (ポートは不可) |
PP_CASSANDRA_USER · PP_CASSANDRA_PORT · PP_KEYSPACE | cassandra · 9042 · pp | アカウント名・キースペース (ポートは不可) |
PP_MINIO_USER · PP_MINIO_PORT · PP_MINIO_BUCKET | minio · 9000 · plantpulse | アカウント名のみ |
PP_PG_REPLICA_USER | replica | サイドカー |
PP_KEYSPACE · PP_DB_NAME · PP_TOPIC_PREFIX はデータレイクが 作成し アプリが 読む 識別子なので、両方に届くよう compose の x-pp-secrets アンカーにあります。インストール後に変更すると、新しい名前の空のストレージが生成され、古いデータは古い名前に残ります。
分析・メッセージング・時系列・ワークフロー
| 変数 | 基本値 | ホストから変更できるか |
|---|---|---|
PP_HIVE_USER · PP_HIVE_PORT · PP_HIVE_DB | hive · 9083 · hive-metastore-230 | アカウント名のみ |
PP_SPARK_USER · PP_SPARK_PORT · PP_SPARK_WEBUI_PORT · PP_KYUUBI_PORT | spark · 7077 · 4440 · 10000 | アカウント名のみ |
PP_GRAVITINO_USER · PP_GRAVITINO_ICEBERG_REST_PORT | gravitino · 19001 | アカウント名のみ |
PP_MQ_USER · PP_TOPIC_PREFIX | mq · pp | サイドカー |
PP_KAFKA_PORT · PP_KAFKA_TLS_PORT · PP_KAFKA_CONTROLLER_PORT | 9092 · 9094 · 9093 | いいえ |
PP_MQTT_PORT · PP_MQTT_TLS_PORT | 1883 · 1884 | いいえ |
PP_TSE_USER · PP_TSE_PORT · PP_TSE_TLS_PORT · PP_TSE_PROTOCOL | tse · 7800 · 7801 · http | アカウント名のみ |
PP_TSE_DATAPOINT_TTL | 31536000 (365 日) | いいえ — テンプレート編集 |
PP_TEMPORAL_USER · PP_TEMPORAL_PORT | temporal · 7233 | アカウント名のみ |
PP_KESTRA_DB_USER · PP_KESTRA_ADMIN_EMAIL · PP_KESTRA_PORT | kestra · admin@plantpulse.io · 8380 | アカウント名・メール |
PP_CEP_PORT · PP_CEP_TLS_PORT · PP_CEP_PROTOCOL | 7400 · 7401 · http | いいえ |
PP_DATA_GATEWAY_PORT · PP_DATA_GATEWAY_TLS_PORT · PP_DATA_GATEWAY_PROTOCOL | 5500 · 5501 · http | いいえ |
PP_TSE_DATAPOINT_TTL — 時系列データポイントの寿命時系列エンジンが 書き込みのたびに この TTL を刻みます(INSERT … USING TTL)。したがって値を変更すると、新たに書き込まれた行 から適用され、すでに書き込まれた行は古い値に従って満期を迎えます。値を上げても復活せず、下げても短縮されません。変更するには /etc/kopens/conf/plantpulse-timeseries-engine.conf.template を修正します。
管理コンソール・クエリ コンソール
| 変数 | 基本値 | 意味 | ホストから変更できるか |
|---|---|---|---|
PP_DATALAKE_ADMIN_USER | admin | 管理コンソール ログイン名 | サイドカー |
PP_DATALAKE_ADMIN_PASSWORD | サイドカーが決定 | 管理コンソール パスワード。空の場合、コンソールのみ無効 | passwd.sh |
PP_DATALAKE_ADMIN_API_KEY | なし | ログ エンドポイントの X-API-Key。空の場合、キー認証のみ無効 | passwd.sh |
PP_DATALAKE_ADMIN_PORT | 4949 | コンテナ内のリッスン ポート。4950 は同じコンソールの TLS | いいえ |
PP_DATALAKE_ADMIN_LOGS_ENABLED | true | false の場合、コンソール ログ画面のみ無効 | サイドカー |
PP_DATA_GATEWAY_WEB_USER · PP_DATA_GATEWAY_WEB_PASSWORD | admin · なし | データ ゲートウェイ コンソール(SQL)ログイン。空の場合、そのコンソールのみ閉鎖 | サイドカー |
PP_CEP_WEB_USER · PP_CEP_WEB_PASSWORD | admin · なし | CEP コンソール ログイン。空の場合、そのコンソールのみ閉鎖 | サイドカー |
PP_BACKUP_SCHEDULE_ENABLED | true | バックアップ タイマー グローバル スイッチ | サイドカー |
その他のコンソール設定セット(PP_DATALAKE_ADMIN_PD_PATH · PP_DATALAKE_ADMIN_LOG_ROOT · PP_DATALAKE_ADMIN_BACKUP_HISTORY)は compose がリテラルとして挿入します。変更することはありません。
TLS
| 変数 | 基本値 | 意味 |
|---|---|---|
PP_TLS_ENABLED | true | マスター スイッチ |
PP_TLS_CERT_DIR | /var/security/plantpulse | 証明書 ディレクトリ |
PP_TLS_DOMAIN · PP_TLS_VALID_DAYS | plantpulse.io · 3650 | 証明書 ドメイン・有効期間 |
PP_TLS_SAN_IPS · PP_TLS_SAN_DNS | ホスト IP・ホスト 名 | 証明書 SAN。外部接続 IP を必ず含める |
PP_TLS_NODE_NAMES · PP_MAX_WORKERS | master worker-1 … worker-5 · 5 | ワーカーごとに証明書 1 つ。両方が一致する必要があり、ビルドがパスします |
証明書そのものは plantpulse-certs コンテナが生成します → セキュリティ設定
PD_ で始まる変数
PD_ はデータレイク「ローカル変数」です。オペレータが設定するのは 2 つだけ で、残り 270 余個はスクリプト内部変数またはイメージが焼き込むタイムスタンプです。
| 変数 | 意味 |
|---|---|
PD_HOME | pd が住むツリー。イメージが決定します |
PD_OPTIONS | コンポーネント on/off JSON — {"enable-hive": false}。省略したキーはオン。現在の compose スタックはこの値をコンテナに渡しません → FAQ |
PD_IMAGE_TAG · PD_IMAGE_BUILD_VERSION · PD_IMAGE_BUILT_AT · PD_IMAGE_VCS_REF | イメージ タイムスタンプ。触らないでください — pd env · pd doctor が当てるソースが虚偽になります |
関連ドキュメント
- 環境変数リファレンス — ホスト側全体
- 設定ファイルはどこにあるか
- 設定を変更する方法