Dockerコマンド

コンテナやイメージの作成、起動、停止といった一連の操作は、すべて「Dockerコマンド」を使って行います。これらのコマンドは、Docker Desktopをインストールしていれば、ターミナル(またはコマンドプロンプト)からすぐに利用可能です。

実際のコマンドの実行はこの後ハンズオンを用意しているので、ここでは実行は不要です。コマンドの概要の理解のみで構いません。

Dockerコマンドの書き方には、大きく分けて「正式な記法」と「省略形」の2種類が存在します。

例えば、コンテナを起動するコマンドには以下の2通りがあります。

  • 正式な記法: docker container run
  • 省略形: docker run

現在は、コマンドの構造が整理された「正式な記法」が推奨されています。「何を(container)」「どうする(run)」が明記されるため、操作の意味を理解しやすいのが特徴です。そのため、本講座では基本的にこの正式な記法を使用します。

一方で、古くからDockerを利用しているエンジニアや、少しでも入力を短くしたい場合には「省略形」が好んで使われることもあります。Web上の技術記事などでは省略形が使われていることも多いため、両方の書き方があることを覚えておくと良いでしょう。

1. docker image pull (docker pull)

Docker HubやAmazon ECRなどのコンテナレジストリから、Dockerイメージをダウンロードするコマンドです。 このコマンドを実行することで、ローカルのDockerイメージの中に、取得したイメージが追加されます。そのイメージを、実行したりできます。

1.1 Docker Hubから取得

下記は、nginx:latestという名称のイメージをDocker Hubから取得するコマンドです

docker image pull nginx:latest
💡 ポイント
nginx:latestのlatestの部分は「タグ」と呼ばれ、イメージのバージョンを指定するために使います。latestは「最新版」を意味する特別なタグで、バージョンを省略した場合も自動的にlatestが指定されます。本番環境では、nginx:1.25のように具体的なバージョンを指定することが推奨されます。latestを使うと、pullするタイミングによって取得されるイメージが変わる可能性があり、意図しない動作の原因になることがあるためです。Docker公式のBuilding best practicesでも「Image tags are mutable, meaning a publisher can update a tag to point to a new image」と説明されており、タグが書き換わる可能性があるためビルドの再現性が保証されないことが触れられています。

1.2 Amazon ECRから取得

また、下記はAmazon ECRからイメージを取得する例です。AWSでコンテナを運用する場合、Docker Hubではなく、AWSが提供するAmazon ECRを利用することが一般的です。ECRからのイメージ取得については、後続のハンズオンで詳しく扱います。

docker image pull 123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-web-app:v1
💡 ポイント
123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-web-app:v1の部分は、AWSでECRのイメージを一意に特定するURIです。123456789012はAWSアカウントID、ap-northeast-1はリージョン、my-web-app:v1はリポジトリ名とタグを表しています。AWS公式ドキュメント(AuthorizationData(AWS SDK for Java))にも「https://aws_account_id.dkr.ecr.region.amazonaws.com」というURI形式が明記されています。なお、ECRからプルするには事前に認証(ログイン)が必要です。これらの特定方法や認証手順は別途ECR概要で解説します。

2. docker image build (docker build)

Dockerfile の内容に基づいて、新しいDockerイメージを作成するコマンドです。docker image pullが「コンテナレジストリから既存のイメージをダウンロードする」ものであるのに対して、docker image buildは、Dockerfileの内容に応じて独自のイメージを作成するものです。

下記は、ローカル上にあるDockerfileの定義をもとに、my-imageという名前のイメージを作成するコマンドです。

docker image build -t my-image:latest .

-tはオプションで、イメージに名前(タグ)をつけることができます。今回はmy-image:latestという名前(タグ)をつけています。名前をつけると、イメージの一覧で識別がしやすくなります。これを省略した場合、リポジトリ名やタグ名は設定されず、イメージ一覧では <none> と表示されます。

なお、latestの部分は「最新版」を表すバージョンを指定しています。もしlatestを省略してmy-image等とした場合、自動でlatestが付きます。またバージョンを個別に指定したい場合、my-image:v1、my-image:v2などのように独自にバージョンをつけることができます。

なお、Dockerfileからのイメージビルド方法は本章では扱わず、後続の章で詳しく説明します。

3. docker image ls (docker images)

現在ローカルにダウンロード、または作成されているDockerイメージの一覧を表示するコマンドです。

docker image ls

このコマンドを実行すると、以下の例のようにイメージの一覧が表示されます。

