Docker/Compose/02 Einführung: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Zeile 131: Zeile 131:
Swarm initiali z e d : current node ( eqbx ...) is now a manager  
Swarm initiali z e d : current node ( eqbx ...) is now a manager  
To add a worker to this swarm , run the following command :
To add a worker to this swarm , run the following command :
docker swarm join --token SWMTKN -xxx 10.0.0.1: 2 3 7 7
docker swarm join --token SWMTKN -xxx 10.0.0.1:2377
To add a manager to this swarm , run
To add a manager to this swarm , run
'docker swarm join-token manager ' and follow the instruct i on s
'docker swarm join-token manager' and follow the instructions
</syntaxhighlight>
</syntaxhighlight>


Zeile 167: Zeile 167:
ID              NAME                  REPLICAS  PORTS        ...
ID              NAME                  REPLICAS  PORTS        ...
skz4ab9p71va    stacktest_db          1/1
skz4ab9p71va    stacktest_db          1/1
ghdrn0z2gi5n    stacktest_wordpress    1/1        * :8082->80/ tcp
ghdrn0z2gi5n    stacktest_wordpress    1/1        *:8082->80/ tcp
</syntaxhighlight>
</syntaxhighlight>


Zeile 173: Zeile 173:
* Steht hier 0/1, ist beim Start ein Fehler aufgetreten
* Steht hier 0/1, ist beim Start ein Fehler aufgetreten


Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von docker service ps <sid/stackname> geben, wobei Sie die Service-ID oder den Namen des Stacks als Parameter übergeben
Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von ''docker service ps <sid/stackname>'' geben
* Das Kommando gibt an, welche Tasks in einem Service ausgeführt werden
* Service-ID oder den Namen des Stacks als Parameter übergeben
 
Das Kommando gibt an, welche Tasks in einem Service ausgeführt werden
* Die ERROR-Spalte ist normalerweise so stark verkürzt, dass sie nicht aufschlussreich ist
* Die ERROR-Spalte ist normalerweise so stark verkürzt, dass sie nicht aufschlussreich ist
* Abhilfe schafft dann die Option --no-trunc:
* Abhilfe schafft dann die Option --no-trunc:
Zeile 183: Zeile 185:
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" line copy>
... NAME            ...  ERROR
... NAME            ...  ERROR
     stacktest_db.1      starting container failed : Invalid
     stacktest_db.1      starting container failed: Invalid
                         address 10.0.1.14 : It does not belong
                         address 10.0.1.14: It does not belong
                         to any of this network's subnets
                         to any of this network's subnets
</syntaxhighlight>
</syntaxhighlight>

Version vom 18. November 2026, 07:21 Uhr

Einführungsbeispiel

Beispiel für die Syntax von compose.yaml

  • zwei Services
    • Datenbankserver MariaDB
    • CMS WordPress
Einstellungen
  • Zur Speicherung der Datenbankdateien bzw. der HTML-Dateien werden jeweils benannte Volumes verwendet
  • Die Namen der Volumes müssen zweimal angegeben werden, einmal bei der Beschreibung der jeweiligen Services und ein zweites Mal – üblicherweise am Ende der Datei compose.yaml – in einem separaten Abschnitt volumes
  • In MariaDB sollen die Datenbank wp und der dazugehörende Benutzer wpuser mit dem Passwort geheim eingerichtet werden
    • Als root-Passwort kann eine zufällige Zeichenkette verwendet werden – es ist für das Setup nicht relevant
  • Damit WordPress auf die Datenbank zugreifen kann, müssen die entsprechenden WORDPRESS -Variablen initialisiert werden
    • DB_HOST verweist auf den Servicenamen db und die Defaultportnummer des MariaDB-Servers
  • Der für WordPress zuständige Webserver nutzt im Container Port 80
    • Dieser Port soll mit Port 8082 des Host-Rechners verbunden werden


compose.yaml
# Dateicompose.yaml
services:
 db:
   image: mariadb:latest
   volumes:
     - vol-db:/var/lib/mysql
   environment:
      MYSQL_RANDOM_ROOT_PASSWORD:   1
      MYSQL_DATABASE:               wp
      MYSQL_USER:                   wpuser
      MYSQL_PASSWORD:               geheim
   restart: always

  wordpress:
    image: wordpress:latest
    volumes:
    - vol-www:/var/www/html/wp-content
    ports:
    - "8082:80 "
    environment:
      WORDPRESS_DB_HOST:        db:3306
      WORDPRESS_DB_USER:        wpuser
      WORDPRESS_DB_NAME:        wp
      WORDPRESS_DB_PASSWORD:    geheim
    restart: always

   volumes:
     vol-www:
     vol-db:

docker compose

