本文へスキップ

本ページはプロモーションが含まれています

Docker

Dockerコマンド一覧|よく使う順のチートシートとCompose

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約37分
SHEETS
14枚
Dockerコマンド一覧(よく使う順のチートシート)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

「あれ、ログを追いかけるオプションって -f だっけ -t だっけ」。

Dockerは毎日のように触るのに、こういう小さな度忘れで手が止まります。

先に答えを置くと、開発で出番が多いのは run・ps・logs・exec・stop・rm・images・build・compose up・compose down の10個です。

この記事はその10個の表から始まるチートシートです。そのあとに目的別のコマンド一覧、Composeの書き方、よく間違えるオプション、消しすぎる危ないコマンドと続きます。

各行から、もっと詳しい記事へ飛べるようにしてあります。

この記事でわかること

  • よく使うDockerコマンド10個と、それぞれの一言説明
  • イメージ・コンテナ・ログ・ボリューム・ネットワーク・Compose・掃除・調査の目的別一覧
  • docker ps と docker container ls、docker-compose と docker compose の新旧の違い
  • -it・-d・--rm・-p・-v のよくある勘違い
  • docker system prune -a --volumes と docker compose down -v で何が消えるか

動作確認した版は、手元のMac(Rancher Desktop)に入っている Docker 27.4.1 と Docker Compose v2.32.1 です。書式はそれぞれの --help とDockerのCLIリファレンスで照らし合わせました。

PARTS LIST /目次

Dockerでよく使うコマンド10個の早見表

Dockerコマンドとは、Dockerのイメージやコンテナを操作するために docker に続けて打つ命令のことです。

全部で数十個ありますが、開発で毎日触るのはそのうちのひと握りで、残りは「たまに調べて打つ」ものです。

まずは頻出の10個だけ覚えて、残りはこの記事の目的別一覧を辞書として引く使い方をおすすめします。

開発の1日で出番が多い10コマンド

アプリを起動して、ログを見て、中に入って直して、止めて片付ける。開発の1日の流れで出番が多い順に並べると、次の10個です。

コマンド何をするか詳しい記事
docker compose up -dcompose.yamlのサービスをまとめて起動Compose入門
docker ps動いているコンテナを一覧(-a で停止中も)この記事の「コンテナ」の節
docker logs -f コンテナログを流しっぱなしで見るこの記事の「ログ」の節
docker exec -it コンテナ sh動いているコンテナの中でシェルを開くコンテナに入る方法
docker compose downComposeのコンテナとネットワークを止めて削除Compose入門
docker run イメージイメージから新しいコンテナを作って起動Docker入門
docker stop コンテナコンテナを止める(消さない)この記事の「コンテナ」の節
docker rm コンテナ止まったコンテナを削除この記事の「コンテナ」の節
docker images手元のイメージを一覧Docker Hubの使い方
docker build -t 名前 .Dockerfileからイメージを作るDockerfileの書き方

Composeを使うプロジェクトなら、上の2つ(compose up と compose down)だけで1日が終わる日もあります。

逆に、Composeを使わずに単体のコンテナを動かすときは run → logs → stop → rm の流れが基本です。

1日の流れで打つ順番の例

表のコマンドを、実際に打つ順番に並べ直すと次のようになります。まずは単体のコンテナでNginxを動かして片付けるまでです。

# 1. イメージを取ってきて、名前とポートを付けて裏で起動
docker run -d --name web -p 127.0.0.1:8080:80 nginx:1.27

# 2. 動いているか確かめる
docker ps

# 3. ログを追う(Ctrl+Cで抜けてもコンテナは止まらない)
docker logs -f web

# 4. 中で設定ファイルを見る
docker exec -it web sh

# 5. 止めて、消す
docker stop web
docker rm web

Composeを使うプロジェクトでは、同じ流れがもっと短くなります。サービス名(compose.yamlに書いた web など)で指定するので、コンテナ名を覚えておく必要もありません。

docker compose up -d        # 起動
docker compose ps           # 状態を見る
docker compose logs -f web  # webのログを追う
docker compose exec web sh  # webの中に入る
docker compose down         # 止めて片付ける(データのボリュームは残る)

単体で動かすか、Composeで動かすか。迷ったら、コンテナが2つ以上あるならComposeを選ぶと覚えておけば足ります。

コマンドの基本の形と「対象 動詞」の書き方

Dockerのコマンドは docker [オプション] コマンド [引数] の形で書きます。

ややこしいのは、同じ操作に2通りの書き方があることです。docker ps は短い昔からの書き方で、docker container ls は「対象(container)+動詞(ls)」で書く新しい書き方です。

手元の docker ps --help を見ると、次の4つが同じコマンドの別名として並んでいます。

Aliases:
  docker container ls, docker container list, docker container ps, docker ps

どちらで書いても結果は同じです。新旧の対応表は後半の「新旧の書き方」の節にまとめました。

表の「コンテナ」「イメージ」の部分
実際にはコンテナ名(--name で付けた名前)か、コンテナIDの先頭数文字を入れます。IDは他のコンテナと区別できれば、先頭の数文字だけでも通ります。

イメージを操作するコマンド一覧(pull・build・tag)

イメージとは、コンテナを作るための設計図にあたるファイル一式です。

