Konfiguration von InfluxDB

InfluxDB wird üblicherweise in die Gesamtkonfiguration von SOLECTRUS integriert, d.h. die Dateien compose.yaml und .env enthalten auch die Konfiguration für InfluxDB.

compose.yaml

services:
  influxdb:
    image: influxdb:2.7-alpine
    volumes:
      - ${INFLUX_VOLUME_PATH}:/var/lib/influxdb2
    environment:
      - TZ
      - DOCKER_INFLUXDB_INIT_MODE=setup
      - DOCKER_INFLUXDB_INIT_USERNAME=${INFLUX_USERNAME}
      - DOCKER_INFLUXDB_INIT_PASSWORD=${INFLUX_PASSWORD}
      - DOCKER_INFLUXDB_INIT_ORG=${INFLUX_ORG}
      - DOCKER_INFLUXDB_INIT_BUCKET=${INFLUX_BUCKET}
      - DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=${INFLUX_ADMIN_TOKEN}
    command: influxd run --bolt-path /var/lib/influxdb2/influxd.bolt --engine-path /var/lib/influxdb2/engine --store disk
    restart: unless-stopped
    healthcheck:
      test:
        - CMD
        - influx
        - ping
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 30s
    logging:
      driver: json-file
      options:
        max-size: 10m
        max-file: '3'
    labels:
      - com.centurylinklabs.watchtower.scope=solectrus

  watchtower:
    # ...

Hinweis

Einige Variablen für den Service werden anders lautenden Umgebungsvariablen entnommen. Dies ermöglicht eine Nutzung von Variablen für verschiedene Services und vermeidet Redundanzen.

Name der Variablen in .env	Name der Variablen im Service
INFLUX_USERNAME	DOCKER_INFLUXDB_INIT_USERNAME
INFLUX_PASSWORD	DOCKER_INFLUXDB_INIT_PASSWORD
INFLUX_ORG	DOCKER_INFLUXDB_INIT_ORG
INFLUX_BUCKET	DOCKER_INFLUXDB_INIT_BUCKET
INFLUX_ADMIN_TOKEN	DOCKER_INFLUXDB_INIT_ADMIN_TOKEN

Umgebungsvariablen (.env)

TZ

Zeitzone gemäß Liste

Beispiel

TZ=Europe/Berlin

DOCKER_INFLUXDB_INIT_ORG

Organisation, mit der die Benutzer und Daten in InfluxDB gruppiert werden. Für die Nutzung von SOLECTRUS ist die Organisation sinnvollerweise solectrus zu nennen, weitere Organisationen werden nicht benötigt.

Beispiel

DOCKER_INFLUXDB_INIT_ORG=solectrus

Hinweis

Diese Variable wirkt sich nur auf den ersten Start von InfluxDB aus, wenn noch keine Datenbank vorhanden ist. Ein späteres Ändern dieser Variable hat keine Auswirkung.

DOCKER_INFLUXDB_INIT_USERNAME

Gewünschter Benutzername für den Administrator-Zugriff (per Login) auf InfluxDB. Der Administrator wird beim ersten Start von InfluxDB angelegt.

Beispiel

DOCKER_INFLUXDB_INIT_USERNAME=admin

Hinweis

Diese Variable wirkt sich nur auf den ersten Start von InfluxDB aus, wenn noch keine Datenbank vorhanden ist. Ein späteres Ändern dieser Variable hat keine Auswirkung.

DOCKER_INFLUXDB_INIT_PASSWORD

Gewünschtes Passwort für den Administrator-Zugriff (per Login) auf InfluxDB. Der Administrator wird beim ersten Start von InfluxDB angelegt.

Beispiel

DOCKER_INFLUXDB_INIT_PASSWORD=ExAmPl3PA55W0rD

Hinweis

Diese Variable wirkt sich nur auf den ersten Start von InfluxDB aus, wenn noch keine Datenbank vorhanden ist. Ein späteres Ändern dieser Variable hat keine Auswirkung.

DOCKER_INFLUXDB_INIT_ADMIN_TOKEN

Token für den Administrator-Zugriff auf InfluxDB, das für die Authentifizierung (per API) verwendet wird und Zugriff auf alles gewährt. Das Token wird beim ersten Start von InfluxDB angelegt.

Beispiel

DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=my-super-secret-admin-token

Hinweis

Diese Variable wirkt sich nur auf den ersten Start von InfluxDB aus, wenn noch keine Datenbank vorhanden ist. Ein späteres Ändern dieser Variable hat keine Auswirkung.

DOCKER_INFLUXDB_INIT_BUCKET

Anzulegender Bucket für die Aufnahme der Messwerte. Das ist die Datenbank, in der die Messwerte gespeichert werden. Der Bucket wird beim ersten Start von InfluxDB angelegt. SOLECTRUS verwendet nur einen Bucket, dieser wird daher sinnvollerweise solectrus benannt.

Beispiel

DOCKER_INFLUXDB_INIT_BUCKET=solectrus

Hinweis

Diese Variable wirkt sich nur auf den ersten Start von InfluxDB aus, wenn noch keine Datenbank vorhanden ist. Ein späteres Ändern dieser Variable hat keine Auswirkung.

INFLUX_VOLUME_PATH

Pfad, in dem die Datenbank gespeichert wird. Dieser Pfad wird als Volume in den Container gemountet. Der Pfad sollte auf einem Datenträger mit ausreichend Speicherplatz liegen.

Wenn am angegebenen Pfad bereits eine Datenbank existiert, wird diese verwendet. Andernfalls wird eine neue Datenbank angelegt. Dies ist normalerweise nur beim ersten Start des Containers der Fall.

Beispiel

INFLUX_VOLUME_PATH=/somewhere/solectrus/influxdb