dockerコマンド チートシート

イメージの一覧表示: docker images

ローカルに存在するDockerイメージの一覧を表示します。

docker images [OPTIONS] [REPOSITORY[:TAG]]

イメージの取得: docker pull

レジストリ（デフォルトはDocker Hub）からDockerイメージを取得します。

docker pull [OPTIONS] NAME[:TAG|@DIGEST]

タグを指定しない場合、デフォルトで:latestタグが使用されます。

イメージの削除: docker rmi

ローカルから1つまたは複数のイメージを削除します。

docker rmi [OPTIONS] IMAGE [IMAGE...]

イメージを削除する前に、そのイメージを使用しているコンテナを停止・削除する必要があります（-fオプションを使わない場合）。

未使用のイメージ（danglingイメージ）を一括削除するには docker image prune を使用します。

docker image prune [OPTIONS]

-aオプションを付けると、コンテナで使用されていない全てのイメージを削除します。

docker image prune -a

イメージのビルド: docker build

Dockerfileとコンテキスト（通常はDockerfileが含まれるディレクトリ）からDockerイメージをビルドします。

docker build [OPTIONS] PATH | URL | -

コンテキスト(PATH)はビルドに必要なファイルが含まれるディレクトリです。通常はカレントディレクトリ(.)を指定します。

イメージのタグ付け: docker tag

既存のイメージに新しい名前（タグ）を付けます。イメージの実体はコピーされません。

docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]

例:

# ローカルの myapp:latest イメージに myregistry.com/myuser/myapp:v1 というタグを付ける
docker tag myapp:latest myregistry.com/myuser/myapp:v1

主にイメージをレジストリにプッシュする前に、リポジトリ名を含むタグを付けるために使用されます。

イメージのプッシュ: docker push

ローカルのイメージをリモートレジストリ（Docker Hubやプライベートレジストリなど）にアップロード（プッシュ）します。

docker push [OPTIONS] NAME[:TAG]

プッシュする前に、docker login コマンドでレジストリにログインしておく必要があります。また、イメージ名には通常、レジストリのホスト名（Docker Hubの場合はユーザー名）を含める必要があります（例: username/repository:tag）。

イメージの詳細情報表示: docker inspect

イメージに関する詳細な情報（レイヤー、環境変数、設定など）をJSON形式で表示します。

docker inspect [OPTIONS] IMAGE [IMAGE...]

例:

docker inspect nginx:latest

--formatオプションで特定の情報だけを抽出できます。

# イメージのアーキテクチャを表示
docker inspect --format='{{.Architecture}}' nginx

イメージの履歴表示: docker history

イメージがどのように構築されたか、各レイヤーの履歴を表示します。

docker history [OPTIONS] IMAGE

例:

docker history myapp:1.0

イメージの保存: docker save

1つ以上のイメージをtarアーカイブとしてファイルに保存します。オフライン環境へのイメージ転送などに使用します。

docker save [OPTIONS] IMAGE [IMAGE...] > output.tar

または

docker save -o output.tar IMAGE [IMAGE...]

例:

docker save myapp:latest nginx:alpine > images.tar

docker save -o images.tar myapp:latest nginx:alpine

イメージの読み込み: docker load

docker saveで作成したtarアーカイブからイメージを読み込みます。

docker load [OPTIONS] < input.tar

または

docker load -i input.tar

例:

docker load < images.tar

docker load -i images.tar

コンテナの作成と実行: docker run

指定したイメージから新しいコンテナを作成し、実行します。非常に多くのオプションがあります。

docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

docker createコマンドはコンテナを作成しますが、起動はしません。docker startで後から起動できます。

実行中のコンテナ一覧表示: docker ps

現在実行中のコンテナの一覧を表示します。

docker ps [OPTIONS]

コンテナの停止: docker stop

1つ以上の実行中のコンテナを停止します。まずSIGTERMシグナルを送信し、指定時間（デフォルト10秒）後に応答がなければSIGKILLを送信します。

docker stop [OPTIONS] CONTAINER [CONTAINER...]

例:

docker stop my-nginx container-id

docker killコマンドは、SIGTERMを送信せずに直接SIGKILLを送信してコンテナを強制停止します。

docker kill my-container

コンテナの起動: docker start

1つ以上の停止中のコンテナを起動します。