イメージのコマンドは「取ってくる・作る・名前を付ける・送る・消す」の5種類に分かれます。

イメージそのものの考え方はDocker入門、公式イメージの選び方はDocker Hubの使い方が詳しいので、ここではコマンドの早見表に絞ります。

イメージを取得・一覧・削除する

Docker Hubなどのレジストリからイメージを取ってくるのが pull、手元の一覧が images、消すのが rmi です。

コマンド何をするか詳しい記事
docker pull nginx:1.27イメージをダウンロード(タグ省略で latest)Docker Hub
docker images手元のイメージを一覧―
docker image ls -qイメージIDだけを一覧―
docker rmi イメージイメージを削除―
docker image history イメージどの命令でどれだけ増えたかを見るDockerfileの書き方
docker search キーワードDocker Hubを検索Docker Hub

タグを省略すると latest が使われます。

latest は「最新」ではなく「タグを付けなかったときの名前」なので、半年後に同じコマンドを打つと中身が変わっていることがあります。チーム開発では nginx:1.27 のように版まで書くほうが、あとで困りません。

イメージをビルド・タグ付け・pushする

自分のアプリをイメージにするのが build、別名を付けるのが tag、レジストリへ送るのが push です。

コマンド何をするか詳しい記事
docker build -t myapp:1.0 .カレントのDockerfileからビルドDockerfileの書き方
docker build -f Dockerfile.dev -t myapp:dev .別名のDockerfileを指定同上
docker build --no-cache -t myapp .キャッシュを使わずにビルドし直す同上
docker tag myapp:1.0 ユーザー名/myapp:1.0既存イメージに別名を付けるDocker Hub
docker loginレジストリにログイン同上
docker push ユーザー名/myapp:1.0レジストリへ送る同上

docker build の最後の . は「ビルドに使うフォルダ(ビルドコンテキスト)」です。

ここを忘れると、手元では次のように止まりました(docker build の中身は BuildKit の docker buildx build なので、名前がそちらで出ます)。

ERROR: "docker buildx build" requires exactly 1 argument.
See 'docker buildx build --help'.

カレントのフォルダを渡すなら .、別のフォルダなら ./app のように書きます。

docker tag はイメージをコピーするわけではありません。同じイメージに名前をもう1つ付けるだけなので、容量は増えません。push先のリポジトリ名(ユーザー名/イメージ名)に合わせるために使います。

コンテナの起動・停止・削除のコマンド

コンテナとは、イメージから作られて実際に動いているアプリの実体です。

コンテナには「作られた」「動いている」「止まっている」「消えた」の状態があり、コマンドは状態を移すスイッチだと考えると覚えやすくなります。

起動・停止・削除で迷ったら、この節の表と下の図で今どの状態かを確かめてください。

run・start・stop・restartの使い分け

run は「イメージから新しいコンテナを作って起動」、start は「止まっている既存のコンテナを起動し直す」です。

コマンド何をするか詳しい記事
docker run -d --name web -p 8080:80 nginx:1.27名前とポートを付けて裏で起動ネットワークとポート
docker run --rm -it ubuntu bash使い捨てのコンテナでシェルを開くコンテナに入る方法
docker start web止まっているコンテナを再び起動―
docker stop webコンテナを止める―
docker restart web止めてから起動し直す―
docker kill web待たずに強制終了―

docker run を打つたびに、コンテナは1つずつ増えます。

「さっきのコンテナをもう一度動かしたい」ときに run を打つと、名前の重複でエラーになるか、似たコンテナが量産されます。2回目以降は start です。

docker stop は、まず終了の合図(SIGTERM)を送り、決まった秒数待っても止まらなければ強制終了します。待つ秒数は -t で変えられます(docker stop -t 30 web)。

「Docker 再起動 コマンド」で探している人は、何を再起動したいかで打つものが変わります。

  • コンテナ1つ:docker restart コンテナ
  • Composeのサービス:docker compose restart サービス
  • Dockerのデーモン(Linux):sudo systemctl restart docker
  • Docker Desktop(Mac):アプリを終了して起動し直す(ターミナルからなら open -a Docker)

ps・rmとコンテナの状態の流れ

一覧を見るのが ps、消すのが rm です。どちらも止まっているコンテナが絡むと引っかかりやすいので、オプションまで覚えておきます。

コマンド何をするか詳しい記事
docker ps動いているコンテナだけ一覧―
docker ps -a止まっているものも含めて一覧―
docker ps -qコンテナIDだけ出す―
docker rm web止まっているコンテナを削除―
docker rm -f web動いていても強制的に削除―
docker rename 旧名 新名コンテナの名前を変える―

docker ps に出てこないのに名前の重複で怒られたら、止まったコンテナが残っています。docker ps -a で探して docker rm で消してください。

状態と、状態を移すコマンドの関係を図にすると次のようになります。

flowchart TD
    I["イメージ"] -->|"docker create"| C["作成済み"]
    I -->|"docker run"| R["実行中"]
    C -->|"docker start"| R
    R -->|"docker stop<br/>docker kill"| S["停止"]
    S -->|"docker start"| R
    R -->|"docker restart"| R
    S -->|"docker rm"| D["削除"]
    R -->|"docker rm -f"| D

docker stop で止めたコンテナは、消えずに残っています。中で作ったファイルも残るので、docker start すれば続きから動きます。