Um docker compose auszuprobieren, wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml – hier wordpress-beispiel

Beachten Sie, dass der Verzeichnisname zur Benennung der Container, Volumes, Netzwerke usw. verwendet wird docker compose up -d sucht im aktuellen Verzeichnis nach der Datei compose.yaml, lädt die erforderlichen Images herunter (natürlich nur, wenn diese noch nicht zur Verfügung stehen), erzeugt die Container, verbindet diese in einem eigens dafür erzeugten Netzwerk und startet sie als Hintergrundprozesse (Option -d)

  • Der gesamte Vorgang dauert nur wenige Sekunden (plus gegebenenfalls die Zeit zum Download der Images)

Beachten Sie, dass die Container wegen restart: always auch nach einem Reboot des Rechners automatisch neu gestartet werden

cd wordpress-beispiel       # (Verzeichnis mit compose.yaml)
docker compose up -d
Creating network wordpress-beispiel_default with the default driver
Creating wordpress-beispiel_wordpress_1 ... done
Creating wordpress-beispiel_db_1        ... done
docker ps

Laufenden Container anzeigen

  • Nach wenigen Sekunden, die für die Initialisierung des Containers erforderlich sind, können Sie WordPress unter der Adresse localhost:8082 nutzen
docker ps
ID          PORTS                          NAMES
5211...     0.0.0.0:8082->80/tcp           wordpress -beispiel_wordpress_1
d9dc ...    3306/ tcp                      wordpress -beispiel_db_1
docker compose stop

Ausführung aller zusammengehörenden Container stoppen

  • Analog setzt docker compose start die Ausführung fort

Diese Kommandos setzen voraus, dass sie in dem Verzeichnis mit compose.yaml gestartet werden

docker compose down

Stoppen und löschen Sie alle Container der Setups

  • Die Volumes bleiben erhalten
docker compose up

Die Container können unter Beibehaltung der bisherigen Daten neu eingerichtet werden

; Container stoppen und löschen
docker compose down
Container neu einrichten
docker compose up -d
Container löschen
docker compose down
docker volume rm wordpress-beispiel_vol-db wordpress-beispiel_vol-www

docker stack deploy

Statt mit docker compose können Sie die Datei compose.yaml auch mit dem Kommando docker stack deploy verarbeiten

  • docker stack setzt voraus, dass der Computer Mitglied eines Docker-Schwarms ist
  • Sie müssen aber durchaus keinen Docker-Cluster bilden, um docker stack verwenden zu können
  • Es reicht vollkommen aus, wenn Sie auf Ihrem Rechner einmalig docker swarm init ausführen
  • Damit bildet Ihr Computer einen Docker-Schwarm, der allerdings nur aus einem einzigen Mitglied besteht

Siehe auch

docker swarm init
docker swarm init
Swarm initiali z e d : current node ( eqbx ...) is now a manager 
To add a worker to this swarm , run the following command :
docker swarm join --token SWMTKN -xxx 10.0.0.1:2377
To add a manager to this swarm , run
'docker swarm join-token manager' and follow the instructions

Um die in compose.yaml beschriebenen Container samt einem Netzwerk einzurichten, übergeben Sie an docker stack deploy mit der Option -c den Dateinamen der Compose-Datei und als weiteren Parameter den Namen des Setups bzw. des Stacks

Dieser Name wird den Netzwerk-, Volume- und Servicenamen vorangestellt

  • docker compose verwendet anstelle dieses Namens standardmäßig den Namen des Verzeichnisses, in dem sich compose.yaml befindet
 docker stack deploy -c compose.yaml stacktest
Ignoring unsupported options: restart
Creating network stacktes t_default
Creating service stacktes t_wordpress
Creating service stacktes t_db
docker stack ls

Beweist, dass der neue Stack eingerichtet wurde und aus zwei Services besteht

docker stack ls
NAME        SERVICES   ORCHESTRATOR
stacktest   2          Swarm

Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tatsächlich erzeugt und ausgeführt werden

docker service ls
ID               NAME                   REPLICAS   PORTS         ...
skz4ab9p71va     stacktest_db           1/1
ghdrn0z2gi5n     stacktest_wordpress    1/1        *:8082->80/ tcp
Spalte REPLICAS
  • Steht hier 0/1, ist beim Start ein Fehler aufgetreten

Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von docker service ps <sid/stackname> geben

  • Service-ID oder den Namen des Stacks als Parameter übergeben

Das Kommando gibt an, welche Tasks in einem Service ausgeführt werden

  • Die ERROR-Spalte ist normalerweise so stark verkürzt, dass sie nicht aufschlussreich ist
  • Abhilfe schafft dann die Option --no-trunc:
