mirror of
https://github.com/containers/podman.git
synced 2025-09-21 03:35:06 +08:00
f21dacc4fb
Allow users to target the most recently created container with `podman update --latest` (short `-l`). The same option already exists on many other commands, so this brings update in line with the rest of the CLI and saves users from typing or looking up the newest container. Fixes: #26380 Signed-off-by: Hayato Kihara <kai.21banana@gmail.com>
128 lines
2.3 KiB
Markdown
128 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 env.update
|
|
|
|
@@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 latest
|
|
|
|
@@option memory
|
|
|
|
@@option memory-reservation
|
|
|
|
@@option memory-swap
|
|
|
|
@@option memory-swappiness
|
|
|
|
@@option no-healthcheck
|
|
|
|
@@option pids-limit
|
|
|
|
@@option restart
|
|
|
|
@@option unsetenv.update
|
|
|
|
|
|
## EXAMPLES
|
|
|
|
Update a container with a new cpu quota and period:
|
|
```
|
|
podman update --cpus=0.5 ctrID
|
|
```
|
|
|
|
Update the latest container with a new cpu value:
|
|
```
|
|
podman update --latest --cpus=1
|
|
```
|
|
|
|
Update a container with multiple options at ones:
|
|
```
|
|
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/sda:123 --blkio-weight 123 \\
|
|
--device-read-bps /dev/sda:10mb --device-write-bps /dev/sda:10mb \\
|
|
--device-read-iops /dev/sda:1000 --device-write-iops /dev/sda:1000 \\
|
|
--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
|
|
June 2025, Latest option added by Hayato Kihara <kai.21banana@gmail.com>
|
|
August 2022, Originally written by Charlie Doern <cdoern@redhat.com>
|