Dockercontainer für Kivitendo und lxcars

Ich habe mich in den letzten Tagen etwas intensiver mit Docker auseinandergesetzt. Entstanden sind zwei Docker Container für den Betrieb von Kivitendo und lxcars.

Kivitendo (www.kivitendo.de) ist eine opensource ERP Lösung für KMUs. Die Lösung kann recht gut an die Bedürfnisse einer KMU angepasst werden. Daneben besitzt Kivitendo eine breite Community im deutschsprachigen Raum. Als Erweiterung zu Kivitendo spezifisch für Garagen und Autohändler bietet sich lxcars an. Da ich mich für die Funktion von lxcars interessiert habe und dazu eine Testinstallation aufstzen wollte habe ich das ganze mit Docker realisiert.

Installation

Die fertigen Container sind in der Docker Registry zu finden:

https://registry.hub.docker.com/u/drnoa/kivitendo-docker/

und für lxcars

https://registry.hub.docker.com/u/drnoa/lxcars-docker/

Um diese zu verwenden, kann ganz einfach der Dockercontainer von der Registry geholt werden:

#!code /bin/bash
docker pull drnoa/kivitendo-docker

oder

#!code /bin/bash
docker pull drnoa/lxcars-docker

alternativ kann der Docker Container auch vom Dockerfile gebaut werden. Dazu einfach das Dockerfile und die benötigten Config-Vorlagen von Github klonen.

Dockerfile von Github:
https://github.com/drnoa/kivitendo_docker
und für lxcars
https://github.com/drnoa/lxcars_docker

#!code /bin/bash
git clone https://github.com/drnoa/kivitendo_docker.git
cd kivitendo_docker
sudo docker build .

Wenn der Dockercontainer direkt vom Dockerfile gebaut wird besteht der Vorteil, dass die Configfiles und Variablen den eigenen Bedürfnissen angepasst werden können.
Im Dockerfile habe ich folgende Parameter definiert:

ENV postgresversion 9.3
ENV locale de_CH
ENV postrespassword docker

So wird es möglich die Postgresversion frei zu wählen, dasselbe gild für das Locale. Bei der Installation werden zudem 2 Postgres Benutzer (docker und kivitendo) erstellt. Für beide Benutzer kann mittels der Variable postgrespassword ein Passwort definiert werden.

Die gesamte Anleitung inkl. aller möglichen zusätzlichen Informationen ist auch auf Github zu finden.

Inbetriebnahme Kititendo

Nach erfolgreichem bau des Containers oder pull von der Registry kann der Container mittels

#!code /bin/bash
sudo docker run drnoa/kivitendo-docker

gestartet werden. Vom erstellen Container werden automatisch die Ports 80 (Apache Webserver) und 5432 (Postgres Server) verwendet. Docker wird dabei eine interne IP Adresse zugewiesen. Alle aktuell laufenden Container können mittels

#!code /bin/bash
sudo docker ps -a

angezeigt werden. Und die verwendete IP Adresse findet ihr mittels:

#!code /bin/bash
sudo docker ps -q | xargs docker inspect | grep IPAddress | cut -d '"' -f 4

Alle laufenden Container stoppen ist mit folgedem Befehl möglich:

#!code /bin/bash
sudo docker stop $(sudo docker ps -a -q)

Nach erfolgreichem starten des Containers müssen noch die letzten Schritte der Installation im Browser gemacht werden.

Dazu die Administration öffnen und die Datenbank anlegen. Als DB Benutzer und Passwort kann beide male “docker” eingegeben werden. Bzw. das Passwort das über die Variable postrespassword definiert wurde. Danach noch die Mandantendatenbank, eine Gruppe und einen Benutzer einrichten.
Nach dem Login mit dem erstellen Benutzer noch die restlichen Installationsschritte durchgehen. Fertig ist die Kivitendo Installation.

Inbetriebnahme lxcars

Die Installation ist Grundsätzlich identisch zur Kivitendo Inbetriebnahme.

#!code /bin/bash
sudo docker run drnoa/lxcars-docker

Auch hier müssen die letzten Schritte im Browser erledigt werden. Nebst dem Mandanten, dem Benutzer müssen auch noch eine „Admin“ und eine „Werkstatt“ Gruppe erstellt werden. Die Installationsschritte sind auch auf der Projektseite von lxcars beschrieben.

Upgrade und Persistenz der Datenbank

Damit bei mehrmaligem ausführen des Docker Containers die Datenbank nicht jedes mal neu aufgesetzt wird muss ein persistente Verbindung zur Datenbank hergestellt werden.
Dazu wird ein /var/lib/postgresql in den Container gemountet.

#!code /bin/bash
sudo docker run --name postgresql -d \
  -v /opt/postgresql/data:/var/lib/postgresql drnoa/kivitendo_docker:latest

Viel Spass bei Kivitendo und lxcars.