Variablenreferenz — was das Data Lake tatsächlich liest

Hier sind nur die Variablen aufgeführt, die der Data-Lake-Container tatsächlich liest. Die maßgeblichen Standardwerte stehen in der Datei plantpulse-datalake-cli/config/defaults.env im Container; Werte, die vom Host übergeben werden, haben Vorrang. Die vollständige Liste der Host-Werte (einschließlich DOCKER_*) finden Sie in der Umgebungsvariablen-Referenz.

«Vorhanden» und «erreichbar» sind nicht dasselbe

Wenn die Spalte «Kann vom Host geändert werden» in der Tabelle unten Nein lautet, wird die Variable zwar im Sidecar definiert, gelangt aber nicht in den Container. Der Grund: compose übergibt diesen Namen nicht an das Data Lake. Der Wert wird durch defaults.env oder die Vorlage festgelegt.

Secrets — was passiert, wenn sie fehlen

Die Secrets, die pd kennt, sind in drei Listen gegliedert. Für keinen dieser Werte existiert ein Standardwert; sie gelangen ausschließlich über Sidecar → compose → Umgebungsvariable in den Container.

Liste	Variablen	Wenn sie fehlen
Erforderlich	`PP_REDIS_PASSWORD` `PP_PG_PASSWORD` `PP_CASSANDRA_PASSWORD` `PP_S3_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` stoppt mit Exit-Code 3 und listet alle fehlenden Namen auf. compose verlangt sie ebenfalls über `:?`, sodass der Stack gar nicht erst startet
Zusätzlich für Worker	`PP_PG_REPLICA_PASSWORD`	Nur auf WORKER-Knoten erforderlich
Optional	`PP_DATALAKE_ADMIN_PASSWORD` `PP_DATALAKE_ADMIN_API_KEY` `PP_DATA_GATEWAY_WEB_PASSWORD` `PP_CEP_WEB_PASSWORD`	Nur diese eine Funktion wird deaktiviert. Der Stack startet normal. `pd doctor` nennt den Namen

Wie Sie sie ändern, steht unter Passwörter und API-Schlüssel ändern. Die drei abgeleiteten Werte (PP_TLS_TRUSTSTORE_PASSWORD · PP_REDIS_TRUSTSTORE_PASSWORD · PP_MQ_TRUSTSTORE_PASSWORD) werden aus dem Keystore-Passwort generiert und nicht separat festgelegt.

Knoten · Adressen

Variable	Standardwert	Bedeutung	Vom Host änderbar
`PP_MODE`	`MASTER`	`MASTER` / `WORKER`. Der Worker bestimmt `worker-add.sh`	Knotendatei
`PP_HOST_IP`	`10.99.0.100` (feste IP im compose-Netzwerk)	Adresse dieses Containers. Grundlage für die Anzeige-Adresse	Über `DOCKER_PP_IP`
`PP_MASTER_IP`	`PP_HOST_IP`	Adresse, unter der andere Systeme dieses Data Lake erreichen	Knotendatei
`PP_SERVICE_IP`	Leer	Öffentliche IP hinter NAT. Wird in das TLS-SAN aufgenommen	Knotendatei `DOCKER_PP_EXTERNAL_IP`
`PP_KAFKA_ADVERTISED_HOST`	Beim Start abgeleitet	Adresse, die Kafka Clients mitteilt	Knotendatei (nur bei NAT · zweites Interface)
`PP_CLUSTER_CORES`	Host-Cores − 2 (4 bis 30)	Anzahl der Kerne, die Spark und andere erhalten	`DOCKER_PP_CLUSTER_CORES`
`PP_DATA_DISK_NAME`	Vom Host erkannt	Gerät, dessen Festplattenauslastung gemessen wird	`DOCKER_PP_DATA_DISK_NAME`
`PP_DATA_DIR` · `PP_TEMP_DIR` · `PP_BACKUP_DIR`	`/data1/pp-data` · `/data1/pp-temp` · `/data1/pp-backup`	Volume-Mount-Pfade	Nein (compose-Literal)
`PP_LANG` · `PP_TZ`	`en` · `Asia/Seoul`	Sprache · Zeitzone	Sidecar

