docker config inspect
読む時間の目安: 2 分
説明
1 つまたは複数の Config についての詳細情報を表示します。
API 1.30 以上
このコマンドを利用するには、クライアントとデーモンの API はともに、最低でも
1.30
である必要があります。
クライアント上においてdocker version
コマンドを実行して、クライアントとデーモンの API バージョンを確認してください。
Swarm このコマンドは Swarm オーケストレーターにおいて動作します。
利用方法
$ docker config inspect [オプション] CONFIG [CONFIG...]
追加説明
指定された config についての詳細情報を表示します。
デフォルトでは結果をすべて JSON 配列として返します。 フォーマット指定が行われた場合は、指定されたテンプレートが各項目に適用されて出力されます。
フォーマットの詳細については、Go 言語の text/template パッケージに説明されているので参照してください。
config 利用の詳細については Docker configs を利用した設定データの保存 を参照してください。
メモ
これはクラスター管理コマンドです。 したがって Swarm 上のマネージャーノードにおいて実行する必要があります。 マネージャーノードやワーカーノードについては、Swarm モード を参照してください。
本コマンドの利用例については、以下に示す 利用例の節 を参照してください。
オプション
名前/省略形 | デフォルト | 説明 |
--format , -f |
Go 言語テンプレートを使って出力をフォーマットします。 | |
--pretty |
読みやすい書式で内容を出力します。 |
利用例
名前や ID を指定した config の詳細表示
詳細表示する config を指定するには 名前 または ID を指定します。
たとえば config が以下のものであるとします。
$ docker config ls
ID NAME CREATED UPDATED
eo7jnzguqgtpdah3cm5srfb97 my_config 3 minutes ago 3 minutes ago
$ docker config inspect config.json
結果は JSON 書式として、たとえば以下のようになります。
[
{
"ID": "eo7jnzguqgtpdah3cm5srfb97",
"Version": {
"Index": 17
},
"CreatedAt": "2017-03-24T08:15:09.735271783Z",
"UpdatedAt": "2017-03-24T08:15:09.735271783Z",
"Spec": {
"Name": "my_config",
"Labels": {
"env": "dev",
"rev": "20170324"
},
"Data": "aGVsbG8K"
}
}
]
フォーマット指定
--format オプションを利用すると、config の特定の情報を取得することができます。 以下の実行コマンド例では、config の生成時刻を出力します。
$ docker config inspect --format='{{.CreatedAt}}' eo7jnzguqgtpdah3cm5srfb97
2017-03-24 08:15:09.735271783 +0000 UTC
上位コマンド
コマンド | 説明 |
---|---|
docker config | Docker config を管理します。 |
関連コマンド
コマンド | 説明 |
docker config create | ファイルまたは標準入力から config を生成します。 |
docker config inspect | 1 つまたは複数の Config についての詳細情報を表示します。 |
docker config ls | config の一覧を表示します。 |
docker config rm | 1 つまたは複数の Config を削除します。 |