Generally speaking, Docker containers should have everything they need access to baked into the image. There are times, however, that it may be necessary to have additional files or directories provided to the container to persist information. These can include, but are not limited to:<\/p>\n
Docker has two ways to provide such storage: bind mounts<\/strong><\/i> and volumes<\/strong><\/i>.<\/p>\n Bind mounts are used to provide access to a directory on the host machine. On a Linux host, Docker allows you to bind a user defined directory into the root filesystem of the container, effectively allowing you to do the equivalent of mount –bind<\/i> for your directly to link it directly to the container’s filesystem. This is ideal for providing custom configuration files or saving off build artifacts to your host directory. To mount a directory into a container, execute the following on an example container:<\/p>\n This creates a simple dummy site and then pulls down the\u00a0nginx<\/span> image, running it with the content of our simple site. If you open your web browser to http:\/\/localhost<\/a>, you will see the “Hello, world!” message that we left in our sample directory. Alternatively, instead of the\u00a0–mount<\/span> option, you can use the older style -v<\/em> syntax:<\/p>\n It is recommended that you use the\u00a0–mount<\/span>\u00a0 option as it is more precise in its definition. The -v<\/span>\u00a0 option is only still available for legacy purposes.<\/p>\n We can inspect the container and see that the mount is defined for our container by using docker inspect test<\/span>\u00a0:<\/p>\n We can specify bind mounts in a compose file as such:<\/p>\n You can also map an individual file onto a container, but it is rare to do so. If using the\u00a0-v<\/em> syntax, note that if the file is missing, a directory will be created with the name of the file that you specify. This can be confounding if you use this in a Compose file. More can be found on the Docker website:<\/p>\n https:\/\/docs.docker.com\/storage\/bind-mounts\/<\/a><\/p>\n Bind mounts on Docker for Mac do not use native bind mounting, but instead uses osxfs <\/i>to attempt to provide a near-native experience for bind mounts. It is still slower than a native bind mount running on Linux, but should still work seamlessly with local HFS+ filesystems. By default, it only has access to the \/Users, \/Volumes, \/private, <\/i>and \/tmp<\/i> directories. See official documentation details on Docker’s official website:<\/p>\n https:\/\/docs.docker.com\/docker-for-mac\/osxfs\/<\/a><\/p>\n Docker volumes are file system mounts that are managed completely by the Docker engine. Historically, these have been called “named volumes,” just in case you see a reference to it in literature or in command line help or error messages. When a Docker volume is created, the directory is stored in the \/var\/lib\/docker\/volumes\/<\/span>\u00a0 directory. The typical use case for a named volume would be for something like data persistence or sharing data between containers. Let’s dig out the Pastr app from the first tutorial. We’ll add the mount in the docker-compose.yml<\/span>\u00a0 file:<\/p>\n The top-level volumes<\/em> directive (at the bottom of the snippet) denotes that a datastore shall be created via this compose file. After starting the container with docker-compose up -d<\/span> the Docker engine will create the pastrdatastore<\/em> volume.<\/p>\n It creates it a volume in the\u00a0 \/var\/lib\/docker\/volumes<\/span>\u00a0 directory. This volume is mounted to the database container, which we see when we inspect it with docker inspect pastr_database_1<\/span>\u00a0.<\/p>\n Note that on a Linux machine, this volume exists on the native filesystem. However, on a Windows or Mac system, this volume exists within the virtual machine; you can’t access it directly, nor should you try to, even on a Linux machine. If you need to mount the data store to inspect its contents, you can run it with\u00a0docker run -it –rm –mount source=pastr_pastrdatastore,destination=\/mnt ubuntu \/bin\/bash<\/span>.<\/p>\n For more details, please see the official Docker documentation:<\/p>\n https:\/\/docs.docker.com\/storage\/volumes\/#start-a-service-with-volumes<\/a><\/p>\n","protected":false},"excerpt":{"rendered":" Generally speaking, Docker containers should have everything they need access to baked into the image. There are times, however, that it may be necessary to have additional files or directories provided to the container to persist information. These can include, but are not limited to: Configuration files Data persistence (usually only for local databases for … Continue reading Persisting Storage in Docker<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[5],"tags":[],"class_list":["post-85","post","type-post","status-publish","format-standard","hentry","category-docker"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/paDvvN-1n","jetpack-related-posts":[],"_links":{"self":[{"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/posts\/85","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/comments?post=85"}],"version-history":[{"count":6,"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/posts\/85\/revisions"}],"predecessor-version":[{"id":96,"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/posts\/85\/revisions\/96"}],"wp:attachment":[{"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/media?parent=85"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/categories?post=85"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/edspace.com\/blog\/wp-json\/wp\/v2\/tags?post=85"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Bind Mounts<\/h2>\n
mkdir -p testsite\r\necho \"Hello, world!\" > testsite\/index.html\r\ndocker run -d --rm --name test --mount type=bind,source=$(pwd)\/testsite,target=\/usr\/share\/nginx\/html -p 80:80 nginx<\/pre>\n
docker run -d --rm --name test -v $(pwd)\/testsite:\/usr\/share\/nginx\/html -p 80:80 nginx<\/pre>\n
...\r\n \"Mounts\": [\r\n {\r\n \"Type\": \"bind\",\r\n \"Source\": \"\/tmp\/testsite\",\r\n \"Destination\": \"\/usr\/share\/nginx\/html\",\r\n \"Mode\": \"\",\r\n \"RW\": true,\r\n \"Propagation\": \"rprivate\"\r\n }\r\n ],\r\n...<\/pre>\nversion: \"3.2\"\r\nservices:\r\n web:\r\n image: nginx:alpine\r\n volumes:\r\n - type: bind\r\n source: .\/testsite\r\n target: \/usr\/share\/nginx\/html\r\n<\/pre>\n
Docker Volumes<\/h2>\n
database:\r\n image: redis:latest\r\n volumes:\r\n - type: volume\r\n source: pastrdatastore\r\n target: \/data\r\n ports:\r\n - \"6379:6379\"\r\n...\r\nvolumes:\r\n pastrdatastore:<\/pre>\n
$ docker volume ls\r\nDRIVER VOLUME NAME\r\nlocal pastr_pastrdatastore\r\n$ docker volume inspect pastr_pastrdatastore \r\n[\r\n {\r\n \"CreatedAt\": \"2018-09-25T20:13:41-05:00\",\r\n \"Driver\": \"local\",\r\n \"Labels\": {\r\n \"com.docker.compose.project\": \"pastr\",\r\n \"com.docker.compose.version\": \"1.22.0\",\r\n \"com.docker.compose.volume\": \"pastrdatastore\"\r\n },\r\n \"Mountpoint\": \"\/var\/lib\/docker\/volumes\/pastr_pastrdatastore\/_data\",\r\n \"Name\": \"pastr_pastrdatastore\",\r\n \"Options\": null,\r\n \"Scope\": \"local\"\r\n }\r\n]\r\n<\/pre>\n \"Mounts\": [\r\n {\r\n \"Type\": \"volume\",\r\n \"Name\": \"pastr_pastrdatastore\",\r\n \"Source\": \"\/var\/lib\/docker\/volumes\/pastr_pastrdatastore\/_data\",\r\n \"Destination\": \"\/data\",\r\n \"Driver\": \"local\",\r\n \"Mode\": \"rw\",\r\n \"RW\": true,\r\n \"Propagation\": \"\"\r\n }\r\n ],\r\n<\/pre>\n