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

add --format flag to `docker version` 

Signed-off-by: Patrick Hemmer <patrick.hemmer@gmail.com>
This commit is contained in:
Patrick Hemmer 2015-06-25 21:25:41 -04:00 committed by Tibor Vass
parent 23256b7438
commit 90f2c9cf90
2 changed files with 45 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/reference/commandline/version.md
View File

@ -15,8 +15,17 @@ weight=1
Show the Docker version information. Show the Docker version information.
Show the Docker version, API version, Go version, Git commit, Build date/time, -f, --format="" Format the output using the given go template
and OS/architecture of both Docker client and daemon. Example use:
By default, this will render all version information in an easy to read
layout. If a format is specified, the given template will be executed instead.
Go's [text/template](http://golang.org/pkg/text/template/) package
describes all the details of the format.
## Examples
**Default output:**
$ docker version $ docker version
Client: Client:
@ -33,4 +42,15 @@ and OS/architecture of both Docker client and daemon. Example use:
Go version: go1.4.2 Go version: go1.4.2
Git commit: f5bae0a Git commit: f5bae0a
Built: Tue Jun 23 17:56:00 UTC 2015 Built: Tue Jun 23 17:56:00 UTC 2015
OS/Arch: linux/amd64 OS/Arch: linux/amd64
**Get server version:**
$ docker version --format '{{.Server.Version}}'
1.8.0
**Dump raw data:**
$ 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"}}

24
man/docker-version.1.md
View File

@ -6,19 +6,25 @@ docker-version - Show the Docker version information.
# SYNOPSIS # SYNOPSIS
**docker version** **docker version**
[**--help**]
[**-f**|**--format**[=*FORMAT*]]
# DESCRIPTION # DESCRIPTION
This command displays version information for both the Docker client and This command displays version information for both the Docker client and
daemon. daemon.
# OPTIONS # OPTIONS
There are no available options. **--help**
Print usage statement
**-f**, **--format**=""
Format the output using the given go template.
# EXAMPLES # EXAMPLES
## Display Docker version information ## Display Docker version information
Here is a sample output: The default output:
$ docker version $ docker version
Client: Client:
@ -36,7 +42,21 @@ Here is a sample output:
Git commit: f5bae0a Git commit: f5bae0a
Built: Tue Jun 23 17:56:00 UTC 2015 Built: Tue Jun 23 17:56:00 UTC 2015
OS/Arch: linux/amd64 OS/Arch: linux/amd64
Get server version:
$ docker version --format '{{.Server.Version}}'
1.8.0
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"}}
# HISTORY # HISTORY
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
June 2015, updated by John Howard <jhoward@microsoft.com> June 2015, updated by John Howard <jhoward@microsoft.com>
June 2015, updated by Patrick Hemmer <patrick.hemmer@gmail.com