ツール
Docker
アプリケーションをコンテナ化して配布・実行するためのプラットフォーム。Dockerfile のビルド・イメージ・単一コンテナの実行が主題で、複数コンテナのまとめ起動やサービス間連携は Docker Compose が担当する。
問題一覧(15)
Docker build でキャッシュが効いて変更が反映されない
Docker build はレイヤーごとにキャッシュを再利用するため、COPY 元のファイル変更を検知させないと古いレイヤーが使われる。--no-cache で全レイヤー無効化、--build-arg にビルド日時を渡す、COPY 順を依存とソースで分ける、で対処する。
更新: 2026-11-03、タグ: build、cache、dockerfile
Docker build できない(Cannot connect to the Docker daemon)
Docker daemon が起動していない、または現ユーザーが docker グループに属していないと build/run の全てが失敗する。OS別に確認手順が異なる。
更新: 2026-11-16、タグ: daemon、build、permission
docker run したコンテナがすぐ終了して起動し続けられない
docker run したコンテナがすぐ終了するのは、メインプロセス(PID 1)が終わったためだ。docker ps -a と docker logs で終了理由を確かめ、サーバ系はフォアグラウンドで常駐させる。
更新: 2026-09-01、タグ: container、exit、run
Dockerfile の COPY でファイルが見つからずビルドできない
COPY のソースは Dockerfile があるディレクトリではなく build context 基準で解決される。.dockerignore で除外されている、または build context 外を指していないか確認する。
更新: 2026-11-12、タグ: dockerfile、copy、build-context
Docker の .dockerignore が効かずファイルを除外できない
.dockerignore はビルドコンテキストのルート直下に置き、glob 構文と否定 (!) の順序を正しく書かないと無視されない。ファイル名・配置・BuildKit の仕様差で詰まる。
更新: 2026-11-03、タグ: dockerignore、build、context
docker exec で「executable file not found in $PATH」が出て実行できない
executable file not found in $PATH は、docker exec で指定したコマンドがコンテナ内に無いと出る。bash の無い alpine / slim 系なら sh を使えば直る。
更新: 2026-09-21、タグ: exec、executable-not-found、path
Docker の HEALTHCHECK がいつも unhealthy になる
HEALTHCHECK は CMD が exit 0 で healthy、それ以外で unhealthy。コンテナに curl 等が無い、起動待ち時間不足、shell / exec 形式の書き分けが主因。docker inspect の Health.Log で実エラーを確認する。
更新: 2026-09-23、タグ: healthcheck、dockerfile、container
Docker rmi「image is being used by stopped container」の原因と直し方
image is being used by stopped container は、停止中のコンテナがイメージを参照していると出る。先に docker rm でコンテナを消すか、docker rmi -f で強制削除すれば直る。
更新: 2026-11-05、タグ: rmi、image、container
docker login の認証情報が保存できない(毎回ログインを求められる)
~/.docker/config.json の credsStore が OS のキーチェーンに対応していないと認証情報が保存されない。OS ごとの credential helper をインストールし、credsStore を明示する。
更新: 2026-10-20、タグ: login、credentials、credsStore
Docker「Bind for 0.0.0.0:8080 failed: port is already allocated」の原因と直し方
port is already allocated は、-p で指定したホストポートを既存のコンテナや別プロセスが使っていると出る。使っている相手を止めるか、-p 8081:8080 のように別のホストポートへ割り当て直せば直る。
更新: 2026-09-02、タグ: port、run、bind
Docker「permission denied while trying to connect to the Docker daemon socket」の原因と直し方
permission denied while trying to connect は、ユーザーが docker グループに属していないと出る。sudo usermod -aG docker $USER で追加し、ログインし直せば直る。
更新: 2026-11-05、タグ: permission、socket、docker-group
Docker のボリュームマウントで permission denied になり書き込めない
bind mount したホストディレクトリに対しコンテナ側の uid/gid が一致しないと書き込めない。--user で uid を揃える、:Z で SELinux ラベルを付ける、named volume に切り替える、の 3 系統で対処する。
更新: 2026-10-05、タグ: volume、permission、bind-mount
docker build で「no space left on device」が出てビルドできない
no space left on device は、ビルドキャッシュや未使用のイメージ・ボリュームが溜まると出る。docker builder prune と docker system prune で掃除すれば直る。
更新: 2026-10-21、タグ: build、disk、prune
Docker で「platform (linux/amd64) does not match」警告が出てイメージを使えない
platform (linux/amd64) does not match は、--platform の明示かマルチアーキビルドで消える。arm64 の Mac で amd64 専用イメージを動かすと出る警告で、Rosetta はエミュレーションを速くするだけで platform を変えない。
更新: 2026-11-04、タグ: platform、arm64、m1
Docker pull が toomanyrequests で失敗する(Docker Hub レート制限)
Docker Hub は匿名 IP / 無料アカウントで pull 回数に上限がある。docker login で認証 pull に切り替える、ミラーや別レジストリを使う、CI のレイヤキャッシュを効かせる、の 3 系統で逃がす。
更新: 2026-10-27、タグ: pull、registry、rate-limit