Docker の使い方（その３：コンテナイメージ）

Docker Desktop でコンテナイメージの一覧を表示するには、Docker Desktop の左メニューの「Images」をクリックします。

コマンドでコンテナイメージの一覧を表示するには、docker image ls コマンドを使用します。

docker image ls

REPOSITORY   TAG       IMAGE ID       CREATED              SIZE
test-img     latest    7a8e49daffc3   About a minute ago   456MB

コマンドで Docker Hub のコンテナイメージを探すには、docker search コマンドを使用します。

docker search <検索ワード>

docker search httpd

Dockerfile は、コンテナイメージをどのように作成するかを記載したシンプルなテキストベースのスクリプトファイルです。 「Dockerfile」というファイル名で作成します。拡張子は無いので注意してください。

詳しい Dockerfile の書き方については、ここでは記載しません。 あまりにも大量にありますので、公式のドキュメントを見てもらった方が良いと思います。

• Dockerfile リファレンス — Docker-docs-ja 20.10 ドキュメント
• Dockerfile reference | Docker Documentation

書式と簡単な例だけ記載しておきます。

# コメント
命令 引数

# コンテナイメージ「httpd:2.4」をベースとする
FROM httpd:2.4

# ホストの「./public-html/」にあるファイルを、
# コンテナイメージの「/usr/local/apache2/htdocs/」にコピー
COPY ./public-html/ /usr/local/apache2/htdocs/

Dockerfile の内容に従ってコンテナイメージを作成するのが、docker image build コマンドです。

-t オプションを使用すると、コンテナイメージに名前（とタグ）を付けることができます。 ちなみに、-t オプションを使用しないと、名前のないコンテナイメージが作成されるので注意してください。

docker image build -t <コンテナイメージの名前[:タグ]> <Dockerfileの場所>

docker image build -t test-img .

コンテナイメージに脆弱性が存在するか調べるには、先に Docker ID でのログインが必要になります。 Docker ID でのログイン方法は、「Docker の使い方（その１：概要）」を参照してください。

コンテナイメージに脆弱性が存在するか調べるには、docker scan コマンドを使用します。

docker scan <コンテナイメージの名前>

docker scan test-img

Docker Desktop でコンテナイメージの履歴を表示するには、Docker Desktop の「Images」からコンテナイメージの履歴を表示したいコンテナイメージのメニューを表示し、「Inspect」をクリックします。

コマンドでコンテナイメージの履歴を表示するには、docker image history コマンドを使用します。

docker image history <コンテナイメージのIDもしくは名前>

docker image history test-img

IMAGE          CREATED          CREATED BY                                      SIZE      COMMENT
7a8e49daffc3   27 minutes ago   CMD ["node" "src/index.js"]                     0B        buildkit.dockerfile.v0
<missing>      27 minutes ago   RUN /bin/sh -c yarn install --production # b…  83.8MB    buildkit.dockerfile.v0
<missing>      28 minutes ago   COPY . . # buildkit                             58.1MB    buildkit.dockerfile.v0
<missing>      29 minutes ago   WORKDIR /app                                    0B        buildkit.dockerfile.v0
<missing>      29 minutes ago   RUN /bin/sh -c apk add --no-cache python2 g+…  223MB     buildkit.dockerfile.v0
<missing>      3 days ago       /bin/sh -c #(nop)  CMD ["node"]                 0B
<missing>      3 days ago       /bin/sh -c #(nop)  ENTRYPOINT ["docker-entry…  0B
<missing>      3 days ago       /bin/sh -c #(nop) COPY file:4d192565a7220e13…  388B
<missing>      3 days ago       /bin/sh -c apk add --no-cache --virtual .bui…  7.84MB
<missing>      3 days ago       /bin/sh -c #(nop)  ENV YARN_VERSION=1.22.17     0B
<missing>      3 days ago       /bin/sh -c addgroup -g 1000 node     && addu…  77.6MB
<missing>      3 days ago       /bin/sh -c #(nop)  ENV NODE_VERSION=12.22.10    0B
<missing>      2 months ago     /bin/sh -c #(nop)  CMD ["/bin/sh"]              0B
<missing>      2 months ago     /bin/sh -c #(nop) ADD file:9233f6f2237d79659…  5.59MB

Docker Desktop でコンテナイメージを削除するには、Docker Desktop の「Images」から削除したいコンテナイメージのメニューを表示し、「Remove」をクリックします。

コマンドでコンテナイメージを削除するには、docker image rm コマンドを使用します。

docker image rm <コンテナイメージのIDもしくは名前>

docker image rm test-img

未使用のコンテナイメージがたくさんあって、1つ1つ削除するのがメンドウな場合には、 docker image prune コマンドが便利です。

オプション無しで使用した場合は、宙ぶらりんイメージ（dangling image）のみ削除されます。 宙ぶらりんイメージとは、タグを持たず、他のコンテナからも参照されていないコンテナイメージです。

未使用のコンテナイメージを全て削除するには、-a オプションを使用します。

docker image prune

docker image prune -a

Docker Hub にアップロードするコンテナイメージはデフォルトでは公開リポジトリになり、誰でもダウンロードできる状態になります。 プライベートリポジトリにしたい場合は、先に Docker Hub でプライベートリポジトリを作成する必要があります。 Docker Hub の Personal プランでは、プライベートリポジトリは1つしか作成できません。 注意してください。

Docker Hub にコンテナイメージをアップロードするには、コンテナイメージの名前を「Docker ID（ユーザー名）/コンテナイメージの名前」の形式に変更し、任意のタグを付ける必要があります。 docker image tag コマンドを使用すると、コンテナイメージの名前の変更と、タグを付けることができます。 タグが未指定の場合は、タグはデフォルトで「latest」（つまり、最新版）になります。

docker image tag <古いコンテナイメージ名前[:タグ]> <新しいコンテナイメージ名前[:タグ]>

docker image tag old-img test-user/test-img:1.0

Docker Hub にコンテナイメージをアップロードするには、先に Docker ID でのログインが必要になります。 Docker ID でのログイン方法は、「Docker の使い方（その１：概要）」を参照してください。

Docker Hub にコンテナイメージをアップロードするには、Docker Desktop から行う方法と、コマンドで行う方法の2種類があります。

Docker Desktop でコンテナイメージをアップロードするには、Docker Desktop の「Images」からアップロードするしたいコンテナイメージのメニューを表示し、「Push to Hub」をクリックします。

コマンドでコンテナイメージをアップロードするには、docker image push コマンドを使用します。 docker image push コマンドには、コンテナイメージの名前とタグを指定できます。 タグが未指定の場合は、タグはデフォルトで「latest」（つまり、最新版）になります。

docker image push <Docker ID（ユーザー名）/コンテナイメージの名前[:タグ]>

docker image push test-user/test-img

docker image push test-user/test-img:1.0