消えるのは docker rm したときだけです。ここを取り違えると「止めたら全部消えた」「消したはずなのに残っている」の両方が起きます。

docker runでよく足すオプション

docker run --help の出力はスクロールしないと読み切れないほど長いのですが、開発で付けるものは限られます。名前とポート以外で出番が多いのは次のあたりです。

オプション何をするか書き方の例
--nameコンテナに名前を付ける--name web
-e環境変数を1つ渡す-e TZ=Asia/Tokyo
--env-fileファイルから環境変数をまとめて渡す--env-file .env
-w中での作業フォルダを決める-w /app
-u実行するユーザーを決める-u 1000:1000
--networkつなぐネットワークを選ぶ--network mynet
--restart落ちたときに自動で起動し直す--restart unless-stopped
--platformCPUの種類を指定してイメージを選ぶ--platform linux/amd64
--entrypointイメージの起動コマンドを差し替える--entrypoint sh
-mメモリの上限を決める-m 512m

--restart の値は、何もしない no(既定値)、異常終了したときだけの on-failure、常に起動し直す always、手で止めたときは起動し直さない unless-stopped の4種類です。開発用のDBを「Macを再起動しても上がっていてほしい」ときは unless-stopped が扱いやすい選択です。

--platform linux/amd64 は、Apple シリコン(M1以降)のMacで、arm64版が配られていないイメージを動かすときに使います。動きはしますが、CPUの命令を変換しながら動くぶん遅くなります。

--entrypoint sh は、起動してすぐ落ちるコンテナの中を調べたいときの奥の手です。イメージ本来の起動コマンドの代わりにシェルが立ち上がるので、docker run --rm -it --entrypoint sh イメージ で中のファイルを見られます。

ログを見る・コンテナの中に入るコマンド

アプリが動かないとき、最初に打つのが logs、次に打つのが exec です。

ログで原因が分かれば中に入る必要はありません。分からなければ中に入って、設定ファイルや環境変数を直接確かめます。

ファイルをコンテナとMacの間で受け渡す cp も、この節にまとめます。

logs・exec・cpの書き方

logs は標準出力と標準エラーに出たものを表示し、exec は動いているコンテナの中で別のコマンドを実行します。

コマンド何をするか詳しい記事
docker logs webこれまでのログを全部表示―
docker logs -f webログを流しっぱなしで追う(Ctrl+Cで抜ける)―
docker logs -n 100 web末尾100行だけ(--tail 100 と同じ)―
docker logs --since 10m web直近10分のログ―
docker exec -it web shコンテナの中でシェルを開くコンテナに入る方法
docker exec web env中に入らず環境変数だけ見る同上
docker cp web:/etc/nginx/nginx.conf .コンテナからMacへコピー―
docker cp ./app.conf web:/tmp/Macからコンテナへコピー―

冒頭で度忘れした「ログを追う」は -f(follow)です。-t はタイムスタンプを付けるオプションで、組み合わせて docker logs -ft web とも書けます。

exec で開くシェルは、イメージに入っているものしか使えません。軽量なalpine系のイメージには bash がないことが多いので、bash で失敗したら sh を試してください。bashとshの選び方や attach との違いはコンテナに入る方法にまとめています。

LOGDockerを使い始めたころ「コンテナの中に入る」が分からなかった

Dockerを初めて使ったとき、私は「コンテナの中に入る」という言い方で混乱しました。

いまは開発の業務で日常的にDockerを使っています。その立場から当時の自分に説明するなら、exec は「動いている箱の中で、もう1本コマンドを走らせる」ものだと言います。入る、より「中で打つ」と考えたほうが、-it や sh を付ける理由もつながって見えるはずです。

ボリューム・ネットワークのコマンド

ボリュームとは、コンテナを消しても残しておきたいデータ(DBのファイルなど)を置く場所です。

ネットワークは、コンテナ同士やMacとコンテナをつなぐ線です。どちらも普段はComposeが自動で作ってくれるので、コマンドを打つのは「中身を確かめたい」「消したい」ときが中心になります。

ボリュームの作成・一覧・削除

ボリュームのコマンドは docker volume の下にまとまっています。

コマンド何をするか詳しい記事
docker volume lsボリュームを一覧Compose volumes
docker volume create db-data名前付きボリュームを作る同上
docker volume inspect db-data実体の場所や作成日時を見る同上
docker volume rm db-dataボリュームを削除同上
docker run -v db-data:/var/lib/data イメージボリュームをコンテナにつなぐ同上

docker volume rm で消したデータは戻りません。DBのデータが入ったボリュームを消すと、そのDBは空からやり直しです。

Composeでの volumes: の書き方、名前付きボリュームとバインドマウントの使い分けはCompose volumesの書き方で詳しく扱っています。

ネットワークとポートの確認

ネットワークは docker network、公開しているポートの確認は docker port です。

コマンド何をするか詳しい記事
docker network lsネットワークを一覧ネットワークとポート
docker network create mynetネットワークを作る同上
docker network connect mynet web既存コンテナをネットワークにつなぐ同上
docker network inspect mynetつながっているコンテナとIPを見る同上
docker port webMac側に公開しているポートを見る同上

同じネットワークにいるコンテナ同士は、コンテナ名(Composeならサービス名)で名前解決できます。

