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 を削除します。