Docker Management

skill の情報
参考: SKILL.md 全文
使いどころ
前提条件
早見表
手順
1. どの領域の話か見極める
2. コンテナの操作
3. イメージの管理
4. Docker Compose
5. ボリュームとネットワーク
6. ディスク使用量と掃除
つまずきどころ
検証
Dockerfile を良くするコツ

Docker のコンテナ・イメージ・ボリューム・Compose を管理します。

skill の情報


提供元	追加インストール — `hermes skills install official/devops/docker-management` で導入します
パス	`optional-skills/devops/docker-management`
バージョン	`1.0.0`
作者	sprmn24
ライセンス	MIT
対応プラットフォーム	linux, macos, windows
タグ	`docker`, `containers`, `devops`, `infrastructure`, `compose`, `images`, `volumes`, `networks`, `debugging`

参考: SKILL.md 全文

Docker Management

標準の Docker CLI コマンドで、コンテナ・イメージ・ボリューム・ネットワーク・Compose のスタックを管理します。Docker 本体のほかに必要なものはありません。

使いどころ

コンテナの起動・停止・再起動・削除・中身の確認
Docker イメージのビルド・pull・push・タグ付け・整理
Docker Compose（複数サービスのスタック）を扱う
ボリュームやネットワークの管理
落ちるコンテナの原因調べ、ログの分析
Docker のディスク使用量の確認、空き容量の確保
Dockerfile の見直しや最適化

前提条件

Docker Engine がインストールされ、動いていること
ユーザーが docker グループに入っていること（または sudo を使うこと）
Docker Compose v2（最近の Docker には同梱されています）

さっと確認するには:

docker --version && docker compose version

早見表

やりたいこと	コマンド
コンテナを起動（バックグラウンド）	`docker run -d --name NAME IMAGE`
停止して削除	`docker stop NAME && docker rm NAME`
ログを見る（追いかける）	`docker logs --tail 50 -f NAME`
コンテナの中でシェルを開く	`docker exec -it NAME /bin/sh`
全コンテナの一覧	`docker ps -a`
イメージをビルド	`docker build -t TAG .`
Compose の起動	`docker compose up -d`
Compose の停止	`docker compose down`
ディスク使用量	`docker system df`
宙に浮いたものを掃除	`docker image prune && docker container prune`

手順

1. どの領域の話か見極める

依頼がどの領域に当たるかを整理します:

コンテナのライフサイクル → run、stop、start、restart、rm、pause/unpause
コンテナとのやり取り → exec、cp、logs、inspect、stats
イメージの管理 → build、pull、push、tag、rmi、save/load
Docker Compose → up、down、ps、logs、exec、build、config
ボリュームとネットワーク → create、inspect、rm、prune、connect
困りごとの調査 → ログの分析、終了コード、リソースの問題

2. コンテナの操作

新しいコンテナを起動する:

# Detached service with port mapping
docker run -d --name web -p 8080:80 nginx

# With environment variables
docker run -d -e POSTGRES_PASSWORD=secret -e POSTGRES_DB=mydb --name db postgres:16

# With persistent data (named volume)
docker run -d -v pgdata:/var/lib/postgresql/data --name db postgres:16

# For development (bind mount source code)
docker run -d -v $(pwd)/src:/app/src -p 3000:3000 --name dev my-app

# Interactive debugging (auto-remove on exit)
docker run -it --rm ubuntu:22.04 /bin/bash

# With resource limits and restart policy
docker run -d --memory=512m --cpus=1.5 --restart=unless-stopped --name app my-app

主なフラグ: -d はバックグラウンド、-it は対話+tty、--rm は終了時に自動削除、-p はポート（ホスト:コンテナ）、-e は環境変数、-v はボリューム、--name は名前、--restart は再起動の方針です。

動いているコンテナを扱う:

docker ps                        # running containers
docker ps -a                     # all (including stopped)
docker stop NAME                 # graceful stop
docker start NAME                # start stopped container
docker restart NAME              # stop + start
docker rm NAME                   # remove stopped container
docker rm -f NAME                # force remove running container
docker container prune           # remove ALL stopped containers

コンテナとやり取りする:

docker exec -it NAME /bin/sh          # shell access (use /bin/bash if available)
docker exec NAME env                   # view environment variables
docker exec -u root NAME apt update    # run as specific user
docker logs --tail 100 -f NAME         # follow last 100 lines
docker logs --since 2h NAME            # logs from last 2 hours
docker cp NAME:/path/file ./local      # copy file from container
docker cp ./file NAME:/path/           # copy file to container
docker inspect NAME                    # full container details (JSON)
docker stats --no-stream               # resource usage snapshot
docker top NAME                        # running processes

3. イメージの管理

# Build
docker build -t my-app:latest .
docker build -t my-app:prod -f Dockerfile.prod .
docker build --no-cache -t my-app .              # clean rebuild
DOCKER_BUILDKIT=1 docker build -t my-app .       # faster with BuildKit

