====== Docker Compose ======
Per utilitzar docker-compose cal que abans coneguis a fons [[Docker]].
Referències:
* Documentació oficial Docker: https://docs.docker.com/compose/
* Una bona [[https://gist.github.com/jonlabelle/bd667a97666ecda7bbc4f1cc9446d43a|xuleta o Cheat Sheet de docker-compose]]
Articles previs:
* [[Docker pres]] teoria a bytes.cat
* [[Docker]] pràctiques inicials a bytes.cat
Segueix a:
* [[Docker upgrade de containers]]
* [[Dockerfile]]
{{tag> #FpInfor #Asix #Ceti #Ciber #CetiMp03 #CiberMp03 DevOps docker docker_compose compose wordpress }}
===== Instal·lació =====
Docker-compose es pot instal·lar fàcilment en Ubuntu:
$ sudo apt install docker-compose
Per suposat, abans cal tenir instal·lat el //Docker Engine//. Ves a l'article [[Docker]] si encara no l'has seguit.
\\
===== Wordpress amb docker-compose =====
Mira la [[https://hub.docker.com/_/wordpress|documentació oficial del docker Wordpress]]. Crea l'arxiu ''docker-compose.yml'' i posa'l en marxa amb un:
$ docker compose up -d
Podràs veure que el ''-d'' ens allibera la //shell// i deixa els contenidors funcionant en background.
Per parar-lo, pots fer:
$ docker compose down
Comprova quins volums s'han creat, fent:
$ docker volume ls
\\
===== Escalat de contenidors =====
Una de les funcions importants per la gestió dels contenidors és la de l'escalat o replicació. En el cas de les aplicacions web, és molt habitual necessitar diverses instàncies del servidor web i el seu //software// (PHP, Python, etc.), mantenint una sola BD centralitzada (replicar la BD és una operació molt més complexa).
{{load_balancer.png}}
Anem a fer un simple servidor web amb el docker ''nginxdemos/hello'':
services:
web:
image: nginxdemos/hello
ports:
# important marcar el port intern 80 sense assignar a un d'extern
# docker-machine li asignarà un port extern automàticament
- 80
Arranquem amb:
docker compose up -d
Escalem amb:
docker compose up -d --scale web=3
Comprovem estat dels nodes amb:
docker-compose ps
Name Command State Ports
--------------------------------------------------------------------------
www_web_1 /docker-entrypoint.sh ngin ... Up 0.0.0.0:49159->80/tcp
www_web_2 /docker-entrypoint.sh ngin ... Up 0.0.0.0:49160->80/tcp
www_web_3 /docker-entrypoint.sh ngin ... Up 0.0.0.0:49161->80/tcp
A la mostra veiem que cada node té assignat un port, començant pel 49159. Els nombres de port i de container no tenen perquè ser correlatius. Podem accedir-hi mitjançant el //browser// a la URL:
http://localhost:32768
\\
===== Balanç de càrrega amb HAProxy =====
Per a arrodonir aquest exercici necessitem un balancejador de càrrega que enllaci amb un o altre node web.
services:
lb:
image: byjg/easy-haproxy:5.0.0
volumes:
- /var/run/docker.sock:/var/run/docker.sock
environment:
- EASYHAPROXY_DISCOVER=docker
ports:
- "80:80"
web:
image: nginxdemos/hello
deploy:
replicas: 3
labels:
# "easyhaproxy" és l'etiqueta que llegeix el load balancer
# "helloweb" pot tenir qualsevol nom, és l'etiqueta del nostre frontend
# "hello.local" indica el domini amb que podrem accedir al servei web
easyhaproxy.helloweb.host: "hello.local"
Veiem que ja no cal redireccionar el port del microservei ''web'' com hem fet anteriorment.
**Sistema d'etiquetes o //labels//**
Per a configurar el //load balancer// no es fa com en un muntatge típic (mitjançant els arxius de config de HAProxy).
Ara seran els contenidors que es donin d'alta els què avisaran a Docker Engine de la seva existència i metadades immutables (no modificables en un contenidor) que s'adjudiquen a les ''label''. Docker Engine conserva aquestes dades i notifica els serveis que es subscriguin. En el cas de EasyHAProxy realitza un //polling// cada 10 segons a l'API de Docker Engine i filtra les etiquetes que comencin per ''easyhaproxy''. D'aquesta manera s'assabenta de les novetats dels frontends que calgui configurar.
EasyHAProxy llegirà les etiquetes que els contenidors del servei ''web'' (secció labels) i utilitzarà les que comencin per ''easyhaproxy'' per configurar els hosts a balancejar.
Ho aixequem tot amb:
docker compose up -d
Comprovem que estan en marxa els 3 nodes web amb + el HAProxy amb:
docker compose ps
Modifiquem ''/etc/hosts'' per tal que d'accedir al servei per domini, i no per IP:
127.0.0.1 localhost hello.local
HAProxy (service lb) ens redirigirà alternativament a un o altre node en cada visita a:
http://hello.local
\\
===== Escalat amb Wordpress =====
Anem a fer un ''docker-compose'' de Wordpress escalable.
* Crea un docker-compose a partir de l'[[https://hub.docker.com/_/wordpress|exemple oficial de la pàgina de Docker Wordpress]]
* Configura'l per a poder escalar el contenidor de wordpress (el de la base de dades ha de ser únic).
* Afegeix també un LB (o //load balancer//) ''HAProxy'' com el de l'exemple anterior.
* En total ha de tenir 3 serveis: wordpress, db i lb.
* Assegura't que:
* El //service// ''wordpress'' no té assignat un port extern (si ho té, no podrà escalar).
* No t'interfereix la instal·lació de Wordpress anterior. Per assegurar-ho fes una nova carpeta amb nova instal·lació. Si vols aprofitar la que tenies, mira que el port del LB (HAProxy) sigui el mateix que el de la instal·lació anterior.
* El LB apunta al servei ''wordpress'', i no al ''web'' de l'exemple.
* Comprova que funciona correctament escalant a 4 instàncies de Wordpress i que pots connectar-te a través del port configurat al HAProxy.
* Per assegurar-nos de que realment HAProxy alterna entre els diferents nodes, forçarem a mostrar la IP del servidor. Farem un //hack// per mostrar la IP del container que ens està servint:
* Edita l'arxiu:
$ sudo vi /var/lib/docker/volumes/scaled-wp_wordpress/_data/index.php
* Introdueix aquesta línia just després del ''define'':
echo "IP Address: ".$_SERVER["SERVER_ADDR"];
* Activa el tema ''twentytwentyone'' (fons verd) des de l'admin panel del wordpress.
* Edita l'arxiu:
$ sudo vi /var/lib/docker/volumes/scaled-wp_wordpress/_data/wp-content/themes/twentytwentyone/header.php
* Introdueix aquesta línia després del ''wp_body_open()'':
echo "IP Address: ".$_SERVER["SERVER_ADDR"];
* **Comprova ara que a l'anar a la //main page// del Wordpress es visualitza la IP i que al recarregar anem alternant entre les diverses IPs**.