{"componentChunkName":"component---src-templates-post-template-js","path":"/posts/best-way-to-setup-docker-volume","result":{"data":{"markdownRemark":{"id":"30c3408e-9edd-5f38-8b96-3e5bbd377947","html":"

Docker で構築した開発環境は再現性が高く、Windows でも macOS でも動くと思われています。

\n

基本的にはその通りなのですが、ホストのファイルシステムが絡んでくるボリュームについては、書き方次第で「Windows では動かない」となることがあります。

\n

この記事では、Windows でも macOS でも動く Docker のボリュームの書き方をまとめます。

\n

検証した環境

\n\n

docker run の場合

\n

docker run の場合と Docker Compose の場合でも書き方が異なるので、まずは docker run を使う場合について書いていきます。

\n

docker run するときは、Windows でも macOS でも同じ書き方で動きます。

\n

一番よさそうな書き方

\n
docker run -v $PWD/mydir/subdir:/work ubuntu ls /work
\n

docker run の -v オプションでホストのパスを指定する箇所では、PWDやPWD やPWDや(pwd)、`pwd` を使って、絶対パスで書くのが一番よさそうです。

\n

NG な書き方

\n
docker run -v mydir/subdir:/work ubuntu ls /work
\n

のように、相対パスで記述してしまうと、以下のようなエラーになります。

\n
docker: Error response from daemon: create myapp/subdir: "myapp/subdir" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed. If you intended to pass a host directory, use absolute path.\nSee 'docker run --help'.
\n

ホストのディレクトリを指定する場合は絶対パスを使う必要があるためです。

\n

一応、「/」という文字を含まない以下のような形式であれば動作しますが、普段から絶対パスで指定するのが良いでしょう。

\n
docker run -v mydir:/work ubuntu ls /work
\n

Docker Compose の場合

\n

一番よさそうな書き方

\n
version: '3'\n\nservices:\n  nginx:\n    image: nginx:1.21.6-alpine\n    volumes:\n      - ./nginx/html:/usr/share/nginx/html
\n

docker-compose.yaml の場合、相対パスで書くのが一番よさそうです。

\n

もしホームディレクトリを基準にしたい場合は、「~/mydir」のように指定してください。

\n

NG な書き方

\n

docker run で絶対パスを指定したのと同様に、

\n
      - $PWD/nginx/html:/usr/share/nginx/html
\n

と書きたくなると思います。

\n

しかし、この書き方では、Windows で

\n
WARNING: The PWD variable is not set. Defaulting to a blank string.
\n

という WARNING が出力される場合があり、その際は $PWD が空文字列として解釈されてしまいます。

\n

$PWD は Windows でも動く場合・動かない場合があり、詳細な再現条件は分からないですが、避けたほうが無難でしょう。

\n

まとめ

\n

以上をまとめると、

\n\n

ということになります。

\n

これで今後は悩むことがなくなりそうです。

","fields":{"slug":"/posts/best-way-to-setup-docker-volume","tagSlugs":["/tag/docker/"],"autoRecommendPosts":["docker-books","udemy-docker-from-linux-and-networking","macos-virtualization","anyenv-asdf-docker"]},"frontmatter":{"date":"2022-06-24T16:18:29.984Z","description":"Docker で構築した開発環境は再現性が高く、Windows でも macOS でも動くと思われています。\n\n\n基本的にはその通りなのですが、ホストのファイルシステムが絡んでくるボリュームについては、書き方次第で「Windows では動かない」となることがあります。\n\nこの記事では、Windows でも macOS でも動く Docker のボリュームの書き方をまとめます。","tags":["docker"],"title":"Windows でも macOS でも動く Docker のボリュームの指定","socialImage":null,"recommendPosts":null}}},"pageContext":{"slug":"/posts/best-way-to-setup-docker-volume"}},"staticQueryHashes":["251939775","3942705351","401334301"]}