docker service ps sometest --no-trunc
... NAME            ...  ERROR
    stacktest_db.1       starting container failed: Invalid
                         address 10.0.1.14: It does not belong
                         to any of this network's subnets
docker ps

Mit docker ps können Sie sich davon überzeugen, dass für jeden Service ein entsprechender Container erstellt und gestartet wurde

  • Anders als bei Containern gibt es bei Stacks keine Möglichkeit, sie zu stoppen und später wieder zu starten

Sie können den gesamten Stack mit all seinen Services und Netzwerken aber mit docker stack rm löschen:

docker stack rm stacktest
Removing service stacktes t_db
Removing service stacktes t_wordpress
Removing network stacktes t_default

Die in compose.yaml angegebenen Volumes bleiben dabei erhalten

  • Daher ist es möglich, den Stack später ohne Verlust von Daten wieder einzurichten und neuerlich auszuführen
docker stack deploy -c compose.yaml stacktest

Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die zugeordneten Volumes:

docker stack rm stacktest
docker volume rm stacktest_vol-db stacktest_vol-www

Debugging

Im Idealfall geht beim Start der Container durch docker compose up alles gut

  • Was aber, wenn Fehler auftreten?

Ein erstes Hilfsmittel zur Fehlersuche besteht darin, docker compose up ohne die Option -d auszuführen

  • Damit erfolgen sämtliche Logging-Ausgaben aller Container direkt in der Konsole
  • Sie können also zu einem gewissen Grad mitverfolgen, was in den Containern vor sich geht

Alternativ können Sie mit docker ps einen Blick in die Container-Liste werfen

  • Dort erkennen Sie in der Regel sofort, ob es Container gibt, die nicht wie geplant laufen oder die ständig neu gestartet werden
  • Mit docker logs <cname> können Sie dann die Logging-Ausgaben der betroffenen Container lesen
  • docker compose logs zeigt das kombinierte Logging aller Container der Gruppe

Wie üblich können Sie mit docker exec einen zusätzlichen interaktiven Shell-Prozess starten und so in einen laufenden Container »hineinsehen«:

docker exec -it test_wor dp r e s s _1 / bin / sh
ps -ax
PID TTY                STAT         TIME COMMAND
1 ?                  Ss           0:00 apache2 -DFOREGRO U N D
 66 ?                  S            0:00 apache2 -DFOREGRO U N D
 ...
 78 pts /0             Ss           0:00 / bin / sh
 83 pts /0             R+           0:00 ps -ax


Interaktive Nutzung

Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dauerhaft läuft:

# Datei compose .* yaml
# Containe r / Service endet sofort , weil es
# keinen Hintergr u nd p r o z es s gibt
services :
myservic e 1 :
image : alpine

Führen Sie nun docker compose up aus, wird der betreffende Container zwar eingerichtet und gestartet, aber die Ausführung endet sofort wieder

  • Analog sieht es aus, wenn Sie docker stack deploy ausführen: Der Service wird eingerichtet und gestartet, aber mangels Hintergrundprozess endet die Ausführung sofort wieder
  • Die Schwarmlogik von Docker versucht nun immer wieder, den Service zu starten – aber das hilft natürlich auch nicht
  • Die REPLICAS -Spalte von docker service ls zeigt 0/1, und docker service ps listet diverse Startversuche auf, zeigt aber keine Fehlermeldungen:
docker stack deploy -c compose .yaml test4
docker service ls
ID               NAME                              REPLICAS   IMAGE
1 t8cfulkp x o z test4_mys e r v i ce 1            0/1        alpine :latest
docker service ps 1t8cfulkp x o z
ID               ...
  • DESIRED STATE CURRENT STATE ERROR
kolqn5wn z g p 2     Ready                      Ready 4 seconds ago
yrzb2d0g 4 a r c     Shutdown                   Complete 10 seconds ago
y3ojrkgf v 6 s w     Shutdown                   Complete a minute ago
y54o8unh q f 8 s     Shutdown                   Complete a minute ago
xayg2nje h i y j     Shutdown                   Complete 2 minutes ago

Es wird wohl eher ein Ausnahmefall sein, aber es ist möglich, mit docker compose einen Container für die interaktive Nutzung zu erzeugen

  • Dazu führen Sie mit docker compose das Kommando run <servicename> anstelle von up aus
  • Die zusätzliche Option

--rm bewirkt, dass der Container nach dem Verlassen der Shell gelöscht wird

docker compose run --rm myservice 1
cat / etc / os -release
NAME =" Alpine Linux "
PRETTY_N A ME =" Alpine Linux v3 .13"
...
exit

Eine vergleichbare interaktive Nutzungsvariante für docker stack deploy gibt es nicht

  • docker stack setzt auf dem Konzept von Services auf
  • Der interaktive Betrieb eines Service wäre aber unsinnig