Sourced fromgithub.com/docker/docker's releases.

v28.0.0

28.0.0

For a full list of pull requests and changes in this release, refer to the relevant GitHub milestones:

• docker/cli, 28.0.0 milestone
• moby/moby, 28.0.0 milestone
• Deprecated and removed features, seeDeprecated Features.
• Changes to the Engine API, seeAPI version history.

New

• Add ability to mount an image inside a container via--mount type=image.moby/moby#48798
  • You can also specify--mount type=image,image-subpath=[subpath],... option to mount a specific path from the image.docker/cli#5755
• docker images --tree now shows metadata badges.docker/cli#5744
• docker load,docker save, anddocker history now support a--platform flag allowing you to choose a specific platform for single-platform operations on multi-platform images.docker/cli#5331
• AddOOMScoreAdj todocker service create anddocker stack.docker/cli#5145
• docker buildx prune now supportsreserved-space,max-used-space,min-free-space andkeep-bytes filters.moby/moby#48720
• Windows: Add support for running containerd as a child process of the daemon, instead of using a system-installed containerd.moby/moby#47955

Networking

• Thedocker-proxy binary has been updated, older versions will not work with the updateddockerd.moby/moby#48132
  • Close a window in which the userland proxy (docker-proxy) could accept TCP connections, that would then fail afteriptables NAT rules were set up.
  • The executablerootlesskit-docker-proxy is no longer used, it has been removed from the build and distribution.
• DNS nameservers read from the host's/etc/resolv.conf are now always accessed from the host's network namespace.moby/moby#48290
  • When the host's/etc/resolv.conf contains no nameservers and there are no--dns overrides, Google's DNS servers are no longer used, apart from by the default bridge network and in build containers.
• Container interfaces in bridge and macvlan networks now use randomly generated MAC addresses.moby/moby#48808
  • Gratuitous ARP / Neighbour Advertisement messages will be sent when the interfaces are started so that, when IP addresses are reused, they're associated with the newly generated MAC address.
  • IPv6 addresses in the default bridge network are now IPAM-assigned, rather than being derived from the MAC address.
• The deprecated OCIprestart hook is now only used by build containers. For other containers, network interfaces are added to the network namespace after task creation is complete, before the container task is started.moby/moby#47406
• Add a newgw-priority option todocker run,docker container create, anddocker network connect. This option will be used by the Engine to determine which network provides the default gateway for a container. Ondocker run, this option is only available through the extended--network syntax.docker/cli#5664
• Add a new netlabelcom.docker.network.endpoint.ifname to customize the interface name used when connecting a container to a network. It's supported by all built-in network drivers on Linux.moby/moby#49155
  • When a container is created with multiple networks specified, there's no guarantee on the order networks will be connected to the container. So, if a custom interface name uses the same prefix as the auto-generated names, for exampleeth, the container might fail to start.
  • The recommended practice is to use a different prefix, for exampleen0, or a numerical suffix high enough to never collide, for exampleeth100.
  • This label can be specified ondocker network connect via the--driver-opt flag, for exampledocker network connect --driver-opt=com.docker.network.endpoint.ifname=foobar ….
  • Or via the long-form--network flag ondocker run, for exampledocker run --network=name=bridge,driver-opt=com.docker.network.endpoint.ifname=foobar …
• If a custom network driver reports capabilityGwAllocChecker then, before a network is created, it will get aGwAllocCheckerRequest with the network's options. The custom driver may then reply that no gateway IP address should be allocated.moby/moby#49372

Port publishing in bridge networks

• dockerd now requiresipset support in the Linux kernel.moby/moby#48596
  • Theiptables andip6tables rules used to implement port publishing and network isolation have been extensively modified. This enables some of the following functional changes, and is a first step in refactoring to enable nativenftables support in a future release.moby/moby#48815
  • If it becomes necessary to downgrade to an earlier version of the daemon, some manual cleanup of the new rules will be necessary. The simplest and surest approach is to reboot the host, or useiptables -F andip6tables -F to flush all existingiptables rules from thefilter table before starting the older version of the daemon. When that is not possible, run the following commands as root:
    • iptables -D FORWARD -m set --match-set docker-ext-bridges-v4 dst -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT; ip6tables -D FORWARD -m set --match-set docker-ext-bridges-v6 dst -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
    • iptables -D FORWARD -m set --match-set docker-ext-bridges-v4 dst -j DOCKER; ip6tables -D FORWARD -m set --match-set docker-ext-bridges-v6 dst -j DOCKER
    • If you were previously running with the iptables filter-FORWARD policy set toACCEPT and need to restore access to unpublished ports, also delete per-bridge-network rules from theDOCKER chains. For example,iptables -D DOCKER ! -i docker0 -o docker0 -j DROP.
• Fix a security issue that was allowing remote hosts to connect directly to a container on its published ports.moby/moby#49325
• Fix a security issue that was allowing neighbor hosts to connect to ports mapped on a loopback address.moby/moby#49325

... (truncated)

• af898ab Merge pull request#49495 from vvoland/update-buildkit
• d67f035 vendor: github.com/moby/buildkit v0.20.0
• 00ab386 Merge pull request#49491 from vvoland/update-buildkit
• 1fde8c4 builder-next: fix cdi manager
• cde9f07 vendor: github.com/moby/buildkit v0.20.0-rc3
• 89e1429 Merge pull request#49490 from thaJeztah/dockerfile_linting
• b2b5590 Dockerfile: fix linting warnings
• 62bc597 Merge pull request#49480 from thaJeztah/docs_api_1.48
• 670cd81 Merge pull request#49485 from vvoland/c8d-list-panic
• a3628f3 docs/api: add documentation for API v1.48
• Additional commits viewable incompare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)