Speicher

Variable	Standardwert	Vom Host änderbar
`PP_REDIS_USER` · `PP_REDIS_PORT`	`redis` · `6379`	Nur Kontoname (Port: nein)
`PP_PG_USER` · `PP_POSTGRES_PORT` · `PP_DB_NAME`	`plantpulse` · `5432` · `pp`	Kontoname · DB-Name (Port: nein)
`PP_CASSANDRA_USER` · `PP_CASSANDRA_PORT` · `PP_KEYSPACE`	`cassandra` · `9042` · `pp`	Kontoname · Keyspace (Port: nein)
`PP_S3_USER` · `PP_S3_PORT` · `PP_S3_BUCKET`	`rustfs` · `9000` · `plantpulse`	Nur Kontoname
`PP_PG_REPLICA_USER`	`replica`	Sidecar

PP_KEYSPACE · PP_DB_NAME · PP_TOPIC_PREFIX sind Bezeichner, die das Data Lake erstellt und die App liest – damit beide sie sich teilen, sind sie im x-pp-secrets-Anker von compose verankert. Wenn Sie sie nach der Installation ändern, entsteht ein leerer Speicher mit dem neuen Namen; die alten Daten bleiben unter dem alten Namen erhalten.

Analyse · Messaging · Zeitreihen · Workflows

Variable	Standardwert	Vom Host änderbar
`PP_HIVE_USER` · `PP_HIVE_PORT` · `PP_HIVE_DB`	`hive` · `9083` · `hive-metastore-230`	Nur Kontoname
`PP_SPARK_USER` · `PP_SPARK_PORT` · `PP_SPARK_WEBUI_PORT` · `PP_KYUUBI_PORT`	`spark` · `7077` · `4440` · `10000`	Nur Kontoname
`PP_GRAVITINO_USER` · `PP_GRAVITINO_ICEBERG_REST_PORT`	`gravitino` · `19001`	Nur Kontoname
`PP_MQ_USER` · `PP_TOPIC_PREFIX`	`mq` · `pp`	Sidecar
`PP_KAFKA_PORT` · `PP_KAFKA_TLS_PORT` · `PP_KAFKA_CONTROLLER_PORT`	`9092` · `9094` · `9093`	Nein
`PP_MQTT_PORT` · `PP_MQTT_TLS_PORT`	`1883` · `1884`	Nein
`PP_TSE_USER` · `PP_TSE_PORT` · `PP_TSE_TLS_PORT` · `PP_TSE_PROTOCOL`	`tse` · `7800` · `7801` · `http`	Nur Kontoname
`PP_TSE_DATAPOINT_TTL`	`31536000` (365 Tage)	Nein — Vorlagenbearbeitung
`PP_TEMPORAL_USER` · `PP_TEMPORAL_PORT`	`temporal` · `7233`	Nur Kontoname
`PP_KESTRA_DB_USER` · `PP_KESTRA_ADMIN_EMAIL` · `PP_KESTRA_PORT`	`kestra` · `admin@plantpulse.io` · `8380`	Kontoname · E-Mail
`PP_CEP_PORT` · `PP_CEP_TLS_PORT` · `PP_CEP_PROTOCOL`	`7400` · `7401` · `http`	Nein
`PP_DATA_GATEWAY_PORT` · `PP_DATA_GATEWAY_TLS_PORT` · `PP_DATA_GATEWAY_PROTOCOL`	`5500` · `5501` · `http`	Nein

PP_TSE_DATAPOINT_TTL — Lebensdauer eines Zeitreihenpunkts

Die Zeitreihen-Engine setzt diese TTL bei jedem Schreibvorgang (INSERT … USING TTL). Wenn Sie den Wert ändern, gilt das nur für neu geschriebene Zeilen; bereits geschriebene Zeilen laufen nach dem alten Wert ab. Erhöhen bringt sie nicht zurück, Verringern verkürzt sie nicht. Zum Ändern bearbeiten Sie /etc/kopens/conf/plantpulse-timeseries-engine.conf.template.

Administrationskonsole · Abfragekonsole

