swarm-examples
swarm-examples copied to clipboard
Beispiel-Code zum Artikel "Continuous Deployment mit Docker Swarm" im Java Magazin 12.17
Docker Swarm: Beispiele
Beispiel-Code zum Artikel "Continuous Deployment mit Docker Swarm" im Java Magazin 12.17.
Update: Der komplette Artikel ist jetzt unter jaxenter.de online lesbar.
An English version of the article is available at jaxenter.com.
Überblick
Die Beispiele setzen voraus, dass die lokale Docker Engine als Swarm Manager fungiert
und mindestens ein Worker, markiert mit dem Label de.gesellix.swarm.node=worker
, im Swarm verfügbar ist.
Eine solche Umgebung kann wie unter Lokale Testumgebung beschrieben
eingerichtet werden.
Im Artikel wird der Nginx in zwei Varianten eingesetzt, die in zwei Unterverzeichnissen vorbereitet sind:
-
nginx-basic
: ein rudimentärer Reverse Proxy für denwhoami
Service. -
nginx-secrets
: der gleiche Proxy, diesmal ergänzt um HTTPS und unter Verwendung des offiziellen Basis-Images.
Äquivalent zum nginx-basic
gibt es eine Alternative, die Træfik anstelle des Nginx' verwendet:
-
traefik
: enthält Træfik als dynamischer Reverse Proxy in einem Stack.
Lokale Testumgebung
Um lokal einen Swarm-Cluster einzurichten, eignen sich die Scripte im Verzeichnis swarm
:
./01-init-swarm.sh
./02-init-worker.sh
Die beiden Befehle schalten zuerst die lokale Docker Engine in den Swarm Mode und richten dann drei Worker ein. Darüber hinaus werden eine lokale Registry und ein Registry-Mirror gestartet.
Die Worker und Registries können per ./10-remove-worker.sh
wieder gestoppt werden.
Beispiele
Disclaimer: Die Beispiele sind stark an die offizielle Dokumentation unter docs.docker.com angelehnt.
Nginx (basic)
Unter nginx-basic
liegt eine Konfiguration für den Nginx als Reverse Proxy für
einen Beispiel-Service. Für ein manuelles Setup sind folgende Schritte notwendig:
docker build -t 127.0.0.1:5000/nginx -f nginx-basic nginx-basic
docker push 127.0.0.1:5000/nginx
docker service create --detach=false --name basic --publish 8080:80 --replicas 3 127.0.0.1:5000/nginx
Das gleiche Setup ist etwas bequemer per Docker Stack möglich:
docker stack deploy --compose-file nginx-basic/docker-stack.yml basic-stack
Nginx (mit HTTPS)
Unter nginx-secrets
liegt die gleiche Konfiguration aus Nginx (basic),
allerdings ergänzt um HTTPS Unterstützung unter Verwendung von Docker Secrets und Docker Configs.
Das manuelle Setup lautet wie folgt:
nginx-secrets/gen-certs.sh
docker secret create --name site.key nginx-secrets/cert/site.key
docker secret create --name site.crt nginx-secrets/cert/site.crt
docker config create --name https.conf nginx-secrets/backend-https.conf
docker service create --detach=false --name https-proxy --publish 8443:443 --secret site.key --secret site.crt --config source=https.conf,target=/etc/nginx/conf.d/https.conf --replicas 3 nginx:alpine
Das gleiche Setup ist wieder etwas bequemer per Docker Stack möglich:
docker stack deploy --compose-file nginx-secrets/docker-stack.yml https-stack
Træfik (basic)
Unter traefik
liegt ein Beispiel für die Verwendung von Træfik in einem Docker Swarm.
Das Beispiel kann per docker stack
deployed werden:
docker stack deploy --compose-file traefik/docker-stack.yml traefik
Contributing
Fehlerkorrekturen oder Verbesserungen können gerne per Issue oder Pull Request eingereicht werden. Die Beispiele sollten allerdings noch zum Inhalt des Artikels passen. Für Fragen stehe ich darüber hinaus auf Twitter @gesellix zur Verfügung.