docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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 <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn 2024-07-23 14:43:42 +02:00
parent c1a855fb1d
commit 3ae582071e
No known key found for this signature in database
GPG Key ID: 76698F39D527CE8C
12 changed files with 98 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
content/engine/api/_index.md
View File

@ -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) |

9
content/engine/install/centos.md
View File

@ -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 `<VERSION_STRING>` 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

6
content/engine/install/debian.md
View File

@ -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 >}}

4
content/engine/install/fedora.md
View File

@ -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 `<VERSION_STRING>` with the desired version and then run the following
command to install:

8
content/engine/install/raspberry-pi-os.md
View File

@ -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
```

9
content/engine/install/rhel.md
View File

@ -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 `<VERSION_STRING>` 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 >}}

6
content/engine/install/sles.md
View File

@ -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 `<VERSION_STRING>` with the desired version and then run the following
command to install:

4
content/engine/install/ubuntu.md
View File

@ -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
```

7
content/engine/release-notes/27.0.md
View File

@ -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.

60
content/engine/release-notes/27.1.md Normal file
View File

@ -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)

6
data/toc.yaml
View File

@ -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/

6
hugo.yaml
View File

@ -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"