From 3ae582071eca532a4c9f89812fdf3c0326c97ff6 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Tue, 23 Jul 2024 14:43:42 +0200 Subject: [PATCH] engine: update to v27.1.0 - Add release notes - Update examples in installation section - Align some formatting between distros in the install section Signed-off-by: Sebastiaan van Stijn --- content/engine/api/_index.md | 17 ++++--- content/engine/install/centos.md | 9 ++-- content/engine/install/debian.md | 6 +-- content/engine/install/fedora.md | 4 +- content/engine/install/raspberry-pi-os.md | 8 +-- content/engine/install/rhel.md | 9 ++-- content/engine/install/sles.md | 6 +-- content/engine/install/ubuntu.md | 4 +- content/engine/release-notes/27.0.md | 7 --- content/engine/release-notes/27.1.md | 60 +++++++++++++++++++++++ data/toc.yaml | 6 ++- hugo.yaml | 6 +-- 12 files changed, 98 insertions(+), 44 deletions(-) create mode 100644 content/engine/release-notes/27.1.md diff --git a/content/engine/api/_index.md b/content/engine/api/_index.md index 8500cc0984..64959d5dd4 100644 --- a/content/engine/api/_index.md +++ b/content/engine/api/_index.md @@ -73,21 +73,21 @@ To see the highest version of the API your Docker daemon and client support, use ```console $ docker version Client: Docker Engine - Community - Version: 27.0.3 + Version: 27.1.0 API version: 1.46 - Go version: go1.21.11 - Git commit: 7d4bcd8 - Built: Sat Jun 29 00:02:23 2024 + Go version: go1.21.12 + Git commit: 6312585 + Built: Fri Jul 19 17:42:42 2024 OS/Arch: linux/arm64 Context: default Server: Docker Engine - Community Engine: - Version: 27.0.3 + Version: 27.1.0 API version: 1.46 (minimum version 1.24) - Go version: go1.21.11 - Git commit: 662f78c - Built: Sat Jun 29 00:02:23 2024 + Go version: go1.21.12 + Git commit: a21b1a2 + Built: Fri Jul 19 17:42:42 2024 OS/Arch: linux/arm64 Experimental: false ... @@ -127,6 +127,7 @@ You can specify the API version to use in any of the following ways: | Docker version | Maximum API version | Change log | |:---------------|:---------------------------|:---------------------------------------------------------| +| 27.1 | [1.46](/engine/api/v1.46/) | [changes](/engine/api/version-history/#v146-api-changes) | | 27.0 | [1.46](/engine/api/v1.46/) | [changes](/engine/api/version-history/#v146-api-changes) | | 26.1 | [1.45](/engine/api/v1.45/) | [changes](/engine/api/version-history/#v145-api-changes) | | 26.0 | [1.45](/engine/api/v1.45/) | [changes](/engine/api/version-history/#v145-api-changes) | diff --git a/content/engine/install/centos.md b/content/engine/install/centos.md index a1fbffcbd7..af9b7feba5 100644 --- a/content/engine/install/centos.md +++ b/content/engine/install/centos.md @@ -105,7 +105,7 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce This command installs Docker, but it doesn't start Docker. It also creates a `docker` group, however, it doesn't add any users to the group by default. - + {{< /tab >}} {{< tab name="Specific version" >}} @@ -115,8 +115,8 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce ```console $ yum list docker-ce --showduplicates | sort -r + docker-ce.x86_64 3:27.1.0-1.el9 docker-ce-stable docker-ce.x86_64 3:27.0.3-1.el9 docker-ce-stable - docker-ce.x86_64 3:27.0.2-1.el9 docker-ce-stable <...> ``` @@ -125,7 +125,7 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce Install a specific version by its fully qualified package name, which is the package name (`docker-ce`) plus the version string (2nd column), - separated by a hyphen (`-`). For example, `docker-ce-3:27.0.3-1.el9`. + separated by a hyphen (`-`). For example, `docker-ce-3:27.1.0-1.el9`. Replace `` with the desired version and then run the following command to install: @@ -136,11 +136,10 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce This command installs Docker, but it doesn't start Docker. It also creates a `docker` group, however, it doesn't add any users to the group by default. - + {{< /tab >}} {{< /tabs >}} - 2. Start Docker. ```console diff --git a/content/engine/install/debian.md b/content/engine/install/debian.md index 8a83c25731..7cef12af66 100644 --- a/content/engine/install/debian.md +++ b/content/engine/install/debian.md @@ -154,18 +154,18 @@ Docker from the repository. # List the available versions: $ apt-cache madison docker-ce | awk '{ print $3 }' + 5:27.1.0-1~debian.12~bookworm 5:27.0.3-1~debian.12~bookworm - 5:27.0.2-1~debian.12~bookworm ... ``` Select the desired version and install: ```console - $ VERSION_STRING=5:27.0.3-1~debian.12~bookworm + $ VERSION_STRING=5:27.1.0-1~debian.12~bookworm $ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin ``` - + {{< /tab >}} {{< /tabs >}} diff --git a/content/engine/install/fedora.md b/content/engine/install/fedora.md index 51f1ac2905..33e5cd7aba 100644 --- a/content/engine/install/fedora.md +++ b/content/engine/install/fedora.md @@ -112,8 +112,8 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce ```console $ dnf list docker-ce --showduplicates | sort -r + docker-ce.x86_64 3:27.1.0-1.fc40 docker-ce-stable docker-ce.x86_64 3:27.0.3-1.fc40 docker-ce-stable - docker-ce.x86_64 3:27.0.2-1.fc40 docker-ce-stable <...> ``` @@ -122,7 +122,7 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce Install a specific version by its fully qualified package name, which is the package name (`docker-ce`) plus the version string (2nd column), - separated by a hyphen (`-`). For example, `docker-ce-3:27.0.3-1.fc40`. + separated by a hyphen (`-`). For example, `docker-ce-3:27.1.0-1.fc40`. Replace `` with the desired version and then run the following command to install: diff --git a/content/engine/install/raspberry-pi-os.md b/content/engine/install/raspberry-pi-os.md index 9e273d5d4f..c478aa304c 100644 --- a/content/engine/install/raspberry-pi-os.md +++ b/content/engine/install/raspberry-pi-os.md @@ -114,7 +114,7 @@ Docker from the repository. sudo curl -fsSL {{% param "download-url-base" %}}/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc - # Set up Docker's APT repository: + # Add the repository to Apt sources: echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] {{% param "download-url-base" %}} \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ @@ -135,7 +135,7 @@ Docker from the repository. {{< /tab >}} {{< tab name="Specific version" >}} - + To install a specific version of Docker Engine, start by listing the available versions in the repository: @@ -143,15 +143,15 @@ Docker from the repository. # List the available versions: $ apt-cache madison docker-ce | awk '{ print $3 }' + 5:27.1.0-1~raspbian.12~bookworm 5:27.0.3-1~raspbian.12~bookworm - 5:27.0.2-1~raspbian.12~bookworm ... ``` Select the desired version and install: ```console - $ VERSION_STRING=5:27.0.3-1~raspbian.12~bookworm + $ VERSION_STRING=5:27.1.0-1~raspbian.12~bookworm $ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin ``` diff --git a/content/engine/install/rhel.md b/content/engine/install/rhel.md index 702276d09e..3373dce848 100644 --- a/content/engine/install/rhel.md +++ b/content/engine/install/rhel.md @@ -90,7 +90,6 @@ Docker from the repository. #### Set up the repository - Install the `yum-utils` package (which provides the `yum-config-manager` utility) and set up the repository. @@ -105,7 +104,7 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce {{< tabs >}} {{< tab name="Latest" >}} - + To install the latest version, run: ```console @@ -127,8 +126,8 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce ```console $ yum list docker-ce --showduplicates | sort -r + docker-ce.x86_64 3:27.1.0-1.el9 docker-ce-stable docker-ce.x86_64 3:27.0.3-1.el9 docker-ce-stable - docker-ce.x86_64 3:27.0.2-1.el9 docker-ce-stable <...> ``` @@ -137,7 +136,7 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce Install a specific version by its fully qualified package name, which is the package name (`docker-ce`) plus the version string (2nd column), - separated by a hyphen (`-`). For example, `docker-ce-3:27.0.3-1.el9`. + separated by a hyphen (`-`). For example, `docker-ce-3:27.1.0-1.el9`. Replace `` with the desired version and then run the following command to install: @@ -148,7 +147,7 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce This command installs Docker, but it doesn't start Docker. It also creates a `docker` group, however, it doesn't add any users to the group by default. - + {{< /tab >}} {{< /tabs >}} diff --git a/content/engine/install/sles.md b/content/engine/install/sles.md index ca6bed8e70..b0fb599f0d 100644 --- a/content/engine/install/sles.md +++ b/content/engine/install/sles.md @@ -137,8 +137,8 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo ```console $ sudo zypper search -s --match-exact docker-ce | sort -r - v | docker-ce | package | 3:25.0.0-3 | s390x | Docker CE Stable - s390x - v | docker-ce | package | 3:24.0.7-3 | s390x | Docker CE Stable - s390x + v | docker-ce | package | 3:27.0.3-1 | s390x | Docker CE Stable - s390x + v | docker-ce | package | 3:27.0.2-1 | s390x | Docker CE Stable - s390x ``` The list returned depends on which repositories are enabled, and is specific @@ -146,7 +146,7 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo Install a specific version by its fully qualified package name, which is the package name (`docker-ce`) plus the version string (2nd column), - separated by a hyphen (`-`). For example, `docker-ce-3:25.0.0`. + separated by a hyphen (`-`). For example, `docker-ce-3:27.0.3`. Replace `` with the desired version and then run the following command to install: diff --git a/content/engine/install/ubuntu.md b/content/engine/install/ubuntu.md index 8c53144f05..0472ac0e75 100644 --- a/content/engine/install/ubuntu.md +++ b/content/engine/install/ubuntu.md @@ -157,15 +157,15 @@ Docker from the repository. # List the available versions: $ apt-cache madison docker-ce | awk '{ print $3 }' + 5:27.1.0-1~ubuntu.24.04~noble 5:27.0.3-1~ubuntu.24.04~noble - 5:27.0.2-1~ubuntu.24.04~noble ... ``` Select the desired version and install: ```console - $ VERSION_STRING=5:27.0.3-1~ubuntu.24.04~noble + $ VERSION_STRING=5:27.1.0-1~ubuntu.24.04~noble $ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin ``` diff --git a/content/engine/release-notes/27.0.md b/content/engine/release-notes/27.0.md index 9b9dbdda32..cd1c2bb64e 100644 --- a/content/engine/release-notes/27.0.md +++ b/content/engine/release-notes/27.0.md @@ -5,13 +5,6 @@ keywords: docker, docker engine, ce, whats new, release notes toc_min: 1 toc_max: 2 skip_read_time: true -tags: - - Release notes -aliases: -- /engine/release-notes/ -- /engine/release-notes/latest/ -- /release-notes/docker-ce/ -- /release-notes/docker-engine/ --- This page describes the latest changes, additions, known issues, and fixes for Docker Engine version 27.0. diff --git a/content/engine/release-notes/27.1.md b/content/engine/release-notes/27.1.md new file mode 100644 index 0000000000..20b8a2a292 --- /dev/null +++ b/content/engine/release-notes/27.1.md @@ -0,0 +1,60 @@ +--- +title: Docker Engine 27.1 release notes +description: Learn about the new features, bug fixes, and breaking changes for Docker Engine +keywords: docker, docker engine, ce, whats new, release notes +toc_min: 1 +toc_max: 2 +skip_read_time: true +tags: + - Release notes +aliases: +- /engine/release-notes/ +- /engine/release-notes/latest/ +- /release-notes/docker-ce/ +- /release-notes/docker-engine/ +--- + +This page describes the latest changes, additions, known issues, and fixes for Docker Engine version 27.1. + +For more information about: + +- Deprecated and removed features, see [Deprecated Engine Features](../deprecated.md). +- Changes to the Engine API, see [Engine API version history](../api/version-history.md). + +## 27.1.0 + +{{< release-date date="2024-07-22" >}} + +For a full list of pull requests and changes in this release, refer to the relevant GitHub milestones: + +- [docker/cli, 27.1.0 milestone](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A27.1.0) +- [moby/moby, 27.1.0 milestone](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A27.1.0) +- Deprecated and removed features, see [Deprecated Features](https://github.com/docker/cli/blob/v27.1.0/docs/deprecated.md). +- Changes to the Engine API, see [API version history](https://github.com/moby/moby/blob/v27.1.0/docs/api/version-history.md). + +### Bug fixes and enhancements + +- rootless: add `Requires=dbus.socket` to prevent errors when starting the daemon on a cgroup v2 host with systemd [moby/moby#48141](https://github.com/moby/moby/pull/48141) +- containerd integration: `image tag` event is now properly emitted when building images with BuildKit [moby/moby#48182](https://github.com/moby/moby/pull/48182) +- CLI: enable shell completion for `docker image rm`, `docker image history`, and `docker image inspect` [moby/moby#5261](https://github.com/moby/moby/pull/5261) +- CLI: add and improve shell completions for various flags [moby/moby#5261](https://github.com/moby/moby/pull/5261) +- CLI: add OOMScoreAdj to `docker service create` and `docker stack` [docker/cli#5274](https://github.com/docker/cli/pull/5274) +- CLI: add support for `DOCKER_CUSTOM_HEADERS` environment variable (experimental) [docker/cli#5271](https://github.com/docker/cli/pull/5271) +- CLI: containerd-integration: Fix `docker push` defaulting the `--platform` flag to a value of `DOCKER_DEFAULT_PLATFORM` environment variable on unsupported API versions [docker/cli#5248](https://github.com/docker/cli/pull/5248) +- CLI: fix: context cancellation on `login` prompt [docker/cli#5260](https://github.com/docker/cli/pull/5260) +- CLI: fix: wait for the container to exit before closing the stream when sending a termination request to the CLI while attached to a container [docker/cli#5250](https://github.com/docker/cli/pull/5250) + +### Deprecated + +- The `pkg/rootless/specconv` package is deprecated, and will be removed in the next release [moby/moby#48185](https://github.com/moby/moby/pull/48185) +- The `pkg/containerfs` package is deprecated, and will be removed in the next release [moby/moby#48185](https://github.com/moby/moby/pull/48185) +- The `pkg/directory` package is deprecated, and will be removed in the next release [moby/moby#48185](https://github.com/moby/moby/pull/48185) +- `api/types/system`: remove deprecated `Info.ExecutionDriver` [moby/moby#48184](https://github.com/moby/moby/pull/48184) + +### Packaging updates + +- Update Buildx to [v0.16.1](https://github.com/docker/buildx/releases/tag/v0.16.1). [moby/docker-ce-packaging#1039](https://github.com/docker/docker-ce-packaging/pull/1039) +- Update Compose to [v2.29.0](https://github.com/docker/compose/releases/tag/v2.29.0). [moby/docker-ce-packaging#1038](https://github.com/docker/docker-ce-packaging/pull/1038) +- Update Containerd (static binaries only) to [v1.7.20](https://github.com/containerd/containerd/releases/tag/v1.7.20). [moby/moby#48191](https://github.com/moby/moby/pull/48191) +- Update BuildKit to [v0.15.0](https://github.com/moby/buildkit/releases/tag/v0.15.0). [moby/moby#48175](https://github.com/moby/moby/pull/48175) +- Update Go runtime to 1.21.12, which contains security fixes for [CVE-2024-24791](https://github.com/advisories/GHSA-hw49-2p59-3mhj) [moby/moby#48120](https://github.com/moby/moby/pull/48120) diff --git a/data/toc.yaml b/data/toc.yaml index 23a57b868e..ab9169ad1c 100644 --- a/data/toc.yaml +++ b/data/toc.yaml @@ -1827,10 +1827,12 @@ Manuals: title: Deprecated features - sectiontitle: Release notes section: - - path: /engine/release-notes/27.0/ - title: Engine 27.0 + - path: /engine/release-notes/27.1/ + title: Engine 27.1 - sectiontitle: Previous versions section: + - path: /engine/release-notes/27.0/ + title: Engine 27.0 - path: /engine/release-notes/26.1/ title: Engine 26.1 - path: /engine/release-notes/26.0/ diff --git a/hugo.yaml b/hugo.yaml index a1a7917890..48d98851c7 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -98,14 +98,14 @@ params: docs_url: https://docs.docker.com latest_engine_api_version: "1.46" - docker_ce_version: "27.0.2" + docker_ce_version: "27.1.0" compose_version: "v2.29.0" compose_file_v3: "3.8" compose_file_v2: "2.4" - buildkit_version: "0.14.1" + buildkit_version: "0.15.0" example_go_version: "1.21" - example_golangci_lint_version: "v1.52" + example_golangci_lint_version: "v1.59" example_alpine_version: "3.20" example_node_version: "20"