docker version

読む時間の目安: 2 分

説明

Docker のバージョン情報を表示します。

利用方法

$ docker version [オプション]

追加説明

デフォルトで本コマンドは、バージョン情報をわかりやすいレイアウトによりすべて表示します。 出力フォーマットが指定されたときには、そのテンプレートが利用されます。

Go 言語の text/template パッケージに、そのフォーマットに関する詳細が説明されています。

本コマンドの利用例については、以下に示す 利用例の節 を参照してください。

オプション

名前／省略形 デフォルト 説明
--format , -f Go 言語テンプレートを使って出力をフォーマットします。
--kubeconfig deprecatedKubernetes
Kubernetes 設定ファイル。

利用例

デフォルト出力

$ docker version

Client:
 Version:           19.03.8
 API version:       1.40
 Go version:        go1.12.17
 Git commit:        afacb8b
 Built:             Wed Mar 11 01:21:11 2020
 OS/Arch:           darwin/amd64
 Context:           default
 Experimental:      true

Server:
 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
  OS/Arch:          linux/amd64
  Experimental:     true
 containerd:
  Version:          v1.2.13
  GitCommit:        7ad184331fa3e55e52b890ea95e65ba581ae3429
 runc:
  Version:          1.0.0-rc10
  GitCommit:        dc9208a3303feef5b3839f4323d9beb36df0a9dd
 docker-init:
  Version:          0.18.0
  GitCommit:        fec3683

サーバーバージョンの取得

$ docker version --format '{{.Server.Version}}'

19.03.8

JSON データのダンプ出力

$ 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"}}

以下の例では、現時点において利用されている docker context を表示します。

$ docker version --format='{{.Client.Context}}'
default

1 つの例として上の出力結果は、利用するシェルプロンプトにおいて、アクティブなコンテキストを動的に設定するために利用することができます。 下に示すのは、シェルが Bash である場合に上の出力を利用する例です。

~/.bashrcファイル内において、カレントなコンテキストを取得する関数を宣言し、このコマンドをPROMPT_COMMANDとして設定しています。

function docker_context_prompt() {
        PS1="context: $(docker version --format='{{.Client.Context}}')> "
}

PROMPT_COMMAND=docker_context_prompt

~/.bashrcを再読み込みすれば、プロンプト表示にカレントなdocker contextが表示されます。

$ source ~/.bashrc
context: default> docker context create --docker host=unix:///var/run/docker.sock my-context
my-context
Successfully created context "my-context"
context: default> docker context use my-context
my-context
Current context is now "my-context"
context: my-context> docker context use default
default
Current context is now "default"
context: default>

docker contextに関する詳細は、コマンドラインリファレンス内の docker contextの節 を参照してください。

上位コマンド

コマンド 説明
docker Docker CLI の基本コマンド