docker start [OPTIONS] CONTAINER [CONTAINER...]

例:

docker start my-stopped-container

コンテナの再起動: docker restart

1つ以上のコンテナを再起動します。

docker restart [OPTIONS] CONTAINER [CONTAINER...]

例:

docker restart my-nginx my-db

コンテナの削除: docker rm

1つ以上の停止中のコンテナを削除します。

docker rm [OPTIONS] CONTAINER [CONTAINER...]

例:

docker rm my-stopped-container container-id

停止しているすべてのコンテナを一括削除するには docker container prune を使用します。

docker container prune

コンテナのログ表示: docker logs

コンテナのログ（標準出力/標準エラー出力）を表示します。

docker logs [OPTIONS] CONTAINER

例:

docker logs my-nginx

コンテナの詳細情報表示: docker inspect

コンテナに関する詳細な情報（IPアドレス、ポートマッピング、ボリューム、設定など）をJSON形式で表示します。

docker inspect [OPTIONS] CONTAINER [CONTAINER...]

例:

docker inspect my-container

--formatオプションで特定の情報だけを抽出できます。

# コンテナのIPアドレスを表示
docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' my-container

コンテナ内のプロセス一覧表示: docker top

実行中のコンテナ内で実行されているプロセスを表示します。

docker top CONTAINER [ps OPTIONS]

例:

docker top my-web-server

# psコマンドのオプションを渡す (例: aux)
docker top my-container aux

コンテナのリソース使用状況表示: docker stats

実行中のコンテナのリソース使用状況（CPU、メモリ、ネットワークI/O、ディスクI/O）をライブストリームで表示します。

docker stats [OPTIONS] [CONTAINER...]

例:

# 全ての実行中コンテナの統計を表示
docker stats

# 特定のコンテナの統計を表示
docker stats my-container1 my-container2

コンテナの一時停止: docker pause

コンテナ内のすべてのプロセスを一時停止します。

docker pause CONTAINER [CONTAINER...]

例:

docker pause my-running-app

コンテナの再開: docker unpause

docker pauseで一時停止したコンテナ内のプロセスを再開します。

docker unpause CONTAINER [CONTAINER...]

例:

docker unpause my-running-app

コンテナの名前変更: docker rename

既存のコンテナの名前を変更します。

docker rename CONTAINER NEW_NAME

例:

docker rename old-name new-name

コンテナファイルシステムの変更差分表示: docker diff

コンテナのファイルシステム内で、イメージ作成時から変更または追加/削除されたファイルやディレクトリを表示します。

docker diff CONTAINER

出力の意味:

• A – 追加 (Add)
• C – 変更 (Change)
• D – 削除 (Delete)

例:

docker diff my-container

実行中のコンテナでコマンド実行: docker exec

実行中のコンテナ内で新しいコマンドを実行します。デバッグや一時的な操作に便利です。

docker exec [OPTIONS] CONTAINER COMMAND [ARG...]

例:

# コンテナ内のファイル一覧を表示
docker exec my-container ls /app

# インタラクティブシェルを起動
docker exec -it my-container /bin/sh

コンテナにアタッチ: docker attach

実行中のコンテナの標準入力、標準出力、標準エラー出力にアタッチします。主にフォアグラウンドで起動したコンテナに再接続する際に使用します。

docker attach [OPTIONS] CONTAINER

例:

docker attach my-interactive-container

docker exec -it と似ていますが、attach はコンテナのメインプロセスに接続するのに対し、exec は新しいプロセスを起動します。アタッチ中に Ctrl+C を押すと、コンテナのメインプロセスが終了する可能性があるため注意が必要です（--sig-proxy=false で挙動が変わります）。デタッチするにはデフォルトで Ctrl+P -> Ctrl+Q を順に押します。

ファイル/ディレクトリのコピー: docker cp

ホストとコンテナ間でファイルやディレクトリをコピーします。

# ホストからコンテナへコピー
docker cp [OPTIONS] SRC_PATH CONTAINER:DEST_PATH

# コンテナからホストへコピー
docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH

例:

# ホストの app.conf をコンテナ my-nginx の /etc/nginx/ にコピー
docker cp app.conf my-nginx:/etc/nginx/app.conf

# コンテナ my-app の /app/logs ディレクトリをホストのカレントディレクトリにコピー
docker cp my-app:/app/logs .