「アプリからDBにつながらない」ときは、まず docker network inspect で2つのコンテナが同じネットワークにいるかを見ます。bridgeの仕組みと -p の関係はネットワークとポートの記事が詳しいです。

Docker Composeのコマンド一覧

Docker Composeとは、複数のコンテナの設定を compose.yaml 1つに書いて、まとめて起動・停止するための仕組みです。

コマンドは docker compose に続けて書きます。単体の docker コマンドと名前が似ていますが、対象が「コンテナ」ではなく「サービス(compose.yamlに書いた名前)」になるのが大きな違いです。

ymlの書き方から知りたい人は、先にCompose入門を読むと、この節の表がぐっと読みやすくなります。

up・down・ps・logs・exec

Composeで毎日打つのは、起動の up と片付けの down、それに状態とログを見る3つです。

コマンド何をするか詳しい記事
docker compose up -d全サービスを裏で起動Compose入門
docker compose up -d --buildイメージを作り直してから起動同上
docker compose up --wait起動して、healthyになるまで待つhealthcheckの書き方
docker compose downコンテナとネットワークを止めて削除同上
docker compose psこのプロジェクトのコンテナを一覧―
docker compose logs -f webwebサービスのログを追う―
docker compose exec web shwebサービスの中でシェルを開くコンテナに入る方法
docker compose run --rm web コマンド使い捨てのコンテナでコマンドを1回実行―

docker compose exec は、-it を付けなくても対話できます。単体の docker exec と書き方がずれるので、地味に迷うところです。

--wait の説明は、手元のヘルプでは「Wait for services to be running|healthy. Implies detached mode.」です。付けると -d も付けたものとして動きます。healthcheckを書いたサービスなら、DBが本当に受け付けられる状態になるまで待ってから戻ってきます。

build・pull・config・restart

起動と停止以外では、イメージの準備と設定の確認に使うコマンドがあります。

コマンド何をするか詳しい記事
docker compose buildDockerfileのあるサービスをビルドDockerfileの書き方
docker compose pullimageのサービスのイメージを取得―
docker compose config変数や省略を展開した最終形を表示―
docker compose restart webサービスを再起動―
docker compose stop止める(コンテナは残す)―
docker compose ls動いているComposeプロジェクトを一覧―
docker compose -f compose.dev.yaml up -d別のファイルを指定して起動―

docker compose config は、デーモンが止まっていても動きます。ymlの書き間違いを探すのに便利で、試しに ports を port と1文字間違えたファイルを読ませると、次のように止まりました。

validating /path/to/compose.yaml: services.web Additional property port is not allowed

正しいファイルなら、省略した書き方を展開した最終形が出ます。たとえば ports: - "127.0.0.1:8080:80" と書いたサービスは、次のように読まれていました。

    ports:
      - mode: ingress
        host_ip: 127.0.0.1
        target: 80
        published: "8080"
        protocol: tcp

published がMac側、target がコンテナ側です。後半の「-p の向き」で書く左右の意味が、ここではっきり見えます。試したフォルダの名前は new-docker-cmd で、ネットワーク名も new-docker-cmd_default と「フォルダ名_default」で作られていました。プロジェクト名は、何も指定しなければフォルダ名から決まります。

プロジェクト名・環境変数・profileの指定

チームのプロジェクトで手順書に出てくるのが、ファイルや名前を切り替えるオプションです。どれも docker compose の直後、up などのコマンドより前に書きます。

書き方何をするか使う場面
docker compose -p myapp up -dプロジェクト名を指定同じymlを別名で2つ動かす
docker compose --env-file .env.dev up -d読み込む環境変数のファイルを変える開発用と検証用の切り替え
docker compose --profile debug up -dprofileを付けたサービスも起動管理画面などを必要なときだけ
docker compose up -d --force-recreate設定が同じでもコンテナを作り直す起動時の処理をやり直したい
docker compose exec -T web コマンドTTYなしで実行CIやスクリプトから呼ぶ
docker compose watchファイルの変更でビルドや同期をやり直す開発中の自動反映

exec -T は、前の節の「docker compose exec は -it なしで対話できる」の裏返しです。

手元のヘルプにも「By default docker compose exec allocates a TTY」とあります。TTYのない環境(CIやcronから呼ぶスクリプト)では、-T を付けないと止まることがあります。

docker-composeとdocker composeの違い(v1の終了)

ハイフンありの docker-compose は Compose v1、スペース区切りの docker compose は Compose v2 の書き方です。

Docker社は2023年1月の発表で、Compose v1 のサポートを2023年6月で終えると告知しました(Docker社の発表)。いまは docker compose を使います。

項目docker-compose(v1)docker compose(v2)
書き方ハイフンでつなぐdocker のサブコマンド
状態更新終了現行
コンテナ名の区切り_(例: app_web_1)-(例: app-web-1)

古い記事や社内手順書に docker-compose up -d とあっても、多くは docker compose up -d に置き換えるだけで動きます。

注意したいのは、コンテナ名を決め打ちで書いたシェルスクリプトです。区切りが _ から - に変わったので、app_web_1 を探すスクリプトはv2では空振りします。

ちなみに手元のMacで docker-compose version を打つと、Docker Compose version v2.32.1 と返ってきました。ハイフン付きで打っても中身はv2、という環境もあるわけです。どちらで打っても動くので、v1が残っていると勘違いしやすいところです。

