v3.2.0-RC2
Pre-release
Pre-release
This is the second release candidate for Podman v3.2.0. We expect a final RC early next week, and a final release late next week if all goes well
Preliminary release notes follow:
Features
- Docker Compose is now supported with rootless Podman (#9169).
- The
podman network connect
,podman network disconnect
, andpodman network reload
commands have been enabled for rootless Podman. - An experimental new set of commands,
podman machine
, was added to assist in managing virtual machines containing a Podman server. These are intended for easing the use of Podman on OS X by handling the creation of a Linux VM for running Podman. - The
podman generate kube
command can now be run on Podman named volumes (generatingPersistentVolumeClaim
YAML), in addition to pods and containers. - The
podman play kube
command now supports two new options,--ip
and--mac
, to set static IPs and MAC addresses for created pods (#8442 and #9731). - The
podman play kube
command's support forPersistentVolumeClaim
YAML has been greatly improved. - The
podman generate kube
command now preserves the label used bypodman auto-update
to identify containers to update as a Kubernetes annotation, and thepodman play kube
command will convert this annotation back into a label. This allowspodman auto-update
to be used with containers created bypodman play kube
. - The
podman play kube
command now supports KubernetessecretRef
YAML (using the secrets support frompodman secret
) for environment variables. - Secrets can now be added to containers as environment variables using the
type=env
option to the--secret
flag topodman create
andpodman run
. - The
podman start
command now supports the--all
option, allowing all containers to be started simultaneously with a single command. The--filter
option has also been added to filter which containers to start when--all
is used. - Filtering containers with the
--filter
option topodman ps
andpodman start
now supports a new filter,restart-policy
, to filter containers based on their restart policy. - The
--group-add
option to rootlesspodman run
andpodman create
now accepts a new value,keep-groups
, which instructs Podman to retain the supplemental groups of the user running Podman in the created container. This is only supported with thecrun
OCI runtime. - The
podman run
andpodman create
commands now support a new option,--timeout
. This sets a maximum time the container is allowed to run, after which it is killed (#6412). - The
podman run
andpodman create
commands now support a new option,--pidfile
. This will create a file when the container is started containing the PID of the first process in the container. - The
podman run
andpodman create
commands now support a new option,--requires
. The--requires
option adds dependency containers - containers that must be running before the current container. Commands likepodman start
will automatically start the requirements of a container before starting the container itself. - Auto-updating containers can now be done with locally-built images, not just images hosted on a registry, by creating containers with the
io.containers.autoupdate
label set tolocal
. - Podman now supports the Container Device Interface (CDI) standard.
- Podman now adds an entry to
/etc/hosts
,host.containers.internal
, pointing to the current gateway (which, for root containers, is usually a bridge interface on the host system) (#5651). - The
podman ps
,podman pod ps
,podman network list
,podman secret list
, andpodman volume list
commands now support a--noheading
option, which will cause Podman to omit the heading line including column names. - The
podman unshare
command now supports a new flag,--rootless-cni
, to join the rootless network namespace. This allows commands to be run in the same network environment as rootless containers with CNI networking. - The
--security-opt unmask=
option topodman run
andpodman create
now supports glob operations to unmask a group of paths at once (e.g.podman run --security-opt unmask=/proc/* ...
will unmask all paths in/proc
in the container). - The
podman network prune
command now supports a--filter
option to filter which networks will be pruned.
Changes
- The change in Podman 3.1.2 where the
:z
and:Z
mount options for volumes were ignored for privileged containers has been reverted after discussion in #10209. - Podman's rootless CNI functionality no longer requires a sidecar container! The removal of the requirement for the
rootless-cni-infra
container means that rootless CNI is now usable on all architectures, not just AMD64, and no longer requires pulling an image (#8709). - The Image handling code used by Podman has seen a major rewrite to improve code sharing with our other projects, Buildah and CRI-O. This should result in fewer bugs and performance gains in the long term. Work on this is still ongoing.
- The
podman auto-update
command now prunes previous versions of images after updating if they are unused, to prevent disk exhaustion after repeated updates (#10190). - The
podman play kube
now treats environment variables configured as references to aConfigMap
as mandatory unless theoptional
parameter was set; this better matches the behavior of Kubernetes. - Podman now supports the
--context=default
flag from Docker as a no-op for compatibility purposes. - When Podman is run as root, but without
CAP_SYS_ADMIN
being available, it will run in a user namespace using the same code as rootless Podman (instead of failing outright). - The
podman info
command now includes the path of the Seccomp profile Podman is using, and whether Podman is connected to a remote service or running containers locally. - Containers created with the
--rm
option now automatically use thevolatile
storage flag when available for their root filesystems, causing them not to write changes to disk as often as they will be removed at completion anyways. This should result in improved performance. - The
podman generate systemd --new
command will now include environment variables referenced by the container in generated unit files if the value would be looked up from the system environment. - Podman now requires that Conmon v2.0.24 be available.
Bugfixes
- Fixed a bug where the remote Podman client's
podman build
command did not support the--arch
,--platform
, and--os
, options. - Fixed a bug where the remote Podman client's
podman build
command ignored the--rm=false
option (#9869). - Fixed a bug where the
podman generate systemd --new
command could generate extra--iidfile
arguments if the container was already created with one. - Fixed a bug where the
podman generate kube
command produced incorrect YAML for containers which bind-mounted both/
and/root
from the host system into the container (#9764). - Fixed a bug where pods created by
podman play kube
from YAML that specifiedShareProcessNamespace
would only share the PID namespace (and not also the UTS, Network, and IPC namespaces) (#9128). - Fixed a bug where the
podman network reload
command could generate spurious error messages wheniptables-nft
was in use. - Fixed a bug where rootless Podman could fail to attach to containers when the user running Podman had a large UID.
- Fixed a bug where the
podman ps
command could fail with ano such container
error due to a race condition with container removal (#10120). - Fixed a bug where containers using the
slirp4netns
network mode and setting a customslirp4netns
subnet while using therootlesskit
port forwarder would not be able to forward ports (#9828). - Fixed a bug where the
--filter ancestor=
option topodman ps
did not require an exact match of the image name/ID to include a container in its results. - Fixed a bug where the
--filter until=
option topodman image prune
would prune images created after the specified time (instead of before). - Fixed a bug where setting a custom Seccomp profile via the
seccomp_profile
option incontainers.conf
had no effect, and the default profile was used instead. - Fixed a bug where the
--cgroup-parent
option topodman create
andpodman run
was ignored in rootless Podman on cgroups v2 systems with thecgroupfs
cgroup manager (#10173). - Fixed a bug where the
IMAGE
andNAME
variables inpodman container runlabel
were not being correctly substituted (#10192). - Fixed a bug where the remote Podman client's
podman build --iidfile
command could include extra output (in addition to just the image ID) in the image ID file written (#10233). - Fixed a bug where Podman could freeze when creating containers with a specific combination of volumes and working directory (#10216).
- Fixed a bug where rootless Podman containers restarted by restart policy (e.g. containers created with
--restart=always
) would lose networking after being restarted (#8047).
API
- Fixed a bug where the Compat Create endpoint for Containers did not allow advanced network options to be set (#10110).
- Fixed a bug where the Compat Create endpoint for Containers ignored static IP information provided in the
IPAMConfig
block (#10245). - Fixed a bug where the Compat Inspect endpoint for Containers returned null (instead of an empty list) for Networks when the container was not joined to a CNI network (#9837).
- Fixed a bug where the Compat Wait endpoint for Containers could miss containers exiting if they were immediately restarted.
- Fixed a bug where the Compat Create endpoint for Volumes required that the user provide a name for the new volume (#9803).
- Fixed a bug where the Libpod Info handler would sometimes not return the correct path to the Podman API socket.
- Fixed a bug where the Compat Events handler used the wrong name for container exited events (
died
instead ofdie
) (#10168).
Misc
- Updated Buildah to v1.21.0
- Updated the containers/common library to v0.38.4
- Updated the containers/storage library to v1.31.1