ネットワークの一覧表示: docker network ls

Dockerネットワークの一覧を表示します。

docker network ls [OPTIONS]

ネットワークの作成: docker network create

新しいDockerネットワークを作成します。

docker network create [OPTIONS] NETWORK

例:

docker network create my-app-net

ネットワークへのコンテナ接続: docker network connect

実行中のコンテナをネットワークに接続します。

docker network connect [OPTIONS] NETWORK CONTAINER

例:

docker network connect my-app-net my-running-container

ネットワークからのコンテナ切断: docker network disconnect

コンテナをネットワークから切断します。

docker network disconnect [OPTIONS] NETWORK CONTAINER

例:

docker network disconnect my-app-net my-container

ネットワークの詳細情報表示: docker network inspect

1つ以上のネットワークに関する詳細な情報（接続されているコンテナ、設定など）をJSON形式で表示します。

docker network inspect [OPTIONS] NETWORK [NETWORK...]

例:

docker network inspect bridge my-app-net

--formatオプションで特定の情報だけを抽出できます。

# ネットワークに接続されているコンテナのリストを表示
docker network inspect --format='{{range .Containers}}{{.Name}} {{.IPv4Address}}{{println}}{{end}}' my-app-net

ネットワークの削除: docker network rm

1つ以上のネットワークを削除します。コンテナが接続されていないネットワークのみ削除できます。

docker network rm NETWORK [NETWORK...]

例:

docker network rm my-unused-net

未使用のネットワーク（どのコンテナにも接続されていないカスタムネットワーク）を一括削除するには docker network prune を使用します。

docker network prune

ボリュームの一覧表示: docker volume ls

Dockerボリュームの一覧を表示します。

docker volume ls [OPTIONS]

ボリュームの作成: docker volume create

新しいDockerボリュームを作成します。

docker volume create [OPTIONS] [VOLUME]

例:

docker volume create my-app-data

ボリューム名を省略すると、ランダムな名前のボリュームが作成されます。

ボリュームの詳細情報表示: docker volume inspect

1つ以上のボリュームに関する詳細な情報（マウントポイント、ドライバー、ラベルなど）をJSON形式で表示します。

docker volume inspect [OPTIONS] VOLUME [VOLUME...]

例:

docker volume inspect my-app-data

--formatオプションで特定の情報だけを抽出できます。

# ボリュームのマウントポイントを表示
docker volume inspect --format='{{.Mountpoint}}' my-app-data

ボリュームの削除: docker volume rm

1つ以上のボリュームを削除します。コンテナで使用されていないボリュームのみ削除できます。

docker volume rm [OPTIONS] VOLUME [VOLUME...]

例:

docker volume rm my-unused-volume other-volume

未使用ボリュームの一括削除: docker volume prune

どのコンテナにも使用されていないボリュームを一括で削除します。

docker volume prune [OPTIONS]

⚠️ この操作は元に戻せません。削除されるボリュームをよく確認してください。

アプリケーションの起動: docker compose up

docker-compose.yml に定義されたサービス（コンテナ）をビルド（必要であれば）、作成、起動します。

docker compose up [OPTIONS] [SERVICE...]

特定のサービスのみを起動することも可能です。

docker compose up -d web db

アプリケーションの停止と削除: docker compose down

docker compose up で起動したコンテナ、ネットワーク、ボリュームなどを停止・削除します。

docker compose down [OPTIONS]

⚠️ -v オプションを付けるとボリューム内のデータが削除されるため、注意が必要です。

サービスのコンテナ一覧表示: docker compose ps

Composeプロジェクトのコンテナの状態を表示します。

docker compose ps [OPTIONS] [SERVICE...]

サービスのログ表示: docker compose logs

サービスのコンテナログを表示します。

docker compose logs [OPTIONS] [SERVICE...]

オプションは docker logs と同様のものが多く利用可能です (-f, --tail, -t, --since など)。

例:

# 全サービスのログをストリーミング
docker compose logs -f

# webサービスの最後の10行を表示
docker compose logs --tail 10 web

サービス内でのコマンド実行: docker compose exec

実行中のサービスのコンテナ内でコマンドを実行します。

docker compose exec [OPTIONS] SERVICE COMMAND [ARG...]