掃除のコマンドと危ない組み合わせ

Dockerを使っていると、止まったコンテナや古いイメージ、ビルドのキャッシュが少しずつ溜まります。

prune は「使われていないもの」をまとめて消すコマンドで、対象ごとに6種類あります。便利な反面、オプションの組み合わせによってはDBのデータまで消えます。

詳しい使い分けと容量を戻した手順はdocker pruneの使い方にまとめているので、ここでは一覧と危ない組み合わせだけを押さえます。

prune系と容量確認の一覧

消す前に docker system df で、どこに容量を使っているかを確かめるのが先です。

コマンド何を消すか詳しい記事
docker system df消さない。種類ごとの使用量を表示docker prune
docker container prune止まっているコンテナ同上
docker image pruneタグのないイメージ(dangling)同上
docker image prune -aどのコンテナも使っていないイメージ全部同上
docker builder pruneビルドキャッシュ同上
docker network pruneどのコンテナも使っていないネットワーク同上
docker volume prune使われていない匿名ボリューム同上
docker system prune上のうちボリューム以外をまとめて同上

docker volume prune は、手元の27.4.1では名前のない匿名ボリュームだけが対象です。ヘルプの -a の説明は「Remove all unused volumes, not just anonymous ones」です。名前付きボリュームまで消すには -a が要ります。

system prune -a --volumesとdown -vの注意

危ないのは「全部」系のオプションを重ねたときです。何が消えるかを並べると、次のようになります。

コマンド消えるもの戻せるか
docker system prune停止中のコンテナ、未使用ネットワーク、danglingイメージ、未使用のビルドキャッシュイメージは取り直せる
docker system prune -a上に加えて、コンテナが使っていないイメージ全部とビルドキャッシュ全部取り直し・ビルドし直しに時間がかかる
docker system prune -a --volumes上に加えて、使われていない匿名ボリューム匿名ボリュームのデータは戻らない
docker compose down -vそのプロジェクトのコンテナ・ネットワークと、composeに書いた名前付きボリュームDBのデータは戻らない
ハマりポイント
「片付けるつもりの -v」でDBが空になる

docker compose down -v の -v は、compose.yamlの volumes: に書いた名前付きボリュームまで消します。

手元のヘルプの説明も「Remove named volumes declared in the "volumes" section of the Compose file」です。

名前付きボリュームに置いたデータは、docker compose down(-v なし)や docker system prune では残ります。コンテナが消えても、up し直せば同じボリュームがつながります。消して困るのは -v を付けたときと、ボリュームの設定を書かずにDBを動かしていたとき(データが匿名ボリュームに入る)です。消したくないデータがあるときは、-v も -f も付けず、確認のプロンプトで中身を読んでから y を押してください。

-f(--force)を付けると「Are you sure you want to continue? [y/N]」の確認が出ずに、いきなり消えます。

確認を飛ばしたいのは自動化のスクリプトの中だけで、手で打つときは付けない、と決めておくのが安全です。

消す前に確かめる4ステップ

容量が足りなくなって慌てているときほど、いきなり -a --volumes を打ちたくなります。消す前に次の順で確かめると、残したいものを巻き込まずに済みます。

step
1
docker system df で容量の内訳を見る

イメージ・コンテナ・ボリューム・ビルドキャッシュのどれが大きいかを見ます。RECLAIMABLE(取り戻せる量)の列が大きいところから手を付けます。

step
2
docker ps -a で止まったコンテナを確かめる

止まっているコンテナは container prune で消えます。あとで start したいものが混ざっていないかを見ます。

step
3
docker volume ls で残したいボリュームを確かめる

DBのデータが入ったボリュームの名前を控えます。名前付きなら system prune --volumes でも残りますが、匿名ボリュームは長い英数字の名前で並ぶので、どのコンテナのものかは docker inspect で確かめます。

step
4
対象を絞ったpruneを -f なしで打つ

ビルドキャッシュが大きければ docker builder prune、イメージなら docker image prune のように、大きいところだけを消します。確認のプロンプトに出る一覧を読んでから y を押します。

1つずつ消すと手間に見えます。それでも、消す範囲が小さいほど、あとで取り直したりビルドし直したりするものも少なくて済みます。

あわせて読む

調べる・確かめるコマンド(inspect・stats・system df)

「設定は合っているはずなのに動かない」とき、思い込みを事実で確かめるのが調査系のコマンドです。

ログ(logs)と中に入る(exec)で分からないときは、この節のコマンドでコンテナの設定とリソースの使い方を直接見ます。

コマンド何をするか詳しい記事
docker inspect web設定を全部JSONで表示―
docker inspect -f '{{.State.Status}}' web必要な値だけ取り出す―
docker statsCPU・メモリの使用量をリアルタイム表示―
docker top webコンテナの中で動いているプロセス―
docker events起動・停止などの出来事を流して表示―
docker versionクライアントとサーバーの版―
docker infoデーモンの状態や設定―
docker system df -v容量の内訳を詳しくdocker prune

docker inspect の出力はとにかく長いので、-f で必要な値だけ抜くのが実用的です。

よく抜き出すのは、状態・終了コード・環境変数の3つです。

# コンテナの状態(running / exited など)
docker inspect -f '{{.State.Status}}' web

