# docker container update

**Descripción:** Actualiza la configuración de uno o más contenedores

**Uso:** `docker container update [OPTIONS] CONTAINER [CONTAINER...]`

**Alias:** `docker update`








## Descripción

El comando `docker update` permite actualizar dinámicamente la configuración de un contenedor.
Puedes utilizar este comando para evitar que los contenedores consuman demasiados
recursos de su host Docker. Con un solo comando, puedes establecer límites en un solo
contenedor o en varios. Para especificar más de un contenedor, proporciona una lista de
nombres o IDs de contenedores separados por espacios.

> [!WARNING]
> Los comandos `docker update` y `docker container update` no son compatibles
> con contenedores de Windows.
{ .warning }


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--blkio-weight` |  |  Block IO (peso relativo), entre 10 y 1000, o 0 para desactivar (por defecto 0)<br> |

 | `--cpu-period` |  |  Limita el período del programador completamente justo (CFS) de la CPU |

 | `--cpu-quota` |  |  Limita la cuota del programador completamente justo (CFS) de la CPU |

 | `--cpu-rt-period` |  | API 1.25+ Limita el período en tiempo real de la CPU en microsegundos |

 | `--cpu-rt-runtime` |  | API 1.25+ Limita el tiempo de ejecución en tiempo real de la CPU en microsegundos |

 | `-c`, `--cpu-shares` |  |  Cuotas de CPU (peso relativo) |

 | `--cpus` |  | API 1.29+ Número de CPUs |

 | `--cpuset-cpus` |  |  CPUs en las que se permite la ejecución (0-3, 0,1) |

 | `--cpuset-mems` |  |  Memoria (MEMs) en las que se permite la ejecución (0-3, 0,1) |

 | `-m`, `--memory` |  |  Límite de memoria |

 | `--memory-reservation` |  |  Límite flexible de memoria (memory soft limit) |

 | `--memory-swap` |  |  Límite de intercambio (swap) igual a la memoria más el intercambio: -1 para habilitar intercambio ilimitado |

 | `--pids-limit` |  | API 1.40+ Ajusta el límite de pids del contenedor (establece -1 para ilimitado) |

 | `--restart` |  |  Política de reinicio a aplicar cuando un contenedor finaliza |




## Ejemplos

Las siguientes secciones ilustran formas de utilizar este comando.

### Actualizar los cpu-shares de un contenedor (--cpu-shares) {#cpu-shares}

Para limitar los cpu-shares de un contenedor a 512, primero identifica el nombre
o ID del contenedor. Puedes utilizar `docker ps` para encontrar estos valores. También puedes
utilizar el ID devuelto por el comando `docker run`. Luego, haz lo siguiente:

```console
$ docker update --cpu-shares 512 abebf7571666
```

### Actualizar un contenedor con cpu-shares y memoria (-m, --memory) {#memory}

Para actualizar varias configuraciones de recursos para múltiples contenedores:

```console
$ docker update --cpu-shares 512 -m 300M abebf7571666 hopeful_morse
```

### Actualizar la política de reinicio de un contenedor (--restart) {#restart}

Puedes cambiar la política de reinicio de un contenedor en ejecución. La nueva
política de reinicio tiene efecto inmediato después de ejecutar `docker update` en un
contenedor.

Para actualizar la política de reinicio para uno o más contenedores:

```console
$ docker update --restart=on-failure:3 abebf7571666 hopeful_morse
```

Ten en cuenta que si el contenedor se inicia con el flag `--rm`, no podrás actualizar la política
de reinicio para este. `AutoRemove` y `RestartPolicy` son mutuamente excluyentes para el
contenedor.