Docker-docs-ja
20.10

Guides - ガイド

  • Docker 概要
  • Docker の入手
  • Get started - 始めましょう
  • 言語別ガイド
  • Docker で開発
  • CI/CD のセットアップ
  • アプリをクラウドにデプロイ
  • プロダクションでアプリを実行

Product manuals - マニュアル

  • Docker Engine
  • Docker Compose
  • Docker Desktop
  • Docker Hub
  • Docker Machine
  • Docker Toolbox
  • Docker Registry
  • Docker Swarm

Reference - 参考資料

  • リファレンス・参考資料
  • コマンドライン・リファレンス
    • Docker CLI (docker)
      • Docker run リファレンス
      • Docker コマンドラインを使う
      • docker
      • docker (ベースコマンド)
      • docker app
      • docker attach
      • docker build
      • docker builder
      • docker buildx
      • docker checkpoint
      • docker compose
      • docker config
      • docker container
      • docker context
      • docker cp
      • docker create
      • docker diff
      • docker events
      • docker exec
      • docker export
      • docker history
      • docker image
      • docker images
      • docker import
      • docker info
      • docker inspect
      • docker kill
      • docker load
      • docker login
      • docker logout
      • docker logs
      • docker manifest
      • docker network
      • docker node
      • docker pause
      • docker plugin
      • docker port
      • docker ps
      • docker pull
      • docker push
      • docker rename
      • docker restart
      • docker rm
      • docker rmi
      • docker save
      • docker search
        • 説明
        • 使い方
        • 補足説明
        • オプション
        • 使用例
        • 親コマンド
      • docker secret
      • docker service
      • docker stack
      • docker start
      • docker stats
      • docker stop
      • docker system
      • docker tag
      • docker top
      • docker unpause
      • docker update
      • docker version
      • docker volume
      • docker wait
    • Docker Compose CLIリファレンス
    • デーモン CLI (dockerd)
  • Dockerfile リファレンス
  • Compose ファイル リファレンス
  • 用語集

Samples - サンプル

  • サンプル

Docker について

  • リリース・ノート
  • 日本語版について
  • Docker ドキュメント逆引きガイド
  • Docker ドキュメント日本語版 PDF ダウンロード

Docs アーカイブ

  • v19.03
  • v17.06
  • v1.12
  • v1.11
  • v1.10
  • v1.9
Docker-docs-ja
  • Docs »
  • コマンドライン リファレンス »
  • Docker CLI (docker) »
  • docker search
  • Edit on GitHub

docker search¶

目次

  • 説明
  • 使い方
  • 補足説明
  • オプション
  • 使用例
    • イメージ名で検索
    • 説明を省略せずに表示( --no-trunc )
    • 検索結果の上限( --limit )
      • フィルタリング
      • stars
      • is-automated
      • is-official
    • 出力形式
  • 親コマンド

説明¶

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

使い方¶

$ docker search [OPTIONS] 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    Leightweight 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 --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 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
progrium/busybox                                                     50                   [OK]
radial/busyboxplus   Full-chain, Internet enabled, busybox made...   8                    [OK]

出力形式¶

表示形式のオプション( --format )は Go テンプレートを使って検索結果を整形します。

Go テンプレートで有効な placeholder は、こちらです。

プレースホルダ 説明
.Name イメージ名
.Description イメージの説明
.StarCount イメージの star 数
.IsOfficial "OK" イメージが 公式(official)
.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 の基本コマンド

参考

docker search
https://docs.docker.com/engine/reference/commandline/search/
Next Previous

© Copyright 2015-2022, Docker Docs Translation Ja-Jp Project. 最終更新: 2022-05-04

Built with Sphinx using a theme provided by Read the Docs.