REPOSITORY    TAG       IMAGE ID       CREATED        SIZE
nginx         latest    605c77e624dd   2 weeks ago    141MB
my-image      latest    3a0933f9a5e2   1 minute ago   50MB

4. docker image rm (docker rmi)

不要となったイメージを削除するコマンドです。 以下のコマンドは、my-image:latestというイメージを、ローカルから削除しています。

docker image rm my-image:latest

5. docker container run (docker run)

docker container runは、指定したイメージを用いてコンテナを作成し、起動するコマンドです。

docker container run my-image

このコマンドは、my-imageというイメージをもとにコンテナを起動するコマンドです。

また、実行するコンテナに名前を付けて、管理しやすくすることもできます。

docker container run --name my-container my-image

--nameが、コンテナに名前をつけるオプションです。このコマンドでは、起動されたコンテナにmy-containerという名前をつけて、わかりやすく管理できるようにしています。

docker container runコマンドには他にも様々なオプションがありますが、今後のハンズオンで必要になった段階で説明します。

6. docker container stop (docker stop)

このコマンドは、起動中のコンテナを停止させるためのコマンドです。

docker container stop my-container

このコマンドは、起動しているmy-containerという名前のコンテナを停止するコマンドです。 先ほどのrunコマンドで--nameオプションを使って名前を付けていたため、その名前を指定するだけで簡単に停止対象を選ぶことができます。

docker container stopコマンドにも強制終了などのオプションがありますが、今後のハンズオンで必要になった段階で説明します。

7. docker container start (docker start)

このコマンドは、停止しているコンテナを再開(起動)させるためのコマンドです。

docker container start my-container

このコマンドは、停止状態にあるmy-containerという名前のコンテナを再開するコマンドです。 runコマンドのように新しく作り直すのではなく、先ほど停止させた既存のコンテナを再び動かしたい場合に使用します。

8. docker container ls (docker ps)

このコマンドは、現在稼働しているコンテナの一覧を表示するコマンドです。

docker container ls

これにより、下記のサンプルのように、起動中のコンテナの一覧が表示されます。

CONTAINER ID   IMAGE     COMMAND                  STATUS          PORTS                  NAMES
a1b2c3d4e5f6   my-image  "/docker-entrypoint...."   Up 10 seconds   0.0.0.0:8080->80/tcp   my-container

また、docker container lsコマンドは通常は「起動中のコンテナ」のみが対象となりますが、-aのオプションをつけることで、停止しているコンテナも含めて一覧表示できます。

docker container ls -a

9. docker container rm (省略形: docker rm)

このコマンドは、停止しているコンテナを削除するためのコマンドです。

docker container rm my-container

このコマンドは、my-containerという名前のコンテナを削除するコマンドです。 コンテナは停止(stop)しただけではPC内にデータが残ってしまうため、不要になったコンテナはこのコマンドを使って完全に削除します。

なお、起動中のコンテナはこのコマンドでは削除できません。まずはdocker container stopコマンドでコンテナを停止させてから、この削除コマンドを実行する必要があります。

docker container rmコマンドにも強制削除などのオプションがありますが、今後のハンズオンで必要になった段階で説明します。

10. コマンド一覧

本章で紹介したDockerコマンドを以下の表にまとめます。

コマンド 説明 主なオプション コマンド例
docker image pull レジストリからイメージをダウンロード - docker image pull nginx:latest
(Docker Hubからnginxの最新版を取得)
docker image build Dockerfileからイメージを作成 -t:イメージに名前を付ける docker image build -t my-image .
(カレントディレクトリのDockerfileからmy-imageを作成)
docker image ls ローカルのイメージ一覧を表示 - docker image ls
(ローカルに保存されているイメージを一覧表示)
docker image rm イメージを削除 - docker image rm my-image:latest
(my-imageの最新版をローカルから削除)
docker container run イメージからコンテナを作成・起動 --name:コンテナに名前を付ける docker container run --name my-container my-image
(my-imageからmy-containerという名前でコンテナを起動)
docker container stop 起動中のコンテナを停止 - docker container stop my-container
(my-containerを停止)
docker container start 停止中のコンテナを再開 - docker container start my-container
(停止中のmy-containerを再開)
docker container ls コンテナ一覧を表示 -a:停止中も含めて表示 docker container ls -a
(停止中のコンテナも含めて一覧表示)
docker container rm コンテナを削除 - docker container rm my-container
(my-containerを完全に削除)