116 lines
3.2 KiB
Markdown
116 lines
3.2 KiB
Markdown
# Router Traefik para entorno Docker local
|
|
|
|
Traefik es un front-end que permite hacer _routing_ HTTP de los
|
|
servicios que tenemos corriendo localmente en contenedores
|
|
Docker. Según el dominio solicitado, Traefik determina a qué container
|
|
pasar la petición.
|
|
|
|
## Ejemplo
|
|
|
|
Supongamos que tenemos corriendo en la máquina de desarrollo los
|
|
contenedores:
|
|
|
|
* `kimkelen` (servicio HTTP en puerto 80)
|
|
* `peruvia` (servicio HTTP en puerto 8080)
|
|
* `wordpress` (servicio HTTP en puerto 80)
|
|
|
|
Traefik permite acceder a los contenedores locales en las direcciones
|
|
|
|
* http://kimkelen.lndo.site (80) -> container kimkelen (80)
|
|
* http://peruvia.lndo.site (80) -> container peruvia (8080)
|
|
* http://wordpress.lndo.site (80) -> container wordpress (80)
|
|
|
|
Cualquier dominio `*.lndo.site` siempre apunta a localhost
|
|
(127.0.0.1), por lo que no hay que configurar nada en `/etc/hosts`.
|
|
|
|
## Uso
|
|
|
|
Requerimiento: tener Docker y Docker Compose instalados. En
|
|
https://servicios.unl.edu.ar/gitlab/recursos/docker se encuentra una
|
|
receta Ansible para configurar estas herramientas en la PC de
|
|
desarrollo.
|
|
|
|
1. Clonar este repo:
|
|
|
|
git clone https://servicios.unl.edu.ar/gitlab/recursos/traefik.git
|
|
|
|
2. Ejecutar Traefik:
|
|
|
|
cd traefik
|
|
docker-compose up -d
|
|
|
|
3. Listo! Ahora puedo acceder a los containers locales en
|
|
http://NOMBRE-CONTAINER.lndo.site
|
|
|
|
La selección de `NOMBRE_CONTAINER` sigue una serie de reglas. Para
|
|
encontrar la URL asignada a un container, ingresar a
|
|
http://traefik.lndo.site y revisar el listado que aparece.
|
|
|
|
## Gotchas
|
|
|
|
### Conexión a la red de Traefik
|
|
|
|
Los containers deben estar asociados a la red de Traefik para poder
|
|
routear el tráfico interno.
|
|
|
|
* En Docker Compose se debe marcar la red Traefik como externa, por
|
|
ejemplo:
|
|
|
|
---
|
|
services:
|
|
# servicio web de wordpress
|
|
wordpress:
|
|
image: wordpress
|
|
# ... etc ...
|
|
networks:
|
|
- traefik
|
|
- app
|
|
|
|
mysql:
|
|
image: mysql
|
|
# ... etc ...
|
|
networks:
|
|
- app
|
|
|
|
networks:
|
|
traefik:
|
|
external: true
|
|
app:
|
|
|
|
### Puerto a publicar
|
|
|
|
Traefik usa el primer puerto expuesto por el contenedor. De ser
|
|
necesario, se puede setear en dicho contenedor la _label_
|
|
`traefik.http.services.CONTAINER.loadbalancer.server.port=PUERTO"`
|
|
para cambiar este comportamiento.
|
|
|
|
* `CONTAINER` es un nombre único para el servicio del contenedor, se
|
|
recomienda usar el mismo nombre que el container.
|
|
|
|
* `PUERTO` es el puerto en el que el contenedor escucha peticiones
|
|
HTTP.
|
|
|
|
### Cambiar dominio de un container
|
|
|
|
Para cambiar el dominio donde atiende un servicio, editar el servicio
|
|
correspondiente en `docker-compose.yml`:
|
|
|
|
services:
|
|
app:
|
|
image: ...
|
|
# ...
|
|
labels:
|
|
traefik.http.routers.CONTAINER.rule=Host(`miservicio.lndo.tite`)
|
|
|
|
### Routear según dominio + path
|
|
|
|
Si deseo que API1 atienda todas las peticiones `/api/v1/` y WEBAPP
|
|
atienda en cualquier otro path, ambas para un mismo dominio
|
|
`miservicio.lndo.site`, setear en API1 la _label_:
|
|
|
|
traefik.http.routers.API1.rule=Host(`miservicio.lndo.site`) && PathPrefix(`/api/v2`)
|
|
|
|
y en WEBAPP:
|
|
|
|
traefik.http.routers.API1.rule=Host(`miservicio.lndo.site`)
|