diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 6cf390fac3..806e55c18a 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -1,5 +1,145 @@ # Release Notes +## 4.4.0 +### Features +- Introduce Quadlet, a new systemd-generator that easily writes and maintains systemd services using Podman. +- The `podman kube play` command now supports hostPID in the pod.spec ([#17157](https://github.com/containers/podman/issues/#17157)). +- The `podman build` command now supports the `--group-add` option. +- A new command, `podman network update` has been added, which updates networks for containers and pods. +- The `podman network create` command now supports a new option, `--network-dns-server` sets the DNS servers that this network will use. +- The `podman kube play` command now accepts the`--publish` option, in order to set or override port publishing. +- The `podman inspect` command now returns an error field ([#13729](https://github.com/containers/podman/issues/13729)). +- The `podman update` command now accepts the `--pids-limit` option, which adds the functionality to update the PIDs limit for a container ([#16543](https://github.com/containers/podman/issues/16543)). +- Podman now supports container names beginning with a '/' to match Docker behaviour ([#16663](https://github.com/containers/podman/issues/16663)). +- The `podman events` command now supports "die" as a value (mapping to "died") to the `--filter` option, for better Docker compatibility ([#16857](https://github.com/containers/podman/issues/16857)). +- The `podman system df`command’s `--format "{{ json . }}"` option now outputs human-readable format to improve Docker compatibility +- The `podman rm -f` command now also terminates containers in "stopping" state. +- Rootless privileged containers will now mount all tty devices, except for the virtual-console ones (/dev/tty[0-9]+) ([#16925](https://github.com/containers/podman/issues/#16925)). +- The `podman play kube` command now supports subpaths when using configmap and hostpath volume types ([#16828](https://github.com/containers/podman/issues/16828)). +- A user namespace is now always created when running with EUID != 0. This is necessary to work in a Kubernetes environment where the POD is "privileged" but it is still running with a non-root user. +- All commands with the `--no-heading` option now include a short option, `-n`. +- The `podman push` command no longer ignores the hidden `--signature-policy` flag. +- The `podman wait` command now supports the `--ignore` option. +- The `podman network create` command now supports the `--ignore` option to instruct Podman to not fail when trying to create an already existing network. +- The `podman kube play` command now supports volume subpaths when using named volumes ([#12929](https://github.com/containers/podman/issues/12929)). +- The `podman kube play` command now supports container startup probes. +- A new command, `podman buildx version`, has been added, which shows the buildah version ([#16793](https://github.com/containers/podman/issues/16793)). +- Remote usage of the `podman build` command now supports the `--volume` option ([#16694](https://github.com/containers/podman/issues/16694)). +- The `--opt parent=...` option is now accepted with the ipvlan network driver in the `podman network create` command ([#16621](https://github.com/containers/podman/issues/16621)). +- The `--init-ctr` option for the `podman container create` command now supports shell completion. +- The `podman kube play` command run with a readOnlyTmpfs Flag in the kube YAML can now write to tmpfs inside of the container. +- The `podman run` command has been extended with support for checkpoint images. +- When the new `event_audit_container_create` option is enabled in containers.conf, increase the verbosity of the container-create event by adding the inspect data of the container to the event. +- Containers can now have startup healthchecks, allowing a command to be run to ensure the container is fully started before the regular healthcheck is activated. +- CDI devices can now be specified in containers.conf ([#16232](https://github.com/containers/podman/issues/16232)). +- The `podman push` command features two new options, `--encryption-key` and `--encrypt-layer`, for encrypting an image while pushing it to a registry ([#15163](https://github.com/containers/podman/issues/15163)). +- The `podman pull` and `podman run` commands feature a new option, `--decryption-key`, which decrypts the image while pulling it from a registry ([#15163](https://github.com/containers/podman/issues/15163)). +- The `podman manifest annotate` command is now supported for podman-remote. +- The `SSL_CERT_FILE` and `SSL_CERT_DIR` environment variables are now propagated into podman machine VM’s ([#16041](https://github.com/containers/podman/issues/16041)). +- A new environment variable, `CONTAINER_PROXY`, can be used to specify TCP proxies when using podman-remote. +- The runtime automatically detects and switches to crun-wasm if the image is a webassembly image. +- The `podman machine init` command now supports the `--quiet` option, as well a new option, `--no-info` which suppresses informational tips ([#15525](https://github.com/containers/podman/issues/15525)). +- The `podman volume create` command now includes the `-d` short option for the `--driver` option. +- The `podman events` command has a new alias, `podman system events`, for better Docker compatibility. +- The `--restart-sec` option for `podman generate systemd` now generates `RestartSec=` for both pod service files and container service files ([#16419](https://github.com/containers/podman/issues/16419)). +- The `podman manifest push` command now accepts `--purge`, `-p` options as aliases for `--rm`, for Docker compatibility. +- The `--network` option to `podman pod create` now supports using an existing network namespace via `ns:[netns-path]` ([#16208](https://github.com/containers/podman/issues/16208)). +- The `podman pod rm` and `podman container rm` commands now removes container/pod ID files along with the container/pod ([#16387](https://github.com/containers/podman/issues/16387)). +- The `podman manifest inspect` command now accepts a new option, `--insecure` (identical to --tls-verify=false), improving Docker compatibility. ([#14917](https://github.com/containers/podman/issues/14917)). +- A new command, `podman kube apply`, has been added, which deploys the generated yaml to a k8s cluster. +- The `--userns=keep-id` option in rootless `podman create`, `podman run`, `podman kube play`, `podman pod create`, and `podman pod clone` now can be used when only one ID is available. +- The `podman play kube` command now supports the `volume.podman.io/import-source` annotation to import the contents of tarballs. +- The `podman volume create` command now accepts the `--ignore` option, which ignores the create request if the named volume already exists. +- The `--filter` option for `podman ps` now supports regex ([#16180](https://github.com/containers/podman/issues/16180)). +- The `podman system df` command now accepts `--format json` and autocompletes for the `--format` option ([#16204](https://github.com/containers/podman/issues/16204)). + +### Changes +- CNI is being deprecated from Podman and support will be dropped at a future date. Netavark is now advised and is the default network backend for Podman. +- The network name `pasta` is deprecated and support for it will be removed in the next major release. +- The `podman network create` command no longer accepts `default` as valid name. It is impossible to use this network name in the `podman run/create` command because it is parsed as a network mode instead ([#17169](https://github.com/containers/podman/issues/#17169)). +- The `podman kube generate` command will no longer generate built-in annotations, as reserved annotations are used internally by Podman and would have no effect when run with Kubernetes. +- The `podman kube play` command now limits the replica count to 1 when deploying from kubernetes YAML ([#16765](https://github.com/containers/podman/issues/#16765)). +- When a container that runs with the `--pid=host` option is terminated, Podman now sends a SIGKILL to all the active exec sessions +- The journald driver for both `podman events` and `podman logs` is now more efficient when the `--since` option is used, as it will now seek directly to the correct time instead of reading all entries from the journal ([#16950](https://github.com/containers/podman/issues/16950)). +- When the `--service-container` option is set for the `podman kube play` command, the default log-driver to is now set to passthrough ([#16592](https://github.com/containers/podman/issues/16592)). +- The `podman container inspect` and `podman kube generate` commands will no longer list default annotations set to false. +- Podman no longer reports errors on short-lived init containers in pods. +- Healthchecks are now automatically disabled if on non-systemd systems. If Podman is compiled without the systemd build tag, healthcheck will be disabled at build time ([#16644](https://github.com/containers/podman/issues/16644)). +- Improved atomicity of VM state persistence on Windows to better tolerate FS corruption in cases of power loss or system failure ([#16550](https://github.com/containers/podman/issues/16550)). +- Old healthcheck states are now cleaned up during container restart. +- The `CONTAINER_HOST` environment variable defaults to port 22 for SSH style URLs for remote connections, when set. ([#16509](https://github.com/containers/podman/issues/16509)). +- The `podman kube play` command now reuses existing PersistentVolumeClaims instead of erroring. +The `podman kube down` command accepts a new option, `--force`, which removes volumes ([#16348](https://github.com/containers/podman/issues/16348)). +- The `podman create`, `podman run`, and `podman pod create` commands now support a new networking mode, pasta, which can be enabled with the `--net=pasta` option ([#14425](https://github.com/containers/podman/issues/14425)), ([#13229](https://github.com/containers/podman/issues/13229)). +- The `podman system reset` command will no longer prompt the user if `/usr/share/containers/storage.conf file exists`. +- Existing container/pod id files are now truncated instead of throwing an error. +- The `--format` and `--verbose` flags in `podman system df` are no longer allowed to be used in combination. + +### Bugfixes +- Fixed a bug where the `--dns` option was not being set correctly ([#16172](https://github.com/containers/podman/issues/#16172)). +- Fixed a race condition when stopping/killing a container that has already been stopped or has exited ([#16142](https://github.com/containers/podman/issues/#16142)), ([#15367](https://github.com/containers/podman/issues/#15367)). +- Fixed a bug where `podman kube play` default environment variables have not been applied to containers ([#17016](https://github.com/containers/podman/issues/#17016)). +- Fixed a bug where containers with a restart policy set could still restart even after a manual `podman stop` ([#17069](https://github.com/containers/podman/issues/#17069)). +- Fixed a bug where the runtime was not shutdown correctly on error. +- Fixed a bug where a pod couldn't be removed if its service container did not exist anymore ([#16964](https://github.com/containers/podman/issues/16964)). +- Fixed a bug where the output of a non-interactive `docker run` against a podman backend would be truncated when using Docker Clients on Mac and Windows ([#16656](https://github.com/containers/podman/issues/16656)). +- Fixed a bug where `podman logs --since --follow` would not follow and just exit with the journald driver. +- Fixed a bug where `podman logs --until --follow` would not exit after the given until time. +- Fixed a bug where remote usage of the `podman attach` and `podman start` did not sigproxy ([#16662](https://github.com/containers/podman/issues/16662)). +- Fixed a race condition where a container being stopped could be removed from a separate process. +- Fixed a bug in the `podman ps` command’s `--filter` option where specifying volume as a filter would not return the correct containers ([#16019](https://github.com/containers/podman/issues/16019)). +- Fixed a bug where podman-remote would send an incorrect absolute path as context when it’s an emptydir. +- Fixed a bug with the `podman export` command on MacOS and Windows where it could not export to STDOUT ([#16870](https://github.com/containers/podman/issues/16870)). +- Fixed a bug in the http attach endpoint where it would return an incorrect length when reading logs ([#16856](https://github.com/containers/podman/issues/16856)). +- Fixed a bug where symlinks were not followed on mounted folders on MacOS. +- Fixed a bug in the `podman container restore` command’s ` --ignore-static-ip` and `--ignore-static-mac` options when restoring a normal container, i.e without `--import`, where the option was not correctly honored ([#16666](https://github.com/containers/podman/issues/16666)). +- Fixed bug where containers, pods, and volumes were not cleaned up after an error happens while playing a kube yaml file. +- Fixed a bug where system shutdown would be delayed when running health checks on containers running in a systemd unit ([#14531(https://github.com/containers/podman/issues/14531)). +- Fixed a bug where syslog entries may be truncated when the labels map is too large, by increasing event syslog deserialization buffer. +- Fixed a bug in `podman kube play` where secrets were incorrectly unmarshalled ([#16269](https://github.com/containers/podman/issues/16269)), ([#16625(https://github.com/containers/podman/issues/16625)). +- Fixed a bug where barrier sd-notify messages were ignored when using notify policies in kube-play ([#16076](https://github.com/containers/podman/issues/16076)), ([#16515](https://github.com/containers/podman/issues/16644)). +- Fixed a bug where volumes that use idmap were chowned incorrectly to the UID/GID of the root in the container. +- Fixed a bug in `podman kube play` where IpcNS was not being properly set +([#16632](https://github.com/containers/podman/issues/16632)). +- Fixed a bug in `podman kube play` where if the `optional` field of a secret volume was not set in the kube yaml, Podman would crash. The optional field is now correctly handled ([#16636](https://github.com/containers/podman/issues/16636)). +- Fixed a bug in the `podman stats` command where the NetInput and NetOutput fields were swapped. +- Fixed a bug in the `podman network create` command’s `--driver` option where incorrect shell completion suggestions were given. +- Fixed a bug where `podman --noout` was not suppressing output from certain commands such as `podman machine` and `podman system connection` ([#16201](https://github.com/containers/podman/issues/16201)). +- Fixed a bug where a pod was partially created even when its creation has failed ([#16502](https://github.com/containers/podman/issues/16502)). +- Fixed a bug in `podman cp` when copying directories ending with a ".". +([#16421](https://github.com/containers/podman/issues/16421)). +- Fixed a bug where the root `--connection` option would not work with a cached config ([#16282](https://github.com/containers/podman/issues/16282)). +- Fixed a bug with the `--format {{ json .}}` option which resulted in different output compared to docker ([#16436](https://github.com/containers/podman/issues/16436)). +- Fixed short name resolution on Windows to `docker.io` to avoid TTY check failure ([#16417](https://github.com/containers/podman/issues/16417)). +- Fixed a bug with the systemd booted check when /proc is mounted with the `hidepid=2` option ([#16022](https://github.com/containers/podman/issues/16022)). +- Fixed a bug where named volumes were not properly idmapped. +- Fixed a bug in `podman kube play` where the sdnotify proxy could cause Podman to deadlock ([#16076](https://github.com/containers/podman/issues/16076)). +- Fixed a bug where the containers.conf files are reloaded redundantly. +- Fixed a bug where `podman system df` reported wrong image sizes ([#16135](https://github.com/containers/podman/issues/16135)). +- Fixed a bug where `podman inspect` did not correctly remote the IPCMode of containers ([#17189](https://github.com/containers/podman/issues/17189)). +- Fixed a bug where containers created in a pod using the `--userns keep-id` option were not correctly adding username entries to /etc/passwd within container ([#17148](https://github.com/containers/podman/issues/17148)). + +### API +- When creating a container with the Compat API, the `NetworkMode=default` is no longer rewritten to `NetworkMode=bridge` if the `containers.conf` configuration file overwrites `netns` ([#16915](https://github.com/containers/podman/issues/#16915)). +- The Compat Create endpoint now supports the MAC address field in the container config. This ensures that the static mac from the docker-compose.yml is used ([#16411](https://github.com/containers/podman/issues/16411)). +- Fixed a bug in the Compat Build endpoint where the chunked response may have included more JSON objects than expected per chunk ([#16360](https://github.com/containers/podman/issues/16360)). + +### Misc +- Fixed WSL auto-installation when run under Windows ARM x86_64 emulation +- Add initial support for Windows on ARM64. +- Added a systemd unit file that is useful for transient storage mode cleanup. +- The `podman-release-static.tar.gz` artfact has been renamed to `podman-release-static-linux_{amd64,arm64}.tar.gz`. ([#16612](https://github.com/containers/podman/issues/16612)). +- The `podman-installer-macos-aarch64.pkg` artifact has been renamed to `podman-installer-macos-arm64.pkg`. +- The MacOS pkginstaller now installs podman-mac-helper by default ([#16547](https://github.com/containers/podman/issues/16547)). +- Manual overrides of the install location in Windows installer are now allowed. +([#16265](https://github.com/containers/podman/issues/16265)). +- Continued ongoing work on porting Podman to FreeBSD +- Updated the Mac pkginstaller qemu to v7.1.0 +- Updated the Golang version to 1.18. +- Updated the containers/image library to v5.24.0 +- Updated the containers/storage library to v1.45.3 +- Updated the containers/common library to v0.51.0 + ## 4.3.1 ### Bugfixes - Fixed a deadlock between the `podman ps` and `podman container inspect` commands