docker search

読む時間の目安: 3 分

説明

Docker Hub 上のイメージを検索します。

利用方法

$ docker search [オプション] TERM

追加説明

Docker Hub 上のイメージを検索します。

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

オプション

名前／省略形	デフォルト	説明
`--filter` , `-f`		指定された条件に基づいてフィルター検索を行います。
`--format`		Go 言語テンプレートを使って出力をフォーマットします。
`--limit`	`25`	検索結果の最大数。
`--no-trunc`		詳細出力を行います。

利用例

イメージ名による検索

以下の例では、イメージ名に「busybox」という文字を含むイメージを表示します。

$ docker search busybox

NAME                             DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
busybox                          Busybox base image.                             316       [OK]
progrium/busybox                                                                 50                   [OK]
radial/busyboxplus               Full-chain, Internet enabled, busybox made...   8                    [OK]
odise/busybox-python                                                             2                    [OK]
azukiapp/busybox                 This image is meant to be used as the base...   2                    [OK]
ofayau/busybox-jvm               Prepare busybox to install a 32 bits JVM.       1                    [OK]
shingonoide/archlinux-busybox    Arch Linux, a lightweight and flexible Lin...   1                    [OK]
odise/busybox-curl                                                               1                    [OK]
ofayau/busybox-libc32            Busybox with 32 bits (and 64 bits) libs         1                    [OK]
peelsky/zulu-openjdk-busybox                                                     1                    [OK]
skomma/busybox-data              Docker image suitable for data volume cont...   1                    [OK]
elektritter/busybox-teamspeak    Lightweight teamspeak3 container based on...    1                    [OK]
socketplane/busybox                                                              1                    [OK]
oveits/docker-nginx-busybox      This is a tiny NginX docker image based on...   0                    [OK]
ggtools/busybox-ubuntu           Busybox ubuntu version with extra goodies       0                    [OK]
nikfoundas/busybox-confd         Minimal busybox based distribution of confd     0                    [OK]
openshift/busybox-http-app                                                       0                    [OK]
jllopis/busybox                                                                  0                    [OK]
swyckoff/busybox                                                                 0                    [OK]
powellquiring/busybox                                                            0                    [OK]
williamyeh/busybox-sh            Docker image for BusyBox's sh                   0                    [OK]
simplexsys/busybox-cli-powered   Docker busybox images, with a few often us...   0                    [OK]
fhisamoto/busybox-java           Busybox java                                    0                    [OK]
scottabernethy/busybox                                                           0                    [OK]
marclop/busybox-solr

詳細表示（--no-trunc）

以下の例では、イメージ名に「busybox」という文字を含むイメージを表示します。そして星印が 3 つ以上つけられているもので、内容説明を省略せずに出力します。

$ docker search --filter=stars=3 --no-trunc busybox

NAME                 DESCRIPTION                                                                               STARS     OFFICIAL   AUTOMATED
busybox              Busybox base image.                                                                       325       [OK]
progrium/busybox                                                                                               50                   [OK]
radial/busyboxplus   Full-chain, Internet enabled, busybox made from scratch. Comes in git and cURL flavors.   8                    [OK]

検索結果の制限 (--limit)

--limitフラグは検索結果として返される結果の最大数を指定します。この値は 1 から 100 の範囲で指定します。 --limitのデフォルト値は 25 です。

フィルター検索

フィルターフラグ（-f または --filter）の指定書式は「キー=値」というものです。複数のフィルターが必要な場合は、フラグを複数指定します。（たとえば --filter "foo=bar" --filter "bif=baz" など。）

現在サポートされているフィルターは以下のとおりです。

stars （整数。イメージが持つ星印の数。）
is-automated （ブール値。true または false）イメージが自動生成されたかどうか。
is-official （ブール値。true または false）イメージが公式のものであるかどうか。

stars

以下の例はイメージ名に「busybox」という文字を含み、星印が 3 つ以上つけられているイメージを表示します。

$ docker search --filter stars=3 busybox

NAME                 DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
busybox              Busybox base image.                             325       [OK]
progrium/busybox                                                     50                   [OK]
radial/busyboxplus   Full-chain, Internet enabled, busybox made...   8                    [OK]

is-automated

以下の例はイメージ名に「busybox」という文字を含み、自動ビルドされたイメージを表示します。

$ docker search --filter is-automated=true busybox

NAME                 DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
progrium/busybox                                                     50                   [OK]
radial/busyboxplus   Full-chain, Internet enabled, busybox made...   8                    [OK]

is-official

以下の例はイメージ名に「busybox」という文字を含み、星印が 3 つ以上つけられた公式ビルドイメージを表示します。

$ docker search --filter is-official=true --filter stars=3 busybox

NAME      DESCRIPTION           STARS     OFFICIAL   AUTOMATED
busybox   Busybox base image.   325       [OK]

フォーマット設定

フォーマット設定オプション（--format）により Go 言語のテンプレートを利用して、検索結果をわかりやすく出力することができます。

Go 言語テンプレートによるプレースホルダー（placeholder）は以下のとおりです。

プレースホルダー	内容説明
`.Name`	イメージ名。
`.Description`	イメージの内容説明。
`.StarCount`	イメージにおける星印の数。
`.IsOfficial`	公式イメージなら「OK」
`.IsAutomated`	自動ビルドイメージなら「OK」

--format オプションを利用すると search コマンドは、テンプレートが定めるデータを直接出力します。また table ディレクティブを利用すると、カラムヘッダーも同時に出力されます。

以下は、ヘッダーを含めずにテンプレートを利用する例であり、すべてのイメージにおける Name、StarCount の各項目がコロン（:）で区切って表示されます。

$ docker search --format "{{.Name}}: {{.StarCount}}" nginx

nginx: 5441
jwilder/nginx-proxy: 953
richarvey/nginx-php-fpm: 353
million12/nginx-php: 75
webdevops/php-nginx: 70
h3nrik/nginx-ldap: 35
bitnami/nginx: 23
evild/alpine-nginx: 14
million12/nginx: 9
maxexcloo/nginx: 7

以下は表形式で出力する例です。

$ docker search --format "table {{.Name}}\t{{.IsAutomated}}\t{{.IsOfficial}}" nginx

NAME                                     AUTOMATED           OFFICIAL
nginx                                                        [OK]
jwilder/nginx-proxy                      [OK]
richarvey/nginx-php-fpm                  [OK]
jrcs/letsencrypt-nginx-proxy-companion   [OK]
million12/nginx-php                      [OK]
webdevops/php-nginx                      [OK]

上位コマンド

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