# 終了コード(0以外なら異常終了)
docker inspect -f '{{.State.ExitCode}}' web

# 環境変数の一覧
docker inspect -f '{{.Config.Env}}' web

コンテナが勝手に止まるときは、終了コードを見ると原因の当たりが付きます。137なら強制終了(メモリ不足でOSに止められた場合も含む)、1ならアプリ自身のエラー、というように切り分けられます。

イメージの脆弱性を調べたいときは、docker の標準コマンドではなく、TrivyやGrypeといった専用のツールを使います。使い方は脆弱性診断の記事にまとめました。

まとめて操作する便利な書き方(一括停止・--format・--filter)

コマンド1つずつは覚えても、コンテナが10個並ぶと1つずつ打つのは面倒です。

Dockerのコマンドは、IDだけを出す -q、絞り込みの --filter、表示を整える --format を組み合わせると、まとめて操作できます。ここでは手で打つ機会が多い組み合わせを集めました。

全部のコンテナをまとめて止める・消す

docker ps -q はコンテナIDだけを1行ずつ出すので、$( ) で囲んで別のコマンドに渡せます。

# 動いているコンテナを全部止める
docker stop $(docker ps -q)

# 止まっている(exited の)コンテナだけ消す
docker rm $(docker ps -aq --filter status=exited)

# 名前に web を含むコンテナだけ止める
docker stop $(docker ps -q --filter name=web)

対象が1つもないと、docker stop に何も渡りません。手元で引数なしの docker stop を打つと、次のように出ました。

"docker stop" requires at least 1 argument.
See 'docker stop --help'.

エラーに見えますが、消すものが無かっただけです。

止まったコンテナを消すだけなら docker container prune でも足ります。--filter で条件を付けたいときは、上の書き方のほうが細かく選べます。

--formatで一覧を見やすくする

docker ps の既定の表示は列が多く、ターミナルの幅が狭いと折り返して読みにくくなります。--format で必要な列だけにできます。

# 名前・状態・ポートだけを表で
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

# イメージを「名前:タグ サイズ」で
docker images --format '{{.Repository}}:{{.Tag}} {{.Size}}'

# JSON で出して、ほかのツールに渡す
docker ps --format json

table を先頭に付けると、列の見出し付きの表になります。付けなければ、見出しなしで1行ずつ出ます。

毎回打つのが面倒なら、~/.docker/config.json に "psFormat" として書いておくと、docker ps の既定の表示を変えられます。

--filterで探す

--filter(-f)は、一覧系のコマンドで条件に合うものだけを出すオプションです。

書き方何が出るか使う場面
docker ps -a -f status=exited止まったコンテナ掃除の前の確認
docker ps -f name=db名前に db を含むコンテナ似た名前が並ぶとき
docker ps -f publish=80808080番を公開しているコンテナポートの重複を探す
docker images -f dangling=trueタグのないイメージビルドを繰り返したあと
docker volume ls -f dangling=trueどのコンテナも使っていないボリューム消す前の確認

-f publish=8080 は、後半の「port is already allocated」が出たときに、どのコンテナがポートを握っているかを1行で探せます。

新旧の書き方:docker psとdocker container ls

DockerのコマンドはDocker 1.13で「対象 動詞」で書く形に整理され、古い書き方も別名として残っています。

ネットで調べると両方の書き方が混ざって出てくるので、対応を知っておくと迷いません。

昔からの書き方対象 動詞の書き方何をするか
docker psdocker container lsコンテナを一覧
docker rmdocker container rmコンテナを削除
docker logsdocker container logsログを見る
docker execdocker container exec中でコマンド実行
docker imagesdocker image lsイメージを一覧
docker rmidocker image rmイメージを削除
docker builddocker image buildイメージを作る

どちらを使っても動作は同じです。手元の docker --help でも、run・exec・ps・build などは「Common Commands」に、container・image・volume などは「Management Commands」に分けて並んでいます。

使い分けの目安は単純です。手で打つなら短い昔の書き方、スクリプトや手順書に残すなら対象が読み取れる新しい書き方にすると、あとから読む人が迷いません。

docker volume と docker network には昔の短い書き方がありません。ボリュームとネットワークは最初から「対象 動詞」で書きます。

よく間違えるオプション5つ(-it・-d・--rm・-p・-v)

コマンドそのものより、オプションの意味の取り違えで時間を溶かすことのほうが多いものです。

ここでは、docker run で付ける頻度が高く、しかも意味を取り違えやすい5つを並べます。どれも手元の docker run --help の説明と照らし合わせて書いています。

-itは2つのオプションの組み合わせ

-it は1つのオプションではなく、-i と -t をまとめて書いたものです。

オプション意味(ヘルプの説明)外すとどうなるか
-i入力を開いたままにする(Keep STDIN open)打った文字がコンテナに届かない
-t疑似端末を割り当てる(Allocate a pseudo-TTY)プロンプトが出ず、表示が崩れる

シェルで対話したいときは両方要るので -it で覚えておけば足ります。

逆に、スクリプトからパイプで入力を流し込むときは -t を付けると the input device is not a TTY で止まることがあります。そのときは -i だけにします。

-dと--rmは「あとで何が残るか」が違う

-d はコンテナを裏で動かすオプション、--rm は終了したときにコンテナを自動で消すオプションです。

