docker versionコマンドの使い方(実例で解説)

Docker
Docker公式ロゴ3a
©2020 Docker Inc. All rights reserved

 本記事はDocker ver20.10.8の環境で確認しています。

 このコマンドは、DockerクライアントおよびDockerサーバー(デーモン)のバージョン情報を出力することが可能です。

 docker infoコマンドと同様に、Dockerに関する調査などを行う場合は、現状を把握する意味でも、このコマンドを実行し、各種バージョン情報を出力して確認を行った方が良いと思います。

docker versionコマンドのフォーマットとオプション

フォーマット

docker version [オプション]

主なオプション一覧

オプション概説
-f, --format=""Go言語のテンプレートの仕組みを利用して
出力内容を整形できます

コマンド例

$ docker version

docker versionコマンドの主な使い方

 以下で実例をまじえたコマンドの使い方を解説していきたいと思います。

基本事項の解説

 Docker環境の各コンポーネント別のバージョン情報を出力します。

 トラブルが発生した場合、対応技術者に現在の環境情報を伝えるのはとても重要なことです。

 最低でもdocker versionコマンドは採取しておくことをおすすめします。

Dockerのバージョン情報を出力する

 以下のコマンドを実行しますと、Dockerのバージョン情報が出力されます。

$ docker version

 例えば、64bitパソコン上のLinux上にインストールされたDocker(バージョン19.03.10)にて実行した場合の出力例です。

Client: Docker Engine - Community
 Version:           20.10.8
 API version:       1.41
 Go version:        go1.16.6
 Git commit:        3967b7d
 Built:             Fri Jul 30 19:54:08 2021
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.8
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.16.6
  Git commit:       75249d8
  Built:            Fri Jul 30 19:52:16 2021
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.4.9
  GitCommit:        e25210fe30a0a703442421b0f60afac609f950a3
 runc:
  Version:          1.0.1
  GitCommit:        v1.0.1-0-g4144b63
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

 「Client:」部分の各種バージョンは、Dockerクライアントバイナリ及びその実行環境の情報が出力されます。

「Server:」部分の各種バージョンは、Dockerデーモン及びその実行環境の情報が出力されます。

 出力された内容は以下の通りです。

Version
「Client:」セクション内は実行したdockerコマンドのバイナリのバージョン、「Server:」セクション内は処理を行ったdockerデーモンのバージョンが出力されます。

API version
dockerコマンド及びdockerデーモンの各々に実装されているDockerのAPIのバージョンが出力されます。

Go version
dockerコマンド及びdockerデーモンの各々の実行環境内の、Go言語のランタイムのバージョンが出力されます。

Git commit
dockerコマンド及びdockerデーモンの各々のリリースにおけるgitのコミットIDです。

Built
dockerコマンド及びdockerデーモンの各々のリリースのビルド年月日です。

OS/Arch
dockerコマンド及びdockerデーモンの各々の実行環境の、OS種類及びアーキテクチャが出力されます。

Go言語のテンプレート機能を利用して出力内容を整形する

 デフォルトでは前出のバージョン情報が出力されますが、特定の情報のみ(例えばserverのバージョンのみ)出力したい場合は、以下のように「-f」オプションを付けてコマンドを実行します。

$ docker version -f "{{.Server.Version}}"

 「-f」オプションの後に続いている文字列は、Go言語のテンプレート機能を使用する際の記述方法です。

 テンプレートに「{{json .}}」を指定しますと、docker versionコマンドで取得可能な全情報が出力されます。

出力はjson形式になります。

$ docker version -f "{{json .}}"

 以下は出力例です。

{"Client":{"Platform":{"Name":"Docker Engine - 
Community"},"Version":"20.10.8","ApiVersion":
"1.41","DefaultAPIVersion":"1.41","GitCommit":
"3967b7d","GoVersion":"go1.16.6","Os":"linux",
"Arch":"amd64","BuildTime":"Fri Jul 30 19:54:08
 2021","Context":"default","Experimental":true
},"Server":{"Platform":{"Name":"Docker Engine -
 Community"},"Components":[{"Name":"Engine","Ve
rsion":"20.10.8","Details":{"ApiVersion":"1.41"
,"Arch":"amd64","BuildTime":"Fri Jul 30 19:52:1
6 2021","Experimental":"false","GitCommit":"752
49d8","GoVersion":"go1.16.6","KernelVersion":"4
.15.0-153-generic","MinAPIVersion":"1.12","Os":
"linux"}},{"Name":"containerd","Version":"1.4.9
","Details":{"GitCommit":"e25210fe30a0a70344242
1b0f60afac609f950a3"}},{"Name":"runc","Version"
:"1.0.1","Details":{"GitCommit":"v1.0.1-0-g4144
b63"}},{"Name":"docker-init","Version":"0.19.0"
,"Details":{"GitCommit":"de40ad0"}}],"Version":
"20.10.8","ApiVersion":"1.41","MinAPIVersion":"
1.12","GitCommit":"75249d8","GoVersion":"go1.16
.6","Os":"linux","Arch":"amd64","KernelVersion"
:"4.15.0-153-generic","BuildTime":"2021-07-30T1
9:52:16.000000000+00:00"}}

おわりに

  以上でdocker versionコマンドの紹介を終わります。

 docker infoコマンドでもdockerシステムに関する有用な情報を出力できますので、合わせてご利用になることをおすすめします。

 docker infoコマンドに関しましては別記事「docker infoコマンドの使い方(実例で解説)」をご参照下さい。

 ご指摘、ご要望などが御座いましたらコメントいただけるとうれしいです。

 他のDockerコマンドの実例付紹介記事は、本サイト内の別記事「Dockerのコマンドの一覧(オリジナルな実例付き)」をご参照ください。

 ご訪問ありがとうございました!

コメント

タイトルとURLをコピーしました