Docker/Grundlagen/08 Container-Kommunikation: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(38 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Kommunikation zwischen mehreren Containern ==
'''Docker/Grundlagen/08 Container-Kommunikation''' - Kommunikation zwischen Containern
Für viele Container-Anwendungen gilt: Ein Container kommt selten allein! Sobald aber mehrere Container gleichzeitig ausgeführt werden, stellt sich die Frage, wie sie miteinander kommunizieren.
* Das gelingt am einfachsten über ein internes Netzwerk, das Sie mit docker network einrichten.
Die in diesem Abschnitt vorgestellten Kommandos zeigen die Kombination von drei Containern mit MariaDB, phpMyAdmin und WordPress.
* Die Beispiele funktionieren unverändert auch mit Rootless Docker und mit Podman.


Mehr Komfort mit »compose«
=== Beschreibung ===
; Viele Container-Anwendungen bestehen aus mehreren Containern
* Daher wird ein Weg zur Kommunikation benörigt
* Dazu können interne Docker-Netzwerke verwendet werden


Wir zeigen Ihnen hier das manuelle Einrichten eines Docker-Netzwerks sowie mehrerer Container primär aus didaktischen Gründen.
; Beispiel<nowiki>:</nowiki> WordPress
* Wir wollen, dass Sie verstehen, wie Docker funktioniert.
Drei Container
In der Praxis ist es wesentlich effizienter, derartige Setups mit den Kommandos docker compose bzw. podman-compose zu bewerkstelligen.
* MariaDB
* Wie Sie dazu vorgehen, lernen Sie in Kapitel 5, »Container-Setups mit compose«.
* phpMyAdmin
* WordPress


Privates Docker-Netzwerk einrichten
=== Privates Docker-Netzwerk einrichten ===
; Einrichten eines Docker-Netzwerks
<syntaxhighlight lang="bash" highlight="1" line copy>
docker network create testnet
</syntaxhighlight>


Das Einrichten eines Docker-Netzwerks ist denkbar einfach:
=== MariaDB ===
; Start des Datenbanksystems
MariaDB soll beim ersten Start eine leere Datenbank (wp) sowie einen neuen Account (wpuser) samt Passwort anlegen
* Auf diesen Account erhalten später phpMyAdmin und WordPress Zugriff
* Das MariaDB-Image kümmert sich um die notwendigen Initialisierungsarbeiten, wenn Sie die Variablen
** MYSQL_DATABASE
** MYSQL_USER
** MYSQL_PASSWORD
: mit -e an docker run übergeben


docker network create testnet
; root-Passwort von MariaDB
Hier ist es nicht erforderlich, dass das root-Passwort von MariaDB den anderen Containern bekannt ist
* -e MYSQL_RANDOM_ROOT_PASSWORD=1 erzeugt ein zufälliges Passwort


MariaDB
; Network
''--network'' verbindet den Container mit dem vorhin erzeugten Netzwerk


Schon deutlich komplizierter ist der Start des Datenbanksystems.
; Befehl
* Die Verwendung von MariaDB ist Ihnen ja aus den bisherigen Beispielen prinzipiell vertraut.
<syntaxhighlight lang="bash" highlight="" line copy>
* Diesmal ändern sich aber ein paar Details:
docker run -d --name mariadb-test \
-h mariadb-test \
--network testnet \
-e MYSQL_RANDOM_ROOT_PASSWORD=1 \
-e MYSQL_DATABASE=wp \
-e MYSQL_USER=wpuser \
-e MYSQL_PASSWORD=geheim \
-v myvolume:/var/lib/mysql \
mariadb
</syntaxhighlight>


Wir möchten, dass MariaDB beim ersten Start eine leere Datenbank (wp) sowie einen neuen Account (wpuser) samt Passwort anlegt.
=== phpMyAdmin ===
* Auf diesen Account erhalten später phpMyAdmin und WordPress Zugriff.
Weboberfläche zur Administration von MariaDB
* Das MariaDB-Image kümmert sich um die notwendigen Initialisierungsarbeiten, wenn Sie die Variablen MYSQL_DATABASE , MYSQL_USER und MYSQL_PASSWORD mit -e an docker run übergeben.
Für das Beispiel ist es nicht erforderlich, dass das root-Passwort von MariaDB den anderen Containern bekannt ist.
* Dank -e MYSQL_RANDOM_ROOT_PASSWORD=1 verwendet MariaDB einfach ein zufälliges Passwort.
Neu ist auch die Option --network , die den Container mit dem vorhin erzeugten Netzwerk verbindet.
Somit ergibt sich eine schon etwas komplexere Abfolge von Optionen für den Start des MariaDB-Containers:


docker run -d --name mariadb - test \
; Start des Containers
-h mariadb - test
<syntaxhighlight lang="bash" highlight="" line copy>
--network testnet \
docker run -d --name pma \
-e MYSQL_RA ND O M _ RO O T _ P AS S W O R D =1 \
--network testnet \
-e MYSQL_DA TA B A S E = wp \
-p 8080:80 \
-e MYSQL_US ER = wpuser \
-e PMA_HOST=mariadb-test \
-e MYSQL_PA SS W O R D = geheim \
phpmyadmin/phpmyadmin
-v myvolume :/ var /lib / mysql \
</syntaxhighlight>
mariadb


; Optionen
{| class="table table-striped table-hover col1bold col1nowrap"
|-
! Option !! Beschreibung
|-
| --network || verbindet auch diesen Container mit dem privaten Netzwerk dieses Beispiels
|-
| -p || bewirkt, dass die Weboberfläche (Port 80 im Container) auf dem Host-System unter Port 8080 angesprochen werden kann
|-
|| -e PMA_HOST || Dank der Variablen PMA_HOST weiß der phpMyAdmin-Container, unter welchem Host-Namen der MariaDB-Server im Netzwerk läuft
* Docker-Netzwerke kümmern sich automatisch um die netzwerkinterne Namensauflösung, wobei die mit --name angegebenen Namen gelten
|-
| -s || Wie MariaDB wird auch der phpMyAdmin-Container im Hintergrund ausgeführt (Option -d)
* Um zu testen, ob alles funktioniert, öffnen Sie im Webbrowser Ihres Rechners die Adresse localhost:8080
* Sie müssen sich beim Datenbankserver mit dem Accountnamen ''wpuser'' und dem Passwort ''geheim'' anmelden
|}


phpMyAdmin
; root-Zugriff in phpMyAdmin
: Sollen alle Datenbanken von MariaDB zu sehen sein, müssen Sie beim Start des MariaDB-Containers ein root-Passwort festlegen
:* Dann gelingt in phpMyAdmin der Login mit root und dem dazugehörigen Passwort
:* In diesem Beispiel ist das nicht möglich, weil das root-Passwort wegen der Variablen MYSQL_RANDOM_ROOT_PASSWORD=1 zufällig bestimmt wurde


=== WordPress ===
Wie lange haben Sie das letzte Mal gebraucht, um auf einem Server WordPress zu installieren?
* Wenn Sie das regelmäßig machen, vermutlich nur ein paar Minuten
* Beim ersten Mal dauert es oft viel länger, bis das Fundament, das aus Apache, PHP und MySQL oder MariaDB besteht, mit all seinen Zusatzpaketen installiert und konfiguriert ist


phpMyAdmin ist eine populäre Weboberfläche zur Administration von MariaDB
; Docker
(siehe Abbildung 3.2).
Einmal vorausgesetzt, dass Sie bereits einen MySQL- oder MariaDB-Container eingerichtet haben, ist zur Inbetriebnahme von WordPress lediglich das folgende, zugegebenermaßen nicht ganz kurze Kommando notwendig


Abbildung 3.2 phpMyAdmin und der MariaDB-Server laufen in zwei voneinander getrennten Containern.
<syntaxhighlight lang="bash" highlight="" line copy>
docker run -d --name wordpress-test \
--network testnet \
-h wordpress-test \
-v wp-html:/var/www/html/wp-content \
-p 8081:80 \
-e WORDPRESS_DB_HOST=mariadb-test \
-e WORDPRESS_DB_USER=wpuser \
-e WORDPRESS_DB_NAME=wp \
-e WORDPRESS_DB_PASSWORD=geheim \
wordpress
</syntaxhighlight>


Der Start des entsprechenden Containers gelingt unkompliziert:
; Optionen
* -d bewirkt den Start des Containers als Hintergrunddienst
* --name gibt dem Container seinen Namen
* --network testnet sorgt dafür, dass der WordPress-Container im gleichen Netzwerk wie der MariaDB-Server und phpMyAdmin läuft
* -v macht aus/var/www/html/wp-content ein Volume mit dem Namen wp-html
** In diesem Verzeichnis werden hochgeladene Bilder, Plugins etc. gespeichert, also alle Daten, die nichts mit der eigentlichen WordPress-Installation zu tun haben
* Der Volume-Name erleichtert die weitere Administration des Containers, z.&nbsp;B.&nbsp;bei Updates oder beim Löschen
* Alle hochgeladenen Dateien und Erweiterungen bleiben dabei im Volume erhalten
Mit -p geben Sie an, unter welchem Port die WordPress-Installation auf dem Docker-Host angesprochen werden kann
* Da Port 8080 im vorigen Beispiel schon für phpMyAdmin zum Einsatz kam, haben wir jetzt eben 8081 verwendet
* Sofern Sie Docker mit root-Rechten ausführen und auf Ihrem Host-Rechner Port 80 frei ist, können Sie natürlich auch -p 80:80 angeben
* Die Variablen WORDPRESS_DB_HOST,_USER,_PASSWORD und _NAME geben an, unter welchem Host-Namen der MySQL- oder MariaDB-Server läuft, welcher Login-Name und welches Passwort beim Verbindungsaufbau verwendet werden sollen und wie der Name der Datenbank lautet
* Diese Datenbank muss bereits existieren. (Im Gegensatz zu früheren Versionen des WordPress-Images wird die Datenbank nicht erzeugt.)


docker run -d --name pma \
; Aufruf
--network testnet \
Unter der Adresse http://localhost:8081 nehmen Sie die Website nun in Betrieb
-p 8080:80 \
* Die Anfangskonfiguration beschränkt sich auf zwei Dialoge: Auf der ersten Seite wählen Sie die gewünschte Sprache aus, auf der zweiten Seite richten Sie den WordPress-Administrator ein
-e PMA_HOST =mariadb - test \
* Die oft heikle Konfiguration der Zugangsdaten des Datenbankservers entfällt: Darum hat sich ein Script des WordPress-Containers bereits gekümmert
phpmyadm i n / phpmyadmi n


Ein paar Anmerkungen zu den Optionen
Als Host-Namen müssen Sie den Namen (Option --name) des MariaDB-Containers angeben
* Die Loginund Datenbank-Namen müssen mit den Angaben übereinstimmen, die Sie beim Start von MariaDB mit den Optionen MYSQL_USER , MYSQL_PASSWORD und MYSQL_DATABASE verwendet haben


Die Option --network verbindet auch diesen Container mit dem privaten Netzwerk dieses Beispiels.
; Weitere Informationen zu den Umgebungsvariablen des offiziellen WordPress-Images
-p bewirkt, dass die Weboberfläche (Port 80 im Container) auf dem Host-System unter Port 8080 angesprochen werden kann.
: https://hub.docker.com/_/wordpress
Dank der Variablen PMA_HOST weiß der phpMyAdmin-Container, unter welchem Host-Namen der MariaDB-Server im Netzwerk läuft.
* Docker-Netzwerke kümmern sich automatisch um die netzwerkinterne Namensauflösung, wobei die mit --name angegebenen Namen gelten.


Wie MariaDB wird auch der phpMyAdmin-Container im Hintergrund ausgeführt
=== Container stoppen und neu starten ===
(Option -d).
Wenn Sie die drei Container vorübergehend nicht mehr brauchen, können Sie sie stoppen und dann bei Bedarf wieder neu starten
* Um zu testen, ob alles funktioniert, öffnen Sie im Webbrowser Ihres Rechners die Adresse localhost:8080.
* docker stop/start können mehrere Container-Namen übergeben werden
* Sie müssen sich beim Datenbankserver mit dem Accountnamen wpuser und dem Passwort geheim anmelden.
* Danach können Sie über die Weboberfläche die in den Tabellen enthaltenen Daten abfragen, neue Tabellen einrichten usw.


root-Zugriff in phpMyAdmin
; docker stop
<syntaxhighlight lang="bash" highlight="1" line copy>
docker stop mariadb-test pma wordpress-test
</syntaxhighlight>


Wenn Sie in phpMyAdmin nicht nur die Datenbank wp, sondern alle Datenbanken von MariaDB sehen wollen, müssen Sie beim Start des MariaDB-Containers wie in den bisherigen Abschnitten ein root-Passwort festlegen.
; docker start
* Dann gelingt in php- MyAdmin der Login mit root und dem dazugehörigen Passwort.
<syntaxhighlight lang="bash" highlight="1" line copy>
* In diesem Beispiel ist das nicht möglich, weil das root-Passwort wegen der Variablen MYSQL_RANDOM_
docker start mariadb-test pma wordpress-test
ROOT_PASSWORD=1 zufällig bestimmt wurde.
</syntaxhighlight>


WordPress
=== Updates ===
 
Wenn es von MariaDB, phpMyAdmin und WordPress neue Images gibt, können Sie wie folgt eine Neuinstallation durchführen
Wie lange haben Sie das letzte Mal gebraucht, um auf einem Server WordPress zu installieren? Wenn Sie das regelmäßig machen, vermutlich nur ein paar Minuten –
<syntaxhighlight lang="bash" highlight="1" line copy>
aber beim ersten Mal dauert es oft viel länger, bis das Fundament, das aus Apache, PHP und MySQL oder MariaDB besteht, mit all seinen Zusatzpaketen installiert und konfiguriert ist.
docker stop mariadb-test pma wordpress-test
Deutlich schneller geht es mit Docker.
</syntaxhighlight>
* Einmal vorausgesetzt, dass Sie bereits einen MySQL- oder MariaDB-Container eingerichtet haben, ist zur Inbetriebnahme von WordPress lediglich das folgende, zugegebenermaßen nicht ganz kurze Kommando notwendig:
 
docker run -d --name wordpress -test \
--network testnet \
-h wordpress - test \
-v wp -html :/ var / www / html / wp - content \
-p 8081:80 \
-e WORDPRES S_ D B _ HO S T = mariadb -test \
-e WORDPRES S_ D B _ US E R = wpuser \
-e WORDPRES S_ D B _ NA M E = wp \
-e WORDPRES S_ D B _ PA S S W O RD = geheim \
wordpres s
 
Unter der Adresse http://localhost:8081 nehmen Sie die Website nun in Betrieb (siehe Abbildung 3.3).
* Die Anfangskonfiguration beschränkt sich auf zwei Dialoge: Auf der ersten Seite wählen Sie die gewünschte Sprache aus, auf der zweiten Seite richten Sie den WordPress-Administrator ein.
* Die oft heikle Konfiguration der Zugangsdaten
 
des Datenbankservers entfällt: Darum hat sich ein Script des WordPress-Containers bereits gekümmert.
 
Abbildung 3.3 WordPress komplettiert das Beispiel in einem dritten Container.
 
Nur zur Erklärung der docker-run-Optionen
 
-d bewirkt den Start des Containers als Hintergrunddienst.
--name gibt dem Container seinen Namen.
--network testnet sorgt dafür, dass der WordPress-Container im gleichen Netzwerk wie der MariaDB-Server und phpMyAdmin läuft.
-v macht aus /var/www/html/wp-content ein Volume mit dem Namen wp-html.
* In diesem Verzeichnis werden hochgeladene Bilder, Plugins etc.
* gespeichert, also alle Daten, die nichts mit der eigentlichen WordPress-Installation zu tun haben.
Der Volume-Name erleichtert die weitere Administration des Containers, z.&nbsp;B.&nbsp;bei Updates oder beim Löschen.
* Alle hochgeladenen Dateien und Erweiterungen bleiben dabei im Volume erhalten.
Mit -p geben Sie an, unter welchem Port die WordPress-Installation auf dem Docker-Host angesprochen werden kann.
* Da Port 8080 im vorigen Beispiel schon für phpMyAdmin zum Einsatz kam, haben wir jetzt eben 8081 verwendet.
* Sofern Sie Docker mit root-Rechten ausführen und auf Ihrem Host-Rechner Port 80 frei ist, können Sie natürlich auch -p 80:80 angeben.
Die Variablen WORDPRESS_DB_HOST , _USER, _PASSWORD und _NAME geben an, unter welchem Host-Namen der MySQL- oder MariaDB-Server läuft, welcher Login-Name und welches Passwort beim Verbindungsaufbau verwendet werden sollen und wie der Name der Datenbank lautet.
* Diese Datenbank muss bereits existieren. (Im Gegensatz zu früheren Versionen des WordPress-Images wird die Datenbank nicht erzeugt.)
Als Host-Namen müssen Sie den Namen (Option --name) des MariaDB-Containers angeben.
* Die Loginund Datenbank-Namen müssen mit den Angaben übereinstimmen, die Sie beim Start von MariaDB mit den Optionen MYSQL_USER , MYSQL_PASSWORD und MYSQL_DATABASE verwendet haben.


Weitere Umgebungsvariablen des offiziellen WordPress-Images sind hier dokumentiert:
<syntaxhighlight lang="bash" highlight="1" line copy>
* https://hub.docker.com/_/wordpress
docker rm mariadb-test pma wordpress-test
</syntaxhighlight>


Docker-Baukasten
<syntaxhighlight lang="bash" highlight="1" line copy>
docker pull mariadb
</syntaxhighlight>


Es ist uns an dieser Stelle nur darum gegangen, einfache Beispiele zu präsentieren, die den Einsatz von Docker zeigen.
<syntaxhighlight lang="bash" highlight="1" line copy>
* Deutlich mehr Details zur praktischen Nutzung von Webservern (Apache, Nginx), Datenbanksystemen (MariaDB, MySQL etc.), Webapplikationen (WordPress, Joomla, Nextcloud etc.) folgen in Teil II dieses Buchs, in dem wir Ihnen eine Menge Docker-Images vorstellen.
docker pull phpmyadmin/phpmyadmin
* Diese Images sind wie ein Baukasten, aus dem Sie Ihre eigenen Applikationen zusammenstellen können.
</syntaxhighlight>


Container stoppen und neu starten
<syntaxhighlight lang="bash" highlight="1" line copy>
docker pull wordpress
</syntaxhighlight>


Wenn Sie die drei Container vorübergehend nicht mehr brauchen, können Sie sie stoppen und dann bei Bedarf wieder neu starten.
<syntaxhighlight lang="bash" highlight="1" line copy>
* Erfreulicherweise können Sie an docker stop bzw. docker start mehrere Container-Namen auf einmal übergeben.
docker run -d --name mariadb-test \
-h mariadb-test \
--network testnet \
-v myvolume:/var/lib/mysql mariadb
</syntaxhighlight>


docker stop mariadb - test pma wordpress - test
...
docker start mariadb - test pma wordpress - test


Updates
<syntaxhighlight lang="bash" highlight="1" line copy>
docker run -d --name pma --network testnet \
-p 8080:80 \
-e PMA_HOST=mariadb-test \
phpmyadmin/phpmyadmin
</syntaxhighlight>


Wenn es von MariaDB, phpMyAdmin und WordPress neue Images gibt, können Sie wie folgt eine Neuinstallation durchführen:
<syntaxhighlight lang="bash" highlight="1" line copy>
docker run -d --name wordpress -test \
--network testnet \
-h wordpress-test \
-v wp -html:/var/www/html/wp-content \
-p 8081:80 \
-e WORDPRESS_DB_HOST=mariadb-test \
-e WORDPRESS_DB_USER=wpuser \
-e WORDPRESS_DB_NAME=wp \
-e WORDPRESS_DB_PASSWORD=geheim \
wordpress
</syntaxhighlight>


docker stop mariadb - test pma wordpress - test
Vergleich zur Erstinstallation
docker rm  mariadb - test pma wordpress - test
''docker run'' für MariaDB kürzer
* weil die vorhandene Datenbank sowie alle Passwörter weitergenutzt werden
* Diese Daten befinden sich in ''myvolume''


docker pull mariadb
Bei phpMyAdmin bleibt ''docker run'' unverändert
docker pull phpmyadmi n / phpmyadmi n
* Erstaunlicherweise gilt dies auch für den Start des WordPress-Containers
docker pull wordpress
* Hier hätte man annehmen können, dass die Konfigurationsdaten ebenfalls dauerhaft im Volume gespeichert wären
* Tatsächlich enthält die entscheidende Konfigurationsdatei wp_config.php aber Code, der die Umgebungsvariablen auswertet
* Fehlen die Umgebungsvariablen, scheitert der Verbindungsaufbau zwischen WordPress und dem Datenbankserver


  docker run -d --name mariadb - test \
; Wiederverwendung der Volumes
-h mariadb - test \
Dank der Wiederverwendung der Volumes bleiben bei dem Update alle Daten (also die Tabellen der wp-Datenbank, Blog-Beiträge in WordPress etc.) erhalten
--network testnet \
-v myvolume :/ var /lib / mysql mariadb


docker run -d --name pma --network testnet \
=== Aufräumen ===
-p 8080:80 \
Komponenten des Beispiels löschen
-e PMA_HOST =mariadb - test \
phpmyadm i n / phpmyadmi n


docker run -d --name wordpress -test \
; Container anhalten
--network testnet \
<syntaxhighlight lang="bash" highlight="1" line copy>
-h wordpress - test \
docker stop mariadb-test pma wordpress-test
-v wp -html :/ var / www / html / wp - content \
</syntaxhighlight>
-p 8081:80 \
-e WORDPRES S_ D B _ HO S T = mariadb -test \
-e WORDPRES S_ D B _ US E R = wpuser \
-e WORDPRES S_ D B _ NA M E = wp \
-e WORDPRES S_ D B _ PA S S W O RD = geheim \
wordpres s


Im Vergleich zur Erstinstallation fällt docker run für MariaDB deutlich kürzer aus, weil die vorhandene Datenbank sowie alle Passwörter weitergenutzt werden.
; Container löschen
* Diese Daten befinden sich in myvolume.
<syntaxhighlight lang="bash" highlight="1" line copy>
Bei phpMyAdmin bleibt docker run unverändert.
docker rm mariadb-test pma wordpress-test
* Erstaunlicherweise gilt dies auch für den Start des WordPress-Containers.
</syntaxhighlight>
* Hier hätte man ja annehmen können, dass die Konfigurationsdaten ebenfalls dauerhaft im Volume gespeichert wären.
* Tatsächlich enthält die entscheidende Konfigurationsdatei wp_config.php aber Code, der die Umgebungsvariablen auswertet.
* Fehlen die Umgebungsvariablen, scheitert der Verbindungsaufbau zwischen WordPress und dem Datenbankserver.
Dank der Wiederverwendung der Volumes bleiben bei dem Update alle Daten (also die Tabellen der wp-Datenbank, Blog-Beiträge in WordPress etc.) erhalten.


Aufräumen
; Volumes löschen
<syntaxhighlight lang="bash" highlight="1" line copy>
docker volume rm myvolume
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" line copy>
docker volume rm wp-html
</syntaxhighlight>


Wenn Sie sämtliche Komponenten dieses Beispiels löschen wollen, also das Netzwerk sowie die Container, Volumes und Images, dann führen Sie die folgenden Kommandos aus:
; Netzwerk löschen
<syntaxhighlight lang="bash" highlight="1" line copy>
docker network rm testnet
</syntaxhighlight>


docker  stop mariadb - test pma wordpress - test
; Image löschen
docker  rm  mariadb - test pma wordpress - test
<syntaxhighlight lang="bash" highlight="1" line copy>
docker  volume rm myvolume
docker image rm mariadb wordpress phpmyadmin/phpmyadmin
docker  volume rm wp - html
</syntaxhighlight>
docker   network rm testnet
docker  image rm mariadb wordpress phpmyadm in / phpmyadm i n


<noinclude>
<noinclude>
[[Kategorie:Docker/Buch/03 Grundlagen]]
[[Kategorie:Docker/Grundlagen]]
</noinclude>
</noinclude>

Aktuelle Version vom 18. November 2026, 15:27 Uhr

Docker/Grundlagen/08 Container-Kommunikation - Kommunikation zwischen Containern

Beschreibung

Viele Container-Anwendungen bestehen aus mehreren Containern
  • Daher wird ein Weg zur Kommunikation benörigt
  • Dazu können interne Docker-Netzwerke verwendet werden
Beispiel: WordPress

Drei Container

  • MariaDB
  • phpMyAdmin
  • WordPress

Privates Docker-Netzwerk einrichten

Einrichten eines Docker-Netzwerks
docker network create testnet

MariaDB

Start des Datenbanksystems

MariaDB soll beim ersten Start eine leere Datenbank (wp) sowie einen neuen Account (wpuser) samt Passwort anlegen

  • Auf diesen Account erhalten später phpMyAdmin und WordPress Zugriff
  • Das MariaDB-Image kümmert sich um die notwendigen Initialisierungsarbeiten, wenn Sie die Variablen
    • MYSQL_DATABASE
    • MYSQL_USER
    • MYSQL_PASSWORD
mit -e an docker run übergeben
root-Passwort von MariaDB

Hier ist es nicht erforderlich, dass das root-Passwort von MariaDB den anderen Containern bekannt ist

  • -e MYSQL_RANDOM_ROOT_PASSWORD=1 erzeugt ein zufälliges Passwort
Network

--network verbindet den Container mit dem vorhin erzeugten Netzwerk

Befehl
docker run -d --name mariadb-test \
-h mariadb-test \
--network testnet \
-e MYSQL_RANDOM_ROOT_PASSWORD=1 \
-e MYSQL_DATABASE=wp \
-e MYSQL_USER=wpuser \
-e MYSQL_PASSWORD=geheim \
-v myvolume:/var/lib/mysql \
mariadb

phpMyAdmin

Weboberfläche zur Administration von MariaDB

Start des Containers
docker run -d --name pma \
--network testnet \
-p 8080:80 \
-e PMA_HOST=mariadb-test \
phpmyadmin/phpmyadmin
Optionen
Option Beschreibung
--network verbindet auch diesen Container mit dem privaten Netzwerk dieses Beispiels
-p bewirkt, dass die Weboberfläche (Port 80 im Container) auf dem Host-System unter Port 8080 angesprochen werden kann
-e PMA_HOST Dank der Variablen PMA_HOST weiß der phpMyAdmin-Container, unter welchem Host-Namen der MariaDB-Server im Netzwerk läuft
  • Docker-Netzwerke kümmern sich automatisch um die netzwerkinterne Namensauflösung, wobei die mit --name angegebenen Namen gelten
-s Wie MariaDB wird auch der phpMyAdmin-Container im Hintergrund ausgeführt (Option -d)
  • Um zu testen, ob alles funktioniert, öffnen Sie im Webbrowser Ihres Rechners die Adresse localhost:8080
  • Sie müssen sich beim Datenbankserver mit dem Accountnamen wpuser und dem Passwort geheim anmelden
root-Zugriff in phpMyAdmin
Sollen alle Datenbanken von MariaDB zu sehen sein, müssen Sie beim Start des MariaDB-Containers ein root-Passwort festlegen
  • Dann gelingt in phpMyAdmin der Login mit root und dem dazugehörigen Passwort
  • In diesem Beispiel ist das nicht möglich, weil das root-Passwort wegen der Variablen MYSQL_RANDOM_ROOT_PASSWORD=1 zufällig bestimmt wurde

WordPress

Wie lange haben Sie das letzte Mal gebraucht, um auf einem Server WordPress zu installieren?

  • Wenn Sie das regelmäßig machen, vermutlich nur ein paar Minuten
  • Beim ersten Mal dauert es oft viel länger, bis das Fundament, das aus Apache, PHP und MySQL oder MariaDB besteht, mit all seinen Zusatzpaketen installiert und konfiguriert ist
Docker

Einmal vorausgesetzt, dass Sie bereits einen MySQL- oder MariaDB-Container eingerichtet haben, ist zur Inbetriebnahme von WordPress lediglich das folgende, zugegebenermaßen nicht ganz kurze Kommando notwendig

docker run -d --name wordpress-test \
--network testnet \
-h wordpress-test \
-v wp-html:/var/www/html/wp-content \
-p 8081:80 \
-e WORDPRESS_DB_HOST=mariadb-test \
-e WORDPRESS_DB_USER=wpuser \
-e WORDPRESS_DB_NAME=wp \
-e WORDPRESS_DB_PASSWORD=geheim \
wordpress
Optionen
  • -d bewirkt den Start des Containers als Hintergrunddienst
  • --name gibt dem Container seinen Namen
  • --network testnet sorgt dafür, dass der WordPress-Container im gleichen Netzwerk wie der MariaDB-Server und phpMyAdmin läuft
  • -v macht aus/var/www/html/wp-content ein Volume mit dem Namen wp-html
    • In diesem Verzeichnis werden hochgeladene Bilder, Plugins etc. gespeichert, also alle Daten, die nichts mit der eigentlichen WordPress-Installation zu tun haben
  • Der Volume-Name erleichtert die weitere Administration des Containers, z. B. bei Updates oder beim Löschen
  • Alle hochgeladenen Dateien und Erweiterungen bleiben dabei im Volume erhalten

Mit -p geben Sie an, unter welchem Port die WordPress-Installation auf dem Docker-Host angesprochen werden kann

  • Da Port 8080 im vorigen Beispiel schon für phpMyAdmin zum Einsatz kam, haben wir jetzt eben 8081 verwendet
  • Sofern Sie Docker mit root-Rechten ausführen und auf Ihrem Host-Rechner Port 80 frei ist, können Sie natürlich auch -p 80:80 angeben
  • Die Variablen WORDPRESS_DB_HOST,_USER,_PASSWORD und _NAME geben an, unter welchem Host-Namen der MySQL- oder MariaDB-Server läuft, welcher Login-Name und welches Passwort beim Verbindungsaufbau verwendet werden sollen und wie der Name der Datenbank lautet
  • Diese Datenbank muss bereits existieren. (Im Gegensatz zu früheren Versionen des WordPress-Images wird die Datenbank nicht erzeugt.)
Aufruf

Unter der Adresse http://localhost:8081 nehmen Sie die Website nun in Betrieb

  • Die Anfangskonfiguration beschränkt sich auf zwei Dialoge: Auf der ersten Seite wählen Sie die gewünschte Sprache aus, auf der zweiten Seite richten Sie den WordPress-Administrator ein
  • Die oft heikle Konfiguration der Zugangsdaten des Datenbankservers entfällt: Darum hat sich ein Script des WordPress-Containers bereits gekümmert

Als Host-Namen müssen Sie den Namen (Option --name) des MariaDB-Containers angeben

  • Die Loginund Datenbank-Namen müssen mit den Angaben übereinstimmen, die Sie beim Start von MariaDB mit den Optionen MYSQL_USER , MYSQL_PASSWORD und MYSQL_DATABASE verwendet haben
Weitere Informationen zu den Umgebungsvariablen des offiziellen WordPress-Images
https://hub.docker.com/_/wordpress

Container stoppen und neu starten

Wenn Sie die drei Container vorübergehend nicht mehr brauchen, können Sie sie stoppen und dann bei Bedarf wieder neu starten

  • docker stop/start können mehrere Container-Namen übergeben werden
docker stop
docker stop mariadb-test pma wordpress-test
docker start
docker start mariadb-test pma wordpress-test

Updates

Wenn es von MariaDB, phpMyAdmin und WordPress neue Images gibt, können Sie wie folgt eine Neuinstallation durchführen

docker stop mariadb-test pma wordpress-test
docker rm mariadb-test pma wordpress-test
docker pull mariadb
docker pull phpmyadmin/phpmyadmin
docker pull wordpress
docker run -d --name mariadb-test \
-h mariadb-test \
--network testnet \
-v myvolume:/var/lib/mysql mariadb


docker run -d --name pma --network testnet \
-p 8080:80 \
-e PMA_HOST=mariadb-test \
phpmyadmin/phpmyadmin
docker run -d --name wordpress -test \
--network testnet \
-h wordpress-test \
-v wp -html:/var/www/html/wp-content \
-p 8081:80 \
-e WORDPRESS_DB_HOST=mariadb-test \
-e WORDPRESS_DB_USER=wpuser \
-e WORDPRESS_DB_NAME=wp \
-e WORDPRESS_DB_PASSWORD=geheim \
wordpress

Vergleich zur Erstinstallation docker run für MariaDB kürzer

  • weil die vorhandene Datenbank sowie alle Passwörter weitergenutzt werden
  • Diese Daten befinden sich in myvolume

Bei phpMyAdmin bleibt docker run unverändert

  • Erstaunlicherweise gilt dies auch für den Start des WordPress-Containers
  • Hier hätte man annehmen können, dass die Konfigurationsdaten ebenfalls dauerhaft im Volume gespeichert wären
  • Tatsächlich enthält die entscheidende Konfigurationsdatei wp_config.php aber Code, der die Umgebungsvariablen auswertet
  • Fehlen die Umgebungsvariablen, scheitert der Verbindungsaufbau zwischen WordPress und dem Datenbankserver
Wiederverwendung der Volumes

Dank der Wiederverwendung der Volumes bleiben bei dem Update alle Daten (also die Tabellen der wp-Datenbank, Blog-Beiträge in WordPress etc.) erhalten

Aufräumen

Komponenten des Beispiels löschen

Container anhalten
docker stop mariadb-test pma wordpress-test
Container löschen
docker rm mariadb-test pma wordpress-test
Volumes löschen
docker volume rm myvolume
docker volume rm wp-html
Netzwerk löschen
docker network rm testnet
Image löschen
docker image rm mariadb wordpress phpmyadmin/phpmyadmin