# docker stack deploy

**Descripción:** Despliega una nueva pila (stack) o actualiza una existente

**Uso:** `docker stack deploy [OPTIONS] STACK`

**Alias:** `docker stack up`






**Orquestador:** Swarm

## Descripción

Crea y actualiza una pila (stack) en el swarm a partir de un archivo `compose`.

> [!NOTE]
> Este es un comando de administración de clústeres y debe ejecutarse en un
> nodo administrador (manager) de swarm. Para obtener información sobre nodos administradores y trabajadores, consulta la
> [sección del modo Swarm](/engine/swarm/) en la
> documentación.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-c`, `--compose-file` |  | API 1.25+ Ruta a un archivo Compose, o `-` para leer desde la entrada estándar (stdin) |

 | `-d`, `--detach` | `true` |  Sale inmediatamente en lugar de esperar a que los servicios de la pila converjan<br> |

 | `--prune` |  | API 1.27+ Elimina (prune) los servicios que ya no están referenciados |

 | `-q`, `--quiet` |  |  Oculta la salida del progreso |

 | `--resolve-image` | `always` | API 1.30+ Consulta el registro para resolver el digest de la imagen y las plataformas soportadas (`always`, `changed`, `never`)<br> |

 | `--with-registry-auth` |  |  Envía los detalles de autenticación del registro a los agentes de Swarm |




## Ejemplos

### Archivo Compose (--compose-file) {#compose-file}

El comando `deploy` es compatible con la versión `3.0` y superiores del archivo Compose.

```console
$ docker stack deploy --compose-file docker-compose.yml vossibility

Ignoring unsupported options: links

Creating network vossibility_vossibility
Creating network vossibility_default
Creating service vossibility_nsqd
Creating service vossibility_logstash
Creating service vossibility_elasticsearch
Creating service vossibility_kibana
Creating service vossibility_ghollector
Creating service vossibility_lookupd
```

El archivo Compose también se puede proporcionar a través de la entrada estándar con `--compose-file -`:

```console
$ cat docker-compose.yml | docker stack deploy --compose-file - vossibility

Ignoring unsupported options: links

Creating network vossibility_vossibility
Creating network vossibility_default
Creating service vossibility_nsqd
Creating service vossibility_logstash
Creating service vossibility_elasticsearch
Creating service vossibility_kibana
Creating service vossibility_ghollector
Creating service vossibility_lookupd
```

Si tu configuración está dividida en múltiples archivos Compose, por ejemplo, una configuración base y anulaciones específicas para cada entorno, puedes proporcionar múltiples opciones `--compose-file`.

```console
$ docker stack deploy --compose-file docker-compose.yml -c docker-compose.prod.yml vossibility

Ignoring unsupported options: links

Creating network vossibility_vossibility
Creating network vossibility_default
Creating service vossibility_nsqd
Creating service vossibility_logstash
Creating service vossibility_elasticsearch
Creating service vossibility_kibana
Creating service vossibility_ghollector
Creating service vossibility_lookupd
```

Puedes verificar que los servicios se crearon correctamente:

```console
$ docker service ls

ID            NAME                               MODE        REPLICAS  IMAGE
29bv0vnlm903  vossibility_lookupd                replicated  1/1       nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662
4awt47624qwh  vossibility_nsqd                   replicated  1/1       nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662
4tjx9biia6fs  vossibility_elasticsearch          replicated  1/1       elasticsearch@sha256:12ac7c6af55d001f71800b83ba91a04f716e58d82e748fa6e5a7359eed2301aa
7563uuzr9eys  vossibility_kibana                 replicated  1/1       kibana@sha256:6995a2d25709a62694a937b8a529ff36da92ebee74bafd7bf00e6caf6db2eb03
9gc5m4met4he  vossibility_logstash               replicated  1/1       logstash@sha256:2dc8bddd1bb4a5a34e8ebaf73749f6413c101b2edef6617f2f7713926d2141fe
axqh55ipl40h  vossibility_vossibility-collector  replicated  1/1       icecrime/vossibility-collector@sha256:f03f2977203ba6253988c18d04061c5ec7aab46bca9dfd89a9a1fa4500989fba
```