Variable	Standardwert	Bedeutung	Vom Host änderbar
`PP_DATALAKE_ADMIN_USER`	`admin`	Anmeldename für die Administrationskonsole	Sidecar
`PP_DATALAKE_ADMIN_PASSWORD`	Sidecar legt fest	Passwort der Administrationskonsole. Bei leerem Wert wird nur die Konsole deaktiviert	`passwd.sh`
`PP_DATALAKE_ADMIN_API_KEY`	Keine	`X-API-Key` des Protokoll-Endpunkts. Bei leerem Wert wird nur die Schlüsselauthentifizierung deaktiviert	`passwd.sh`
`PP_DATALAKE_ADMIN_PORT`	`4949`	Lauschender Port im Container. 4950 ist TLS derselben Konsole	Nein
`PP_DATALAKE_ADMIN_LOGS_ENABLED`	`true`	Bei `false` wird nur die Konsolenprotokollansicht ausgeblendet	Sidecar
`PP_DATA_GATEWAY_WEB_USER` · `PP_DATA_GATEWAY_WEB_PASSWORD`	`admin` · Keine	Anmeldedaten der Daten-Gateway-Konsole (SQL). Bei leerem Wert wird nur diese Konsole geschlossen	Sidecar
`PP_CEP_WEB_USER` · `PP_CEP_WEB_PASSWORD`	`admin` · Keine	Anmeldedaten der CEP-Konsole. Bei leerem Wert wird nur diese Konsole geschlossen	Sidecar
`PP_BACKUP_SCHEDULE_ENABLED`	`true`	Globaler Schalter für den Backup-Timer	Sidecar

Die übrigen Konsoleneinstellungen (PP_DATALAKE_ADMIN_PD_PATH · PP_DATALAKE_ADMIN_LOG_ROOT · PP_DATALAKE_ADMIN_BACKUP_HISTORY) werden von compose als Literale übergeben. Es gibt keinen Grund, sie zu ändern.

TLS

Variable	Standardwert	Bedeutung
`PP_TLS_ENABLED`	`true`	Master-Schalter
`PP_TLS_CERT_DIR`	`/var/security/plantpulse`	Zertifikatsverzeichnis
`PP_TLS_DOMAIN` · `PP_TLS_VALID_DAYS`	`plantpulse.io` · `3650`	Zertifikatsdomäne · Gültigkeitsdauer
`PP_TLS_SAN_IPS` · `PP_TLS_SAN_DNS`	Host-IP · Hostname	Zertifikats-SAN. Muss die externe Zugriffs-IP enthalten
`PP_TLS_NODE_NAMES` · `PP_MAX_WORKERS`	`master worker-1 … worker-5` · `5`	Ein Zertifikat pro Worker. Beide müssen zusammenpassen, sonst schlägt der Build fehl

Die Zertifikate selbst erstellt der plantpulse-certs-Container → Sicherheitseinstellungen

Variablen, die mit `PD_` beginnen

PD_ sind die «lokalen Variablen» des Data Lake. Der Betreiber legt nur zwei davon fest; die übrigen rund 270 sind interne Skriptvariablen oder Stempel, die das Image einbrennt.

Variable	Bedeutung
`PD_HOME`	Baum, in dem `pd` liegt. Wird vom Image festgelegt
`PD_OPTIONS`	Komponenten-on/off-JSON — `{"enable-hive": false}`. Ausgelassene Schlüssel sind aktiviert. Der aktuelle compose-Stack übergibt diesen Wert nicht an den Container → FAQ
`PD_IMAGE_TAG` · `PD_IMAGE_BUILD_VERSION` · `PD_IMAGE_BUILT_AT` · `PD_IMAGE_VCS_REF`	Image-Stempel. Nicht anfassen — `pd env` · `pd doctor` würden sonst eine falsche Herkunft anzeigen

Secrets — was passiert, wenn sie fehlen​

Knoten · Adressen​

Speicher​

Analyse · Messaging · Zeitreihen · Workflows​

Administrationskonsole · Abfragekonsole​

TLS​

Variablen, die mit PD_ beginnen​

Verwandte Dokumente​