podman/docs/source/markdown/podman-update.1.md.in

116 lines
2.3 KiB
Markdown

% podman-update 1
## NAME
podman\-update - Update the configuration of a given container
## SYNOPSIS
**podman update** [*options*] *container*
**podman container update** [*options*] *container*
## DESCRIPTION
Updates the configuration of an existing container, allowing changes to resource limits and healthchecks.
## OPTIONS
@@option blkio-weight
@@option blkio-weight-device
@@option cpu-period
@@option cpu-quota
@@option cpu-rt-period
@@option cpu-rt-runtime
@@option cpu-shares
@@option cpus.container
@@option cpuset-cpus
@@option cpuset-mems
@@option device-read-bps
@@option device-read-iops
@@option device-write-bps
@@option device-write-iops
@@option health-cmd
@@option health-interval
Changing this setting resets the timer.
@@option health-log-destination
Warning: Changing this setting may cause the loss of previous logs.
@@option health-max-log-count
@@option health-max-log-size
@@option health-on-failure
@@option health-retries
@@option health-start-period
@@option health-startup-cmd
@@option health-startup-interval
Changing this setting resets the timer, depending on the state of the container.
@@option health-startup-retries
@@option health-startup-success
@@option health-startup-timeout
@@option health-timeout
@@option memory
@@option memory-reservation
@@option memory-swap
@@option memory-swappiness
@@option no-healthcheck
@@option pids-limit
@@option restart
## EXAMPLEs
Update a container with a new cpu quota and period.
```
podman update --cpus=5 myCtr
```
Update a container with all available options for cgroups v2.
```
podman update --cpus 5 --cpuset-cpus 0 --cpu-shares 123 --cpuset-mems 0 --memory 1G --memory-swap 2G --memory-reservation 2G --blkio-weight-device /dev/zero:123 --blkio-weight 123 --device-read-bps /dev/zero:10mb --device-write-bps /dev/zero:10mb --device-read-iops /dev/zero:1000 --device-write-iops /dev/zero:1000 --pids-limit 123 ctrID
```
Update a container with all available options for cgroups v1.
```
podman update --cpus 5 --cpuset-cpus 0 --cpu-shares 123 --cpuset-mems 0 --memory 1G --memory-swap 2G --memory-reservation 2G --memory-swappiness 50 --pids-limit 123 ctrID
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-create(1)](podman-create.1.md)**, **[podman-run(1)](podman-run.1.md)**
## HISTORY
August 2022, Originally written by Charlie Doern <cdoern@redhat.com>