-d で起動すると、ターミナルにはコンテナIDが1行出るだけでログは表示されません。動いているかどうかは docker ps、ログは docker logs -f で見ます。「起動したのに何も出ない」は、-d を付けた結果としては正常です。

--rm の説明は、手元のヘルプでは「Automatically remove the container and its associated anonymous volumes when it exits」です。コンテナと一緒に匿名ボリュームも消えます。

困るのは、--rm 付きで起動したアプリがすぐ落ちたときです。コンテナごと消えるので docker logs で原因を見られません。原因を調べたいときは --rm を外して起動し直します。

-pは「Mac側:コンテナ側」の順

-p 8080:80 は「Mac(ホスト)の8080番を、コンテナの80番につなぐ」という意味です。左がホスト、右がコンテナです。

Dockerのポート公開の説明でも、-p 8080:80 は「Map port 8080 on the Docker host to TCP port 80 in the container」です。ブラウザで開くのは http://localhost:8080 です。

-p 8080:80

Macの8080番 → コンテナの80番。全部のネットワークから届く

-p 127.0.0.1:8080:80

同じつなぎ方で、届くのはそのMacの中からだけ

IPを書かない -p 8080:80 は、ホストのすべてのアドレスに公開されます。ドキュメントの注意書きは「Publishing container ports is insecure by default」です。同じネットワークの他の機械からも届きます。

開発用のDBや管理画面のように、自分のMacから見えれば十分なものは 127.0.0.1: を付けておくと安心です。ポートとbridgeネットワークの関係はネットワークとポートの記事で図にしています。

-vと--mountは「ないフォルダ」の扱いが違う

-v と --mount は、どちらもフォルダやボリュームをコンテナにつなぐオプションです。違いが出るのは、つなぐ先のフォルダがMac側にないときです。

書き方Mac側にフォルダがないとき書き方の例
-vフォルダを自動で作る-v "$(pwd)"/src:/app
--mountエラーで止まる--mount type=bind,src="$(pwd)"/src,dst=/app

Dockerのバインドマウントの説明は「In general, --mount is preferred」としています。理由は、より明示的で、すべてのオプションに対応しているからです。

-v の自動作成は親切に見えて、パスを打ち間違えたときに空のフォルダが作られ、「ファイルがコンテナから見えない」と悩む原因になります。--mount なら、打ち間違いはその場でエラーとして見つかります。

もう1つの落とし穴は、-v の左側の書き方です。/ や . で始まるとMacのフォルダ(バインドマウント)、db-data のように名前だけだと名前付きボリュームとして扱われます。Macの ./data フォルダをつなぐつもりで -v data:/app と書くと、フォルダではなく data という名前のボリュームが新しく作られます。

オプションはイメージ名より前に書く

docker run の形は docker run [OPTIONS] IMAGE [COMMAND] [ARG...] です。イメージ名より後ろに書いたものは、コンテナの中で動かすコマンドの引数として渡されます。

# 正しい:-p は docker run のオプションとして効く
docker run -d -p 8080:80 nginx:1.27

# 間違い:-p 8080:80 が nginx の引数として渡され、ポートは公開されない
docker run -d nginx:1.27 -p 8080:80

エラーにならずに起動してしまうことがあるので、「ポートを付けたのにつながらない」ときは、まずオプションの位置を見直します。

うまく動かないときの確認コマンド

コマンドを打って最初に出るエラーは、だいたい決まった数種類です。

ここでは、メッセージの決め手になる言葉と、確認に打つコマンドを対応させておきます。原因の深掘りが必要なものは、各記事へ送ります。

Cannot connect to the Docker daemonと出たとき

どの docker コマンドを打っても Cannot connect to the Docker daemon と出るなら、Dockerの本体(デーモン)が動いていません。

この記事を書いている最中、手元で docker info を打ったら、同じメッセージが出ました。

Cannot connect to the Docker daemon at unix:///Users/(ユーザー名)/.rd/docker.sock. Is the docker daemon running?

Rancher DesktopやDocker Desktopを起動していないときに出るメッセージで、アプリを起動すれば直ります。Linuxなら sudo systemctl start docker です。

一方で、docker --help や docker compose config はデーモンが止まっていても動きました。ヘルプで書き方を調べる、ymlの書き間違いを探す、といった作業はDockerを起動しなくてもできます。

docker versionとdocker context lsで接続先を確かめる

アプリは起動しているのに Cannot connect が消えないときは、docker コマンドがどこにつなごうとしているかを見ます。

docker version は、手元のクライアントと、つながった先のサーバーの版を両方出すコマンドです。デーモンが止まっていた手元のMacでは、クライアントの情報だけが出て、最後にエラーが付きました。

Client:
 Version:           27.4.1-rd
 API version:       1.47
 Go version:        go1.22.10
 Git commit:        1707ac7
 Built:             Wed Dec 18 18:47:41 2024
 OS/Arch:           darwin/arm64
 Context:           rancher-desktop
Cannot connect to the Docker daemon at unix:///Users/(ユーザー名)/.rd/docker.sock. Is the docker daemon running?

Client: が出て Server: が出ないなら、コマンドは入っていて、つなぐ先が動いていない状態です。Context: の行が、いまつなごうとしている先の名前です。

