# Docker
El módulo proporciona configuración dinámica de grupos de servidores proxy
en los contextos [HTTP](https://es.angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-upstream) y [stream](https://es.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#s-u-upstream)
basándose en etiquetas de contenedores Docker.
Para que la funcionalidad funcione, debe configurarse una zona de memoria compartida
en el grupo (consulte la descripción de `zone` para [http](https://es.angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-zone) y [stream](https://es.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#s-u-zone)).
#### NOTE
El módulo admite trabajar tanto con Docker como con sus alternativas,
como Podman, que implementan una API compatible.
El módulo se conecta al daemon de Docker mediante la API,
cuyo método de interacción se especifica mediante la directiva [docker_endpoint](#docker-endpoint).
Después de obtener una lista de contenedores en ejecución,
Angie los analiza para detectar la presencia de [etiquetas](#docker-labels) adecuadas.
Si la descripción de un contenedor contiene una etiqueta con un puerto,
entonces la dirección y el puerto de dicho contenedor,
así como los parámetros de otras etiquetas de este contenedor,
se añaden automáticamente al bloque `upstream` correspondiente
en la configuración de Angie.
#### NOTE
El mismo contenedor puede añadirse a varios grupos `upstream`.
Para ello, simplemente especifique varios conjuntos de etiquetas
con diferentes nombres de grupo y puertos.
Esto es especialmente útil
si el contenedor ejecuta varios servicios diferentes en diferentes puertos;
cada servicio puede asociarse con su propio grupo.
El módulo luego se suscribe a eventos del ciclo de vida del contenedor
y comienza a actualizar la configuración del servidor proxy sin recargar Angie:
- al iniciar un contenedor con etiquetas adecuadas,
su dirección IP interna se añade al grupo especificado;
- al detener o eliminar un contenedor,
se elimina automáticamente del grupo;
- al pausar un contenedor con el comando **docker pause**,
el servidor se marca como `down`,
y con **docker unpause** — como `up`.
## Ejemplo de configuración
Las directivas del módulo siempre se ubican en el contexto `http`,
pero los grupos de servidores proxy pueden definirse
tanto en el contexto `http` como en el contexto `stream`.
Ejemplo de configuración para `http`:
```nginx
http {
# Examples of connection options:
# docker_endpoint http://127.0.0.1:2375;
# docker_endpoint https://127.0.0.1:2376;
docker_endpoint unix:/var/run/docker.sock;
# maximum Docker response buffer size (optional)
# docker_max_object_size 128k;
upstream u {
zone z 1m; # shared memory zone is required
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://u;
}
}
}
```
De manera similar en el contexto stream:
```nginx
http {
# Examples of connection options:
# docker_endpoint http://127.0.0.1:2375;
# docker_endpoint https://127.0.0.1:2376;
docker_endpoint unix:/var/run/docker.sock;
# maximum Docker response buffer size (optional)
# docker_max_object_size 128k;
}
stream {
upstream u {
zone z 1m;
}
server {
listen 12345;
proxy_pass u;
}
}
```
Al recibir un evento para un contenedor,
Angie busca etiquetas de la forma
`angie.http.upstreams..port=` (para el contexto HTTP)
o `angie.stream.upstreams..port=` (para el contexto stream).
Cuando hay una etiqueta presente, la dirección del contenedor en la red Docker especificada
(o la primera disponible si no se especifica la etiqueta `angie.network`)
se añade al grupo de servidores proxy correspondiente.
Si un contenedor se detiene o se elimina, el servidor se elimina del grupo;
si un contenedor se pausa, el servidor se marca como `down`.
Fragmento de un archivo `docker-compose.yml` con etiquetas que Angie reconoce:
```yaml
services:
myapp:
image: myapp:latest
labels:
- "angie.http.upstreams.u.port=8080"
- "angie.network=my_bridge"
- "angie.http.upstreams.u.weight=2"
- "angie.http.upstreams.u.max_conns=50"
- "angie.http.upstreams.u.max_fails=3"
- "angie.http.upstreams.u.fail_timeout=10s"
- "angie.http.upstreams.u.backup=true"
```
## Etiquetas
Las etiquetas especifican parámetros del servidor en el grupo de servidores proxy
de manera similar a los argumentos de la directiva `server`:
| Etiqueta | Propósito |
|---------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| `angie.(http|stream).upstreams..port=` *(obligatorio)* | Puerto del contenedor al que Angie se conectará; el contenedor en sí se añade al grupo llamado ``. |
| `angie.network=` | Nombre de la red Docker de la cual tomar la dirección IP del contenedor. |
| `angie.(http|stream).upstreams..weight=` | Valor del parámetro `weight`. |
| `angie.(http|stream).upstreams..max_conns=` | Número máximo de conexiones simultáneas (`max_conns`). |
| `angie.(http|stream).upstreams..max_fails=` | Umbral para intentos fallidos (`max_fails`). |
| `angie.(http|stream).upstreams..fail_timeout=` | Intervalo para contar intentos fallidos (`fail_timeout`). |
| `angie.(http|stream).upstreams..backup=true|false` | Marca el servidor como `backup`. |
| `angie.(http|stream).upstreams..sid=` | Establece un identificador de servidor personalizado (`sid`) para el servidor proxy. |
| `angie.(http|stream).upstreams..slow_start=