# Pull and push
docker pull node:20-alpine
docker login ghcr.io
docker tag my-app:latest registry/my-app:v1.0
docker push registry/my-app:v1.0

# Inspect
docker images                          # list local images
docker history IMAGE                   # see layers
docker inspect IMAGE                   # full details

# Cleanup
docker image prune                     # remove dangling (untagged) images
docker image prune -a                  # remove ALL unused images (careful!)
docker image prune -a --filter "until=168h"   # unused images older than 7 days

4. Docker Compose

# Start/stop
docker compose up -d                   # start all services detached
docker compose up -d --build           # rebuild images before starting
docker compose down                    # stop and remove containers
docker compose down -v                 # also remove volumes (DESTROYS DATA)

# Monitoring
docker compose ps                      # list services
docker compose logs -f api             # follow logs for specific service
docker compose logs --tail 50          # last 50 lines all services

# Interaction
docker compose exec api /bin/sh        # shell into running service
docker compose run --rm api npm test   # one-off command (new container)
docker compose restart api             # restart specific service

# Validation
docker compose config                  # validate and view resolved config

最小限の compose.yml の例:

services:
  api:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/mydb
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: mydb
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  pgdata:

5. ボリュームとネットワーク

# Volumes
docker volume ls                       # list volumes
docker volume create mydata            # create named volume
docker volume inspect mydata           # details (mount point, etc.)
docker volume rm mydata                # remove (fails if in use)
docker volume prune                    # remove unused volumes

# Networks
docker network ls                      # list networks
docker network create mynet            # create bridge network
docker network inspect mynet           # details (connected containers)
docker network connect mynet NAME      # attach container to network
docker network disconnect mynet NAME   # detach container
docker network rm mynet                # remove network
docker network prune                   # remove unused networks

6. ディスク使用量と掃除

掃除の前に、必ずまず現状を調べます:

# Check what's using space
docker system df                       # summary
docker system df -v                    # detailed breakdown

# Targeted cleanup (safe)
docker container prune                 # stopped containers
docker image prune                     # dangling images
docker volume prune                    # unused volumes
docker network prune                   # unused networks

# Aggressive cleanup (confirm with user first!)
docker system prune                    # containers + images + networks
docker system prune -a                 # also unused images
docker system prune -a --volumes       # EVERYTHING — named volumes too

注意: docker system prune -a --volumes は、ユーザーに確認せずに実行してはいけません。大事なデータが入っているかもしれない名前付きボリュームまで消えます。

つまずきどころ

症状	原因	対処
コンテナがすぐ終了する	メインのプロセスが終わったか落ちた	`docker logs NAME` を確認し、`docker run -it --entrypoint /bin/sh IMAGE` を試す
「port is already allocated」	別のプロセスがそのポートを使っている	`docker ps` か `lsof -i :PORT` で見つける
「no space left on device」	Docker のディスクがいっぱい	`docker system df` を見てから、狙いを定めて prune する
コンテナに繋がらない	アプリがコンテナの中で 127.0.0.1 を待ち受けている	アプリは `0.0.0.0` を待ち受ける必要がある。`-p` の対応も確認する
ボリュームで permission denied	ホストとコンテナで UID/GID が食い違っている	`--user $(id -u):$(id -g)` を使うか、パーミッションを直す
Compose のサービス同士が繋がらない	ネットワークかサービス名が違う	サービス名がホスト名になる。`docker compose config` を確認する
ビルドのキャッシュが効かない	Dockerfile のレイヤーの順番が悪い	変わりにくいレイヤーを先に置く（ソースより先に依存関係）
イメージが大きすぎる	マルチステージビルドと .dockerignore がない	マルチステージビルドを使い、`.dockerignore` を足す

検証

Docker の操作をしたら、毎回結果を確かめます:

コンテナは起動したか? → docker ps（状態が「Up」か確認）
ログはきれいか? → docker logs --tail 20 NAME（エラーが出ていないか）
ポートに繋がるか? → curl -s http://localhost:PORT または docker port NAME
イメージはできたか? → docker images | grep TAG
Compose のスタックは健全か? → docker compose ps（全サービスが「running」か「healthy」か）
容量は空いたか? → docker system df（前後を見比べる）

Dockerfile を良くするコツ

Dockerfile を見直したり新しく書いたりするときは、次の改善を提案してください:

マルチステージビルド — ビルド用の環境と実行環境を分けて、最終的なイメージを小さくします
レイヤーの順番 — 依存関係をソースコードより先に置いて、変更でキャッシュが無効にならないようにします
RUN をまとめる — レイヤーが減り、イメージが小さくなります
.dockerignore を使う — node_modules、.git、__pycache__ などを除きます
ベースイメージのバージョンを固定する — node:latest ではなく node:20-alpine にします
root 以外で動かす — 安全のために USER の指定を足します
slim や alpine のベースを使う — python:3.12 ではなく python:3.12-slim にします