Docker DesktopとRancher Desktopを入れ替えたあとは、つなぐ先の設定(コンテキスト)が古いまま残っていることがあります。一覧は docker context ls で見られます。

NAME                DESCRIPTION                               DOCKER ENDPOINT                                ERROR
default             Current DOCKER_HOST based configuration   unix:///var/run/docker.sock
rancher-desktop *   Rancher Desktop moby context              unix:///Users/(ユーザー名)/.rd/docker.sock

* が付いているのが今使っているコンテキストです。切り替えるときは docker context use default のように名前を指定します。

port is already allocated・名前の重複と出たとき

次によく見るのは、ポートと名前の重複です。

メッセージに含まれる言葉原因確認するコマンド
port is already allocated同じポートを別のコンテナが使っているdocker ps(PORTS列を見る)
address already in useMac側の別のアプリがポートを使っているlsof -i :8080
is already in use by container同じ名前のコンテナが残っているdocker ps -a
requires exactly 1 argumentビルドのフォルダ(.)などを書き忘れdocker build --help
exec: "bash": executable file not foundイメージにbashがないdocker exec -it コンテナ sh

ポートが重なったら、-p 8081:80 のようにMac側の番号だけ変えれば起動できます。コンテナ側の80番は変える必要がありません。

ポート周りでつながらない原因の切り分けはネットワークとポートの記事、コンテナが起動しないときの全体の確認手順はDocker入門にまとめています。

あわせて読む

よくある質問

Dockerコマンドについて、調べるときによく出てくる疑問をまとめました。新旧の書き方、Composeの書き方、危ないオプションの3つが中心です。手順の細かい点は、各見出しの本文もあわせて確認してください。

Q1. docker psとdocker container lsは何が違いますか?

A1. 同じコマンドです。手元の docker ps --help でも、docker container ls・docker container list・docker container ps が別名として並んでいます。手で打つなら短い docker ps、手順書に残すなら対象が読み取れる docker container ls にすると、あとから読む人が迷いません。

Q2. docker-composeとdocker composeはどちらを使えばいいですか?

A2. docker compose(スペース区切り)を使います。ハイフン付きの docker-compose はCompose v1の書き方で、Docker社は2023年6月でv1のサポートを終えると告知しました。多くはハイフンをスペースに変えるだけで動きますが、v2ではコンテナ名の区切りが _ から - に変わっています。

Q3. 止まっているコンテナも含めて一覧を出すには?

A3. docker ps -a です。docker ps だけでは動いているコンテナしか出ません。名前の重複でエラーになったのに一覧に見当たらないときは、止まったコンテナが残っているので -a で探してください。

Q4. docker run -itの-iと-tは何の意味ですか?

A4. -i は入力を開いたままにする、-t は疑似端末を割り当てるオプションです。シェルで対話するには両方必要なので -it とまとめて書きます。パイプで入力を流し込むスクリプトでは -t を外し、-i だけにします。

Q5. -p 8080:80はどちらがホスト側のポートですか?

A5. 左の8080がホスト(Mac)側、右の80がコンテナ側です。ブラウザでは http://localhost:8080 を開きます。IPを書かないとすべてのアドレスに公開されるので、自分のMacからだけ使うなら -p 127.0.0.1:8080:80 と書きます。

Q6. docker system prune -a --volumesを実行するとDBのデータは消えますか?

A6. 手元の27.4.1では、--volumes で消えるのは使われていない匿名ボリュームで、名前付きボリュームは残ります。ただし匿名ボリュームにDBのデータを置いていれば消えます。docker compose down -v はcompose.yamlに書いた名前付きボリュームも消すので、DBのデータを残したいときは付けません。

Q7. Dockerを再起動するコマンドは?

A7. コンテナなら docker restart コンテナ、Composeのサービスなら docker compose restart サービス です。Docker本体を再起動したいときは、Linuxなら sudo systemctl restart docker、MacやWindowsならDocker Desktopなどのアプリを終了して起動し直します。

Q8. コマンドの正しい書き方を手元で確かめるには?

A8. docker コマンド --help で、オプションと別名の一覧が出ます(例: docker run --help、docker compose up --help)。デーモンが止まっていても表示できるので、Dockerを起動する前に書き方だけ確かめたいときにも使えます。

Dockerコマンドを覚える次の一歩

Dockerのコマンドは数が多く見えますが、毎日打つのは冒頭の10個で、残りは「対象 動詞」の組み合わせで引けば足ります。

覚え方のコツは、状態の流れ(作る → 動かす → 止める → 消す)を頭に入れておくことです。あわせて、消えるものの範囲(stop は残す、rm は消す、-v はデータまで消す)も一緒に覚えます。オプションでは -p の左がホスト、--rm と -v で何が消えるか、の2点を押さえておくと、つながらない・消えたの事故を防ぎやすくなります。

コマンドの全体像が見えたら、自分のプロジェクトで実際に使う組み合わせを決めていく段階です。続きの記事は、動かしたいものによって分かれます。

あわせて読む
NEXT STEP
今のプロジェクトで docker compose config を1回打って、ymlがどう読まれているかを見てみる。

Dockerを起動していなくても動きます。ポートの左右やボリューム名の付き方が、そのまま目で確かめられます。

途中経過は、また書きます。

NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

Docker

TOC