From 5d33b7276991442f922950516ea50e2b3bbdc740 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Mon, 10 Apr 2023 14:14:29 +0200 Subject: [PATCH] docs: update engine versions in some examples Signed-off-by: Sebastiaan van Stijn --- docs/reference/commandline/build.md | 24 +++++------ docs/reference/commandline/info.md | 30 +++++++------- docs/reference/commandline/node_ls.md | 14 +++---- docs/reference/commandline/version.md | 52 +++++++++++------------ man/src/system/info.md | 19 ++++----- man/src/version.md | 60 ++++++++++++++++++--------- 6 files changed, 108 insertions(+), 91 deletions(-) diff --git a/docs/reference/commandline/build.md b/docs/reference/commandline/build.md index d476ac1f29c0..0a770f603460 100644 --- a/docs/reference/commandline/build.md +++ b/docs/reference/commandline/build.md @@ -661,7 +661,7 @@ The `--squash` option has a number of known limitations: #### Prerequisites -The example on this page is using experimental mode in Docker 19.03. +The example on this page is using experimental mode in Docker 23.03. Experimental mode can be enabled by using the `--experimental` flag when starting the Docker daemon or setting `experimental: true` in the `daemon.json` configuration @@ -673,21 +673,21 @@ line in the `Engine` section: ```console Client: Docker Engine - Community - Version: 19.03.8 - API version: 1.40 - Go version: go1.12.17 - Git commit: afacb8b - Built: Wed Mar 11 01:21:11 2020 + Version: 23.0.3 + API version: 1.42 + Go version: go1.19.7 + Git commit: 3e7cbfd + Built: Tue Apr 4 22:05:41 2023 OS/Arch: darwin/amd64 - Experimental: false + Context: default Server: Docker Engine - Community Engine: - Version: 19.03.8 - API version: 1.40 (minimum version 1.12) - Go version: go1.12.17 - Git commit: afacb8b - Built: Wed Mar 11 01:29:16 2020 + Version: 23.0.3 + API version: 1.42 (minimum version 1.12) + Go version: go1.19.7 + Git commit: 59118bf + Built: Tue Apr 4 22:05:41 2023 OS/Arch: linux/amd64 Experimental: true [...] diff --git a/docs/reference/commandline/info.md b/docs/reference/commandline/info.md index 41235357eec5..9a29bb358b24 100644 --- a/docs/reference/commandline/info.md +++ b/docs/reference/commandline/info.md @@ -52,14 +52,11 @@ Client: Debug Mode: false Plugins: buildx: Docker Buildx (Docker Inc.) - Version: v0.8.2 + Version: v0.10.4 Path: /usr/libexec/docker/cli-plugins/docker-buildx compose: Docker Compose (Docker Inc.) - Version: v2.6.0 + Version: v2.17.2 Path: /usr/libexec/docker/cli-plugins/docker-compose - scan: Docker Scan (Docker Inc.) - Version: v0.17.0 - Path: /usr/libexec/docker/cli-plugins/docker-scan Server: Containers: 14 @@ -67,7 +64,7 @@ Server: Paused: 1 Stopped: 10 Images: 52 - Server Version: 22.06.0 + Server Version: 23.0.3 Storage Driver: overlay2 Backing Filesystem: extfs Supports d_type: true @@ -82,11 +79,11 @@ Server: Network: bridge host ipvlan macvlan null overlay Log: awslogs fluentd gcplogs gelf journald json-file local logentries splunk syslog Swarm: inactive - Runtimes: io.containerd.runc.v2 io.containerd.runtime.v1.linux runc + Runtimes: io.containerd.runc.v2 runc Default Runtime: runc Init Binary: docker-init - containerd version: 212e8b6fa2f44b9c21b2798135fc6fb7c53efc16 - runc version: v1.1.1-0-g52de29d + containerd version: 2806fc1057397dbaeefbea0e4e17bddfbd388f38 + runc version: v1.1.5-0-gf19387a init version: de40ad0 Security Options: apparmor @@ -106,7 +103,7 @@ Server: Username: gordontheturtle Registry: https://index.docker.io/v1/ Experimental: false - Insecure registries: + Insecure Registries: myinsecurehost:5000 127.0.0.0/8 Live Restore Enabled: false @@ -119,7 +116,7 @@ You can also specify the output format: ```console $ docker info --format '{{json .}}' -{"ID":"I54V:OLXT:HVMM:TPKO:JPHQ:CQCD:JNLC:O3BZ:4ZVJ:43XJ:PFHZ:6N2S","Containers":14, ...} +{"ID":"4cee4408-10d2-4e17-891c-a41736ac4536","Containers":14, ...} ``` ### Run `docker info` on Windows @@ -133,9 +130,12 @@ Client: Context: default Debug Mode: false Plugins: - buildx: Docker Buildx (Docker Inc., v0.8.2-docker) - compose: Docker Compose (Docker Inc., v2.6.0) - scan: Docker Scan (Docker Inc., v0.17.0) + buildx: Docker Buildx (Docker Inc.) + Version: v0.10.4 + Path: C:\Program Files\Docker\cli-plugins\docker-buildx.exe + compose: Docker Compose (Docker Inc.) + Version: v2.17.2 + Path: C:\Program Files\Docker\cli-plugins\docker-compose.exe Server: Containers: 1 @@ -143,7 +143,7 @@ Server: Paused: 0 Stopped: 1 Images: 17 - Server Version: 20.10.16 + Server Version: 23.0.3 Storage Driver: windowsfilter Logging Driver: json-file Plugins: diff --git a/docs/reference/commandline/node_ls.md b/docs/reference/commandline/node_ls.md index 1f49595fd0a7..adb9a4ed5cb5 100644 --- a/docs/reference/commandline/node_ls.md +++ b/docs/reference/commandline/node_ls.md @@ -110,10 +110,10 @@ Show all nodes that have a `region` node label set: $ docker node ls --filter node.label=region ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION -yg550ettvsjn6g6t840iaiwgb * swarm-test-01 Ready Active Leader 20.10.2 -2lm9w9kbepgvkzkkeyku40e65 swarm-test-02 Ready Active Reachable 20.10.2 -hc0pu7ntc7s4uvj4pv7z7pz15 swarm-test-03 Ready Active Reachable 20.10.2 -n41b2cijmhifxxvz56vwrs12q swarm-test-04 Ready Active 20.10.2 +yg550ettvsjn6g6t840iaiwgb * swarm-test-01 Ready Active Leader 23.0.3 +2lm9w9kbepgvkzkkeyku40e65 swarm-test-02 Ready Active Reachable 23.0.3 +hc0pu7ntc7s4uvj4pv7z7pz15 swarm-test-03 Ready Active Reachable 23.0.3 +n41b2cijmhifxxvz56vwrs12q swarm-test-04 Ready Active 23.0.3 ``` Show all nodes that have a `region` node label, with value `region-a`: @@ -122,8 +122,8 @@ Show all nodes that have a `region` node label, with value `region-a`: $ docker node ls --filter node.label=region=region-a ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION -yg550ettvsjn6g6t840iaiwgb * swarm-test-01 Ready Active Leader 20.10.2 -2lm9w9kbepgvkzkkeyku40e65 swarm-test-02 Ready Active Reachable 20.10.2 +yg550ettvsjn6g6t840iaiwgb * swarm-test-01 Ready Active Leader 23.0.3 +2lm9w9kbepgvkzkkeyku40e65 swarm-test-02 Ready Active Reachable 23.0.3 ``` #### membership @@ -203,7 +203,7 @@ e216jshn25ckzbvmwlnh5jr3g: swarm-manager1 Ready To list all nodes in JSON format, use the `json` directive: ```console $ docker node ls --format json -{"Availability":"Active","EngineVersion":"20.10.5","Hostname":"docker-desktop","ID":"k8f4w7qtzpj5sqzclcqafw35g","ManagerStatus":"Leader","Self":true,"Status":"Ready","TLSStatus":"Ready"} +{"Availability":"Active","EngineVersion":"23.0.3","Hostname":"docker-desktop","ID":"k8f4w7qtzpj5sqzclcqafw35g","ManagerStatus":"Leader","Self":true,"Status":"Ready","TLSStatus":"Ready"} ``` ## Related commands diff --git a/docs/reference/commandline/version.md b/docs/reference/commandline/version.md index 4dfadfafdc7f..9128380c1e72 100644 --- a/docs/reference/commandline/version.md +++ b/docs/reference/commandline/version.md @@ -37,30 +37,30 @@ machine running Docker Desktop: ```console $ docker version -Client: - Version: 20.10.16 - API version: 1.41 - Go version: go1.17.10 - Git commit: aa7e414 - Built: Thu May 12 09:17:28 2022 +Client: Docker Engine - Community + Version: 23.0.3 + API version: 1.42 + Go version: go1.19.7 + Git commit: 3e7cbfd + Built: Tue Apr 4 22:05:41 2023 OS/Arch: darwin/amd64 Context: default -Server: Docker Desktop 4.8.2 (77141) +Server: Docker Desktop 4.19.0 (12345) Engine: - Version: 20.10.16 - API version: 1.41 (minimum version 1.12) - Go version: go1.17.10 - Git commit: f756502 - Built: Thu May 12 09:15:33 2022 + Version: 23.0.3 + API version: 1.42 (minimum version 1.12) + Go version: go1.19.7 + Git commit: 59118bf + Built: Tue Apr 4 22:05:41 2023 OS/Arch: linux/amd64 Experimental: false containerd: - Version: 1.6.4 - GitCommit: 212e8b6fa2f44b9c21b2798135fc6fb7c53efc16 + Version: 1.6.20 + GitCommit: 2806fc1057397dbaeefbea0e4e17bddfbd388f38 runc: - Version: 1.1.1 - GitCommit: v1.1.1-0-g52de29d + Version: 1.1.5 + GitCommit: v1.1.5-0-gf19387a docker-init: Version: 0.19.0 GitCommit: de40ad0 @@ -82,12 +82,12 @@ remote-test-server $ docker version -Client: - Version: 20.10.16 - API version: 1.40 (downgraded from 1.41) - Go version: go1.17.10 - Git commit: aa7e414 - Built: Thu May 12 09:17:28 2022 +Client: Docker Engine - Community + Version: 23.0.3 + API version: 1.40 (downgraded from 1.42) + Go version: go1.19.7 + Git commit: 3e7cbfd + Built: Tue Apr 4 22:05:41 2023 OS/Arch: darwin/amd64 Context: remote-test-server @@ -142,7 +142,7 @@ $ docker version --format '{{.Client.APIVersion}}' $ unset DOCKER_API_VERSION $ docker version --format '{{.Client.APIVersion}}' -1.41 +1.42 ``` ## Examples @@ -159,7 +159,7 @@ page for details of the format. ```console $ docker version --format '{{.Server.Version}}' -20.10.16 +23.0.3 ``` ### Get the client API version @@ -169,7 +169,7 @@ The following example prints the API version that is used by the client: ```console $ docker version --format '{{.Client.APIVersion}}' -1.41 +1.42 ``` The version shown is the API version that is negotiated between the client @@ -181,5 +181,5 @@ above for more information. ```console $ docker version --format '{{json .}}' -{"Client":{"Platform":{"Name":"Docker Engine - Community"},"Version":"19.03.8","ApiVersion":"1.40","DefaultAPIVersion":"1.40","GitCommit":"afacb8b","GoVersion":"go1.12.17","Os":"darwin","Arch":"amd64","BuildTime":"Wed Mar 11 01:21:11 2020","Experimental":true},"Server":{"Platform":{"Name":"Docker Engine - Community"},"Components":[{"Name":"Engine","Version":"19.03.8","Details":{"ApiVersion":"1.40","Arch":"amd64","BuildTime":"Wed Mar 11 01:29:16 2020","Experimental":"true","GitCommit":"afacb8b","GoVersion":"go1.12.17","KernelVersion":"4.19.76-linuxkit","MinAPIVersion":"1.12","Os":"linux"}},{"Name":"containerd","Version":"v1.2.13","Details":{"GitCommit":"7ad184331fa3e55e52b890ea95e65ba581ae3429"}},{"Name":"runc","Version":"1.0.0-rc10","Details":{"GitCommit":"dc9208a3303feef5b3839f4323d9beb36df0a9dd"}},{"Name":"docker-init","Version":"0.18.0","Details":{"GitCommit":"fec3683"}}],"Version":"19.03.8","ApiVersion":"1.40","MinAPIVersion":"1.12","GitCommit":"afacb8b","GoVersion":"go1.12.17","Os":"linux","Arch":"amd64","KernelVersion":"4.19.76-linuxkit","Experimental":true,"BuildTime":"2020-03-11T01:29:16.000000000+00:00"}} +{"Client":"Version":"23.0.3","ApiVersion":"1.42", ...} ``` diff --git a/man/src/system/info.md b/man/src/system/info.md index 5e9eb96ef914..a4d4bbb978c4 100644 --- a/man/src/system/info.md +++ b/man/src/system/info.md @@ -32,14 +32,11 @@ Client: Debug Mode: false Plugins: buildx: Docker Buildx (Docker Inc.) - Version: v0.8.2 + Version: v0.10.4 Path: /usr/libexec/docker/cli-plugins/docker-buildx compose: Docker Compose (Docker Inc.) - Version: v2.6.0 + Version: v2.17.2 Path: /usr/libexec/docker/cli-plugins/docker-compose - scan: Docker Scan (Docker Inc.) - Version: v0.17.0 - Path: /usr/libexec/docker/cli-plugins/docker-scan Server: Containers: 14 @@ -47,7 +44,7 @@ Server: Paused: 1 Stopped: 10 Images: 52 - Server Version: 22.06.0 + Server Version: 23.0.3 Storage Driver: overlay2 Backing Filesystem: extfs Supports d_type: true @@ -62,11 +59,11 @@ Server: Network: bridge host ipvlan macvlan null overlay Log: awslogs fluentd gcplogs gelf journald json-file local logentries splunk syslog Swarm: inactive - Runtimes: io.containerd.runc.v2 io.containerd.runtime.v1.linux runc + Runtimes: io.containerd.runc.v2 runc Default Runtime: runc Init Binary: docker-init - containerd version: 212e8b6fa2f44b9c21b2798135fc6fb7c53efc16 - runc version: v1.1.1-0-g52de29d + containerd version: 2806fc1057397dbaeefbea0e4e17bddfbd388f38 + runc version: v1.1.5-0-gf19387a init version: de40ad0 Security Options: apparmor @@ -86,7 +83,7 @@ Server: Username: gordontheturtle Registry: https://index.docker.io/v1/ Experimental: false - Insecure registries: + Insecure Registries: myinsecurehost:5000 127.0.0.0/8 Live Restore Enabled: false @@ -95,4 +92,4 @@ Server: You can also specify the output format: $ docker info --format '{{json .}}' - {"ID":"I54V:OLXT:HVMM:TPKO:JPHQ:CQCD:JNLC:O3BZ:4ZVJ:43XJ:PFHZ:6N2S","Containers":14, ...} + {"ID":"4cee4408-10d2-4e17-891c-a41736ac4536","Containers":14, ...} diff --git a/man/src/version.md b/man/src/version.md index 5dea4a297c52..4d5ff070e322 100644 --- a/man/src/version.md +++ b/man/src/version.md @@ -1,37 +1,57 @@ -This command displays version information for both the Docker client and -daemon. +The version command prints the current version number for all independently +versioned Docker components. # EXAMPLES ## Display Docker version information -The default output: +The default output renders all version information divided into two sections; +the "Client" section contains information about the Docker CLI and client +components, and the "Server" section contains information about the Docker +Engine and components used by the Engine, such as the "Containerd" and "Runc" +OCI Runtimes. + +The information shown may differ depending on how you installed Docker and +what components are in use. The following example shows the output on a macOS +machine running Docker Desktop: $ docker version - Client: - Version: 1.8.0 - API version: 1.20 - Go version: go1.4.2 - Git commit: f5bae0a - Built: Tue Jun 23 17:56:00 UTC 2015 - OS/Arch: linux/amd64 - - Server: - Version: 1.8.0 - API version: 1.20 - Go version: go1.4.2 - Git commit: f5bae0a - Built: Tue Jun 23 17:56:00 UTC 2015 - OS/Arch: linux/amd64 + Client: Docker Engine - Community + Version: 23.0.3 + API version: 1.42 + Go version: go1.19.7 + Git commit: 3e7cbfd + Built: Tue Apr 4 22:05:41 2023 + OS/Arch: darwin/amd64 + Context: default + + Server: Docker Desktop 4.19.0 (12345) + Engine: + Version: 23.0.3 + API version: 1.42 (minimum version 1.12) + Go version: go1.19.7 + Git commit: 59118bf + Built: Tue Apr 4 22:05:41 2023 + OS/Arch: linux/amd64 + Experimental: false + containerd: + Version: 1.6.20 + GitCommit: 2806fc1057397dbaeefbea0e4e17bddfbd388f38 + runc: + Version: 1.1.5 + GitCommit: v1.1.5-0-gf19387a + docker-init: + Version: 0.19.0 + GitCommit: de40ad0 Get server version: $ docker version --format '{{.Server.Version}}' - 1.8.0 + 23.0.3 Dump raw data: To view all available fields, you can use the format `{{json .}}`. $ docker version --format '{{json .}}' - {"Client":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"},"ServerOK":true,"Server":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","KernelVersion":"3.13.2-gentoo","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"}} + {"Client":"Version":"23.0.3","ApiVersion":"1.42", ...}