docker『Volume is Not Available』の原因と対処法

# 典型的なメッセージ例
Error response from daemon: 
  create mydata: VolumeDriver.Mount: 
  Volume mydata is not available

Error response from daemon:
  failed to mount local volume: volume not found

docker: Error response from daemon: 
  could not find volume "mydata" with driver "local".

failed to initialize logging driver: 
  file '/var/lib/docker/volumes/logs/_data/app.log' is not available

# すべてのボリューム一覧
docker volume ls

# 対象ボリュームの詳細
docker volume inspect mydata

# ボリュームを利用しているコンテナを確認
docker ps -a --filter volume=mydata --format 'table {{.Names}}\t{{.Status}}'

# ボリューム作成
docker volume create mydata

# ボリュームを使ってコンテナ起動
docker run -d --name app \
  -v mydata:/var/lib/app \
  myorg/app:1.0

services:
  app:
    image: myorg/app:1.0
    volumes:
      - mydata:/var/lib/app

volumes:
  mydata: {}    # localドライバのnamed volumeを自動作成

# docker-compose.yml の例
volumes:
  mydata:
    external: true

# 事前にボリュームを作成
docker volume create mydata

# その後に compose up
docker compose up -d

docker volume create --driver rexray mydata

docker service create \
  --name app \
  --mount type=volume,source=mydata,target=/var/lib/app \
  myorg/app:1.0

# named volume の例
docker run -v mydata:/var/lib/app myorg/app:1.0

# bind mount の例（ホストディレクトリを指定）
docker run -v /opt/appdata:/var/lib/app myorg/app:1.0

# NG: volumesセクションでホストパスをnamed volumeとして認識させてしまう例
volumes:
  /opt/appdata: {}

# OK: services側の volumes だけにホストパスを書き、volumes: 定義にはnamed volumeだけを書く
services:
  app:
    volumes:
      - /opt/appdata:/var/lib/app

volumes:
  mydata: {}

# NFSをlocal driver optionsで使う例
docker volume create \
  --driver local \
  --opt type=nfs \
  --opt o=addr=nfs.example.com,nolock,soft,rw \
  --opt device=:/export/data \
  nfsdata

# ホストからNFSサーバに到達できるか
ping nfs.example.com

# mountコマンドやcat /etc/fstab の内容を確認
mount | grep nfs

# Desktop の設定（GUI操作）
# Settings → Resources → File Sharing でホストディレクトリの共有を許可

# WSL2 内からの例
docker run -v /mnt/c/Users/user/data:/data alpine ls /data

# 未使用ボリュームを削除
docker volume prune

# 全体的な使用状況確認
docker system df -v

# ボリュームのMountpointを確認
docker volume inspect mydata \
  --format '{{ .Mountpoint }}'

# Mountpointの権限を見る
sudo ls -ld /var/lib/docker/volumes/mydata/_data

# :z/:Z オプションでラベルを付与したbind mount
docker run -v /opt/appdata:/var/lib/app:Z myorg/app:1.0

# どのドライバが使えるか
docker info | sed -n '/Plugins:/,/Runtimes:/p'

# 特定ドライバを指定している例
docker volume create --driver rexray/mycloud mycloudvol

# 1) Mountpointを確認
mp=$(docker volume inspect mydata --format '{{ .Mountpoint }}')
echo "$mp"

# 2) 中身をバックアップ（ホスト側で）
sudo tar czf /backup/mydata-backup.tgz -C "$mp" .

# 3) コンテナを止めてボリュームを作り直し、バックアップから復元
docker stop app || true
docker rm app || true
docker volume rm mydata

docker volume create mydata
mp_new=$(docker volume inspect mydata --format '{{ .Mountpoint }}')

sudo tar xzf /backup/mydata-backup.tgz -C "$mp_new"

# 1) external volume が未作成
# NG: docker-compose.yml
volumes:
  mydata:
    external: true

# OK: 事前に作成
docker volume create mydata
docker compose up -d

# 2) named volume と bind mount の取り違え
# NG:
docker run -v /data:/var/lib/app myorg/app:1.0   # /data が存在しない
# OK:
mkdir -p /data
docker run -v /data:/var/lib/app myorg/app:1.0

# 3) Docker Desktopで共有外ディレクトリ
# NG: File Sharingに登録していないパスをbind mount
docker run -v /non/shared/path:/data myorg/app:1.0
# OK: File Sharingに追加 or 共有ディレクトリ配下を使用

# 4) NFSボリュームの到達不可
# NG: NFSサーバ停止中のまま起動
# OK: NFSサーバを起動し、ネットワーク/エクスポート設定を再確認

1) docker volume ls / inspect で、そのボリュームが本当に存在し、Driver/Mountpointが期待通りか
2) external: true を使っている場合、事前に volume create してあるか
3) named volume と bind mount を混同していないか（ホストパスかボリューム名かを確認したか）
4) NFSやクラウドボリュームなら、サーバ/ストレージ側がオンラインで、ネットワーク/認証が正しく通っているか
5) Docker Desktop/WSL2 なら、File Sharing設定や /mnt/c/... など、環境固有の共有設定を確認したか
6) ボリュームのMountpointの権限・SELinuxラベル・ファイルシステムの状態に問題がないか
7) 使用しているボリュームドライバがインストールされ、docker info に表示されているか
8) データが重要なボリュームはバックアップを取った上で、必要なら作り直し+復元でクリーンな状態に戻したか