docker secret inspect

説明

1つまたは複数シークレットの詳細情報を表示します。

  • 【API 1.25+】このコマンドを使うには、クライアントとデーモン API の両方が、少なくとも 1.25 の必要があります。クライアントとデーモン API のバージョンを調べるには、 docker version コマンドを使います。
  • 【Swarm】このコマンドは Swarm オーケストレータと動作します。

使い方

$ docker secret inspect [OPTIONS] SECRET [SECRET...]

補足説明

指定したシークレットを調べます。

デフォルトでは、JSON アレイ形式で結果を表示します。フォーマットを指定すると、指定のテンプレートでそれぞれの結果を表示します。

Go 言語の text/template パッケージに、フォーマットの詳細全てがあります。

設定を使うための詳細情報は、 Docker Config を使って設定データを保管 を参照ください。

注釈

これはクラスタ管理コマンドであり、 swarm manager ノードで実行する必要があります。manager と worker について学ぶには、ドキュメント内の Swarm モードのセクション を参照ください。

コマンドの使用例は、以下の 使用例のセクション をご覧ください。

オプション

名前, 省略形 デフォルト 説明
--format , -f   指定した Go テンプレートで出力
--pretty   人間が見やすい形式で情報を表示

使用例

名前か ID でシークレットを調査

シークレットを名前もしくは ID のどちらかで調べられます。

例えば、次のようなシークレットがあるとします。

$ docker secret ls

ID                          NAME                CREATED             UPDATED
eo7jnzguqgtpdah3cm5srfb97   my_secret           3 minutes ago       3 minutes ago
$ docker secret inspect secret.json

出力は、以下のような JSON 形式です。

[
   {
     "ID": "eo7jnzguqgtpdah3cm5srfb97",
     "Version": {
       "Index": 17
     },
     "CreatedAt": "2017-03-24T08:15:09.735271783Z",
     "UpdatedAt": "2017-03-24T08:15:09.735271783Z",
     "Spec": {
       "Name": "my_secret",
       "Labels": {
         "env": "dev",
         "rev": "20170324"
       }
     }
   }
 ]

書式

--format オプションを使い、特定のシークレットを取得できます。以下のコマンド例は、シークレットを作成した時間の情報を出力します。

$ docker secret inspect --format='{{.CreatedAt}}' eo7jnzguqgtpdah3cm5srfb97

2017-03-24 08:15:09.735271783 +0000 UTC

親コマンド

コマンド 説明
docker secret Docker シークレットを管理

関連コマンド

コマンド 説明
docker secret create ファイルもしくは STDIN(標準入力)を内容としてシークレットを作成
docker secret inspect 1つまたは複数シークレットの詳細情報を表示
docker secret ls シークレット一覧
docker secret rm 1つまたは複数のシークレットを削除