Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
Betrieb von Middleware und Frontend im Docker-Container
Der Betrieb von Volkszaehler im Docker-Container ist durchaus eine Alternative, sofern beispielsweise mehrere Anwendungen auf einem Server laufen oder der Anwender auf stark „vorgefertigte“ Komponenten zurückgreifen möchte.
Vorgefertigte Container
Im Docker-Hub gibt es vom Volkszaehler Projekt vorgefertigte Container. Dieser Beitrag bezieht sich ausschließlich auf den offiziellen Container https://hub.docker.com/r/volkszaehler/volkszaehler. Es gibt auch eine Vielzahl von inoffiziellen Container; teilweise mit anderer Bauart.
Ist der fertige Container direkt einsatzfähig?
Die Antwort lautet ganz klar Jein.
Ein Blick in das Docker-Compose File https://github.com/volkszaehler/volkszaehler.org/blob/master/docker-compose.yml zeigt uns, dass hier neben dem Volkszaehler noch eine Datenbank (MariaDB) und der Push-Server enthalten sind. Die Nutzung des fertigen Docker-Compose Files führt dazu, dass neben dem Volkszaehler auch eine neue Datenbankinstanz erzeugt wird. Wer „auf der grünen Wiese“ anfangen möchte, hat hiermit eine schnelle und unkomplizierte Lösung zur Hand. Wer allerdings bereits eine existierende Volkszaehler-Instanz mit einer separaten Datenbank hat oder ggf. MySQL verwenden möchte, stößt mit dem Lösungsansatz schnell an die Grenzen. Auch die Benutzerdaten und Datenbanknamen für die Datenbank sind in Volkszaehler fest vorgegeben. Credentials und DB-Namen müssen in der Datenbank zu den vordefinierten Werten in Volkszähler passen:
MYSQL_DATABASE: volkszaehler MYSQL_USER: vz MYSQL_PASSWORD: demo MYSQL_ROOT_PASSWORD: admin_demo
Individuelle/angepasste Lösung
Wem diese Vorgaben nicht in der Konzept passen, muss leichte Veränderungen an dem vorgefertigten Image vornehmen.
Zunächst erfolgt der Clone des gesamten Repositories in ein beliebiges Verzeichnis:
git clone git://github.com/volkszaehler/volkszaehler.org.git ~/volkszaehler.org
Aus diesem Clone benötigten wir folgende Dateien:
~/volkszaehler.org/etc/config.dist.yaml ~/volkszaehler.org/htdocs/js/options.js
In der config.dist.yaml muss der Datenbank Host und Passwort angepasst werden. Beispiel:
sed -i 's/ host: localhost/ host: mysqldb/g' config.dist.yaml sed -i 's/ password: demo/ password: volkszaehler_password/g' config.dist.yaml
In der options.js kann (optional!) der Demo-Server deaktiviert werden.
Die Dateien config.dist.yaml und ggf. options.js werden nach der Modifikation in einem neuen Order erstellt. In diesem Ordner erstellen wir ebenfalls jetzt das Dockerfile mit folgendem Inhalt:
FROM volkszaehler/volkszaehler workdir . COPY config.dist.yaml /vz/etc/config.yaml COPY options.js /vz/htdocs/js/options.js
Im Nachgang kann der Dockerbuild Prozess gestartet werden. Ich habe dies ebenfalls über ein kleines Script gelöst:
#Adjust to local path for dockerfile, modified config.yaml, modified options.js cd ~/docker/build/20210325_volkszaehler #Definition of Datetime for Tag dt=$(date +'%Y-%m-%d_%H-%M'); docker build . -t volkszaehler:$dt
Nach dem Build-Prozess kann der Container mit den persönlichen Anmeldedaten über ein docker-compose.yml File gestartet werden. Anbei ein Beispiel für ein minimalistisches Compose File.
version: '3' services: volkszaehler: image: volkszaehler:2021-03-25_23-57 ports: - 8080:8080 restart: always
offene Punkte
- Aggregationen in der Middleware
- Mapping der Config-Files ohne erneutes Docker Build
- Deaktivierung Volkszaehler Demo Kanäle
- Überprüfung des Ansatzes für den Push-Server