オプションは docker exec と同様のものが多く利用可能です (-d, -T(TTY無効化), -e, -u, -w など)。-it は docker exec と同様には直接指定せず、TTYが必要な場合は自動的に割り当てられます。

例:

# webサービスのコンテナでbashをインタラクティブに実行
docker compose exec web bash

# dbサービスのコンテナで環境変数を表示
docker compose exec db printenv

サービスのイメージビルド: docker compose build

Composeファイルで定義されたサービスのイメージをビルドまたは再ビルドします。

docker compose build [OPTIONS] [SERVICE...]

サービスのイメージ取得: docker compose pull

Composeファイルで定義されたサービスのイメージをレジストリから取得します。

docker compose pull [OPTIONS] [SERVICE...]

Composeファイルの検証と設定表示: docker compose config

Composeファイルを検証し、マージされた設定内容を表示します。

docker compose config [OPTIONS]

その他のComposeコマンド

• docker compose start [SERVICE...]: 停止中のサービスを開始します。
• docker compose stop [SERVICE...]: 実行中のサービスを停止しますが、コンテナは削除しません。
• docker compose restart [SERVICE...]: サービスを再起動します。
• docker compose pause [SERVICE...]: サービスのコンテナを一時停止します。
• docker compose unpause [SERVICE...]: 一時停止中のサービスのコンテナを再開します。
• docker compose rm [OPTIONS] [SERVICE...]: 停止中のサービスのコンテナを削除します。
• docker compose kill [OPTIONS] [SERVICE...]: サービスのコンテナを強制停止します (SIGKILL)。
• docker compose push [SERVICE...]: サービスのイメージをレジストリにプッシュします。
• docker compose create [SERVICE...]: サービス用のコンテナを作成しますが、起動はしません。
• docker compose run [OPTIONS] SERVICE [COMMAND] [ARG...]: サービス用のコンテナを一度だけ実行します。ポートマッピングなどが通常と異なる場合があります。主に一時的なタスク実行に使用します。

Dockerシステム情報の表示: docker info

Dockerデーモンの設定や状態（コンテナ数、イメージ数、ストレージドライバ、OS情報など）に関する広範な情報を表示します。

docker info [OPTIONS]

Dockerバージョン情報の表示: docker version

Dockerクライアントとデーモンのバージョン情報、APIバージョン、Goバージョンなどを表示します。

docker version [OPTIONS]

Dockerディスク使用量の表示: docker system df

Dockerが使用しているディスク容量の内訳（イメージ、コンテナ、ボリューム、ビルドキャッシュ）を表示します。

docker system df [OPTIONS]

未使用リソースの一括削除: docker system prune

使用されていないDockerリソース（停止したコンテナ、danglingイメージ、未使用ネットワーク、未使用ボリューム、ビルドキャッシュ）を一括で削除します。

docker system prune [OPTIONS]

⚠️ この操作は元に戻せません。-aや--volumesオプションを使用する場合は特に注意し、削除されるリソースをよく確認してください。

個別のリソースタイプごとに prune コマンドも用意されています:

• docker container prune: 停止中のコンテナを削除
• docker image prune: danglingイメージを削除 (-aで未使用イメージ全て)
• docker network prune: 未使用ネットワークを削除
• docker volume prune: 未使用ボリュームを削除
• docker builder prune: ビルドキャッシュを削除

Dockerイベントの監視: docker system events

Dockerデーモンからのリアルタイムイベント（コンテナの開始/停止、イメージのpull/削除など）をストリーミング表示します。

docker system events [OPTIONS]

レジストリへのログイン: docker login

Dockerレジストリ（デフォルトはDocker Hub）にログインします。プライベートリポジトリへのアクセスやイメージのプッシュに必要です。

docker login [OPTIONS] [SERVER]

サーバー名を省略するとDocker Hubにログインします。

# Docker Hubにログイン
docker login

# プライベートレジストリにログイン
docker login my.private.registry.com

レジストリからのログアウト: docker logout

Dockerレジストリからログアウトします。

docker logout [SERVER]

例:

# Docker Hubからログアウト
docker logout

# プライベートレジストリからログアウト
docker logout my.private.registry.com

レジストリ内のイメージ検索: docker search

Docker Hub（または設定されたレジストリ）で公開されているイメージを検索します。

docker search [OPTIONS] TERM

例:

docker search mysql