{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker/pulls/comments/54414272","id":54414272,"diff_hunk":"@@ -159,6 +159,44 @@ user with access to host and its mounted directory.\n >should be portable. A host directory wouldn't be available on all potential\n >hosts.\n \n+### Mount a shared-storage volume as a data volume\n+\n+In addition to mounting a host directory to your container, Docker\n+enables [volume plugins](../../extend/plugins_volume.md) which allow\n+provisioning and mounting of an iSCSI, NFS, or FC volumes. The difference\n+with volume plugins is that the data volume is automatically provisioned\n+or made available from externally shared storage and mounted to the \n+Docker host where your container runs.\n+\n+>**Note**: A benefit of using shared volumes is that they are _NOT_ \n+>host-dependent. This means that the volume can be made available to\n+>any host that a container is started on as long as it has access to\n+> the shared storage backend.\n+\n+One way to use volume drivers is through the `docker run` command. \n+Volume drivers create volumes by name, instead of by path like in\n+the other examples.\n+\n+```\n+$ docker run -d --volume-driver=flocker -P --name web -v my-named-volume:/opt/webapp training/webapp python app.py\n+```\n+\n+Here we've mounted a volume named \"my-named-volume\" that was provisioned\n+by a volume driver and made available within the container at `/opt/webapp`.\n+\n+>**Note**: As of Docker 1.9+ you may also use the `docker volume create` command.","path":"docs/userguide/containers/dockervolumes.md","position":29,"original_position":29,"commit_id":"3bdc66c7fb8d8cde381ee5a5a1ddd83f95390185","original_commit_id":"3bdc66c7fb8d8cde381ee5a5a1ddd83f95390185","user":{"login":"thaJeztah","id":1804568,"avatar_url":"https://avatars.githubusercontent.com/u/1804568?v=3","gravatar_id":"","url":"https://api.github.com/users/thaJeztah","html_url":"https://github.com/thaJeztah","followers_url":"https://api.github.com/users/thaJeztah/followers","following_url":"https://api.github.com/users/thaJeztah/following{/other_user}","gists_url":"https://api.github.com/users/thaJeztah/gists{/gist_id}","starred_url":"https://api.github.com/users/thaJeztah/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thaJeztah/subscriptions","organizations_url":"https://api.github.com/users/thaJeztah/orgs","repos_url":"https://api.github.com/users/thaJeztah/repos","events_url":"https://api.github.com/users/thaJeztah/events{/privacy}","received_events_url":"https://api.github.com/users/thaJeztah/received_events","type":"User","site_admin":false},"body":"In general we don't mention which version something is added in (unless really necessary); it's already mentioned in the changelog, and those notes are outdated pretty fast.","created_at":"2016-02-29T14:17:18Z","updated_at":"2016-02-29T14:17:18Z","html_url":"https://github.com/docker/docker/pull/20629#discussion_r54414272","pull_request_url":"https://api.github.com/repos/docker/docker/pulls/20629","_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/54414272"},"html":{"href":"https://github.com/docker/docker/pull/20629#discussion_r54414272"},"pull_request":{"href":"https://api.github.com/repos/docker/docker/pulls/20629"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/20629","id":60408989,"html_url":"https://github.com/docker/docker/pull/20629","diff_url":"https://github.com/docker/docker/pull/20629.diff","patch_url":"https://github.com/docker/docker/pull/20629.patch","issue_url":"https://api.github.com/repos/docker/docker/issues/20629","number":20629,"state":"open","locked":false,"title":"Intro volume drivers in dockervolumes.md","user":{"login":"wallnerryan","id":1072151,"avatar_url":"https://avatars.githubusercontent.com/u/1072151?v=3","gravatar_id":"","url":"https://api.github.com/users/wallnerryan","html_url":"https://github.com/wallnerryan","followers_url":"https://api.github.com/users/wallnerryan/followers","following_url":"https://api.github.com/users/wallnerryan/following{/other_user}","gists_url":"https://api.github.com/users/wallnerryan/gists{/gist_id}","starred_url":"https://api.github.com/users/wallnerryan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wallnerryan/subscriptions","organizations_url":"https://api.github.com/users/wallnerryan/orgs","repos_url":"https://api.github.com/users/wallnerryan/repos","events_url":"https://api.github.com/users/wallnerryan/events{/privacy}","received_events_url":"https://api.github.com/users/wallnerryan/received_events","type":"User","site_admin":false},"body":"`docs/userguide/containers/dockervolumes.md` does a good job at introducing users to volumes but it does not mention volume drivers. This PR introduces just enough information for using volume drivers for data volumes.\r\n<!--\r\nPlease make sure you've read and understood our contributing guidelines;\r\nhttps://github.com/docker/docker/blob/master/CONTRIBUTING.md\r\n\r\n** Make sure all your commits include a signature generated with `git commit -s` **\r\n\r\nFor additional information on our contributing process, read our contributing\r\nguide https://docs.docker.com/opensource/code/\r\n\r\nIf this is a bug fix, make sure your description includes \"fixes #xxxx\", or\r\n\"closes #xxxx\"\r\n-->\r\nSigned-off-by: Ryan Wallner <ryan.wallner@clusterhq.com>","created_at":"2016-02-23T21:01:44Z","updated_at":"2016-02-29T14:17:18Z","closed_at":null,"merged_at":null,"merge_commit_sha":"10c295a598a70f65235ce4916c0729c250a567cd","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker/pulls/20629/commits","review_comments_url":"https://api.github.com/repos/docker/docker/pulls/20629/comments","review_comment_url":"https://api.github.com/repos/docker/docker/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/docker/issues/20629/comments","statuses_url":"https://api.github.com/repos/docker/docker/statuses/3bdc66c7fb8d8cde381ee5a5a1ddd83f95390185","head":{"label":"wallnerryan:intro-volumes","ref":"intro-volumes","sha":"3bdc66c7fb8d8cde381ee5a5a1ddd83f95390185","user":{"login":"wallnerryan","id":1072151,"avatar_url":"https://avatars.githubusercontent.com/u/1072151?v=3","gravatar_id":"","url":"https://api.github.com/users/wallnerryan","html_url":"https://github.com/wallnerryan","followers_url":"https://api.github.com/users/wallnerryan/followers","following_url":"https://api.github.com/users/wallnerryan/following{/other_user}","gists_url":"https://api.github.com/users/wallnerryan/gists{/gist_id}","starred_url":"https://api.github.com/users/wallnerryan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wallnerryan/subscriptions","organizations_url":"https://api.github.com/users/wallnerryan/orgs","repos_url":"https://api.github.com/users/wallnerryan/repos","events_url":"https://api.github.com/users/wallnerryan/events{/privacy}","received_events_url":"https://api.github.com/users/wallnerryan/received_events","type":"User","site_admin":false},"repo":{"id":52384885,"name":"docker","full_name":"wallnerryan/docker","owner":{"login":"wallnerryan","id":1072151,"avatar_url":"https://avatars.githubusercontent.com/u/1072151?v=3","gravatar_id":"","url":"https://api.github.com/users/wallnerryan","html_url":"https://github.com/wallnerryan","followers_url":"https://api.github.com/users/wallnerryan/followers","following_url":"https://api.github.com/users/wallnerryan/following{/other_user}","gists_url":"https://api.github.com/users/wallnerryan/gists{/gist_id}","starred_url":"https://api.github.com/users/wallnerryan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wallnerryan/subscriptions","organizations_url":"https://api.github.com/users/wallnerryan/orgs","repos_url":"https://api.github.com/users/wallnerryan/repos","events_url":"https://api.github.com/users/wallnerryan/events{/privacy}","received_events_url":"https://api.github.com/users/wallnerryan/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/wallnerryan/docker","description":"Docker - the open-source application container engine","fork":true,"url":"https://api.github.com/repos/wallnerryan/docker","forks_url":"https://api.github.com/repos/wallnerryan/docker/forks","keys_url":"https://api.github.com/repos/wallnerryan/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/wallnerryan/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/wallnerryan/docker/teams","hooks_url":"https://api.github.com/repos/wallnerryan/docker/hooks","issue_events_url":"https://api.github.com/repos/wallnerryan/docker/issues/events{/number}","events_url":"https://api.github.com/repos/wallnerryan/docker/events","assignees_url":"https://api.github.com/repos/wallnerryan/docker/assignees{/user}","branches_url":"https://api.github.com/repos/wallnerryan/docker/branches{/branch}","tags_url":"https://api.github.com/repos/wallnerryan/docker/tags","blobs_url":"https://api.github.com/repos/wallnerryan/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/wallnerryan/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/wallnerryan/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/wallnerryan/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/wallnerryan/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/wallnerryan/docker/languages","stargazers_url":"https://api.github.com/repos/wallnerryan/docker/stargazers","contributors_url":"https://api.github.com/repos/wallnerryan/docker/contributors","subscribers_url":"https://api.github.com/repos/wallnerryan/docker/subscribers","subscription_url":"https://api.github.com/repos/wallnerryan/docker/subscription","commits_url":"https://api.github.com/repos/wallnerryan/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/wallnerryan/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/wallnerryan/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/wallnerryan/docker/issues/comments{/number}","contents_url":"https://api.github.com/repos/wallnerryan/docker/contents/{+path}","compare_url":"https://api.github.com/repos/wallnerryan/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/wallnerryan/docker/merges","archive_url":"https://api.github.com/repos/wallnerryan/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/wallnerryan/docker/downloads","issues_url":"https://api.github.com/repos/wallnerryan/docker/issues{/number}","pulls_url":"https://api.github.com/repos/wallnerryan/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/wallnerryan/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/wallnerryan/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/wallnerryan/docker/labels{/name}","releases_url":"https://api.github.com/repos/wallnerryan/docker/releases{/id}","deployments_url":"https://api.github.com/repos/wallnerryan/docker/deployments","created_at":"2016-02-23T19:16:50Z","updated_at":"2016-02-23T19:17:01Z","pushed_at":"2016-02-23T20:59:41Z","git_url":"git://github.com/wallnerryan/docker.git","ssh_url":"git@github.com:wallnerryan/docker.git","clone_url":"https://github.com/wallnerryan/docker.git","svn_url":"https://github.com/wallnerryan/docker","homepage":"http://www.docker.com","size":82249,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"docker:master","ref":"master","sha":"9ec015edff663d16625d18cf0d52644d94f5cec7","user":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"repo":{"id":7691631,"name":"docker","full_name":"docker/docker","owner":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/docker/docker","description":"Docker - the open-source application container engine","fork":false,"url":"https://api.github.com/repos/docker/docker","forks_url":"https://api.github.com/repos/docker/docker/forks","keys_url":"https://api.github.com/repos/docker/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/docker/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/docker/docker/teams","hooks_url":"https://api.github.com/repos/docker/docker/hooks","issue_events_url":"https://api.github.com/repos/docker/docker/issues/events{/number}","events_url":"https://api.github.com/repos/docker/docker/events","assignees_url":"https://api.github.com/repos/docker/docker/assignees{/user}","branches_url":"https://api.github.com/repos/docker/docker/branches{/branch}","tags_url":"https://api.github.com/repos/docker/docker/tags","blobs_url":"https://api.github.com/repos/docker/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/docker/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/docker/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/docker/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/docker/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/docker/docker/languages","stargazers_url":"https://api.github.com/repos/docker/docker/stargazers","contributors_url":"https://api.github.com/repos/docker/docker/contributors","subscribers_url":"https://api.github.com/repos/docker/docker/subscribers","subscription_url":"https://api.github.com/repos/docker/docker/subscription","commits_url":"https://api.github.com/repos/docker/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/docker/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/docker/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/docker/docker/issues/comments{/number}","contents_url":"https://api.github.com/repos/docker/docker/contents/{+path}","compare_url":"https://api.github.com/repos/docker/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/docker/docker/merges","archive_url":"https://api.github.com/repos/docker/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/docker/docker/downloads","issues_url":"https://api.github.com/repos/docker/docker/issues{/number}","pulls_url":"https://api.github.com/repos/docker/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/docker/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/docker/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/docker/docker/labels{/name}","releases_url":"https://api.github.com/repos/docker/docker/releases{/id}","deployments_url":"https://api.github.com/repos/docker/docker/deployments","created_at":"2013-01-18T18:10:57Z","updated_at":"2016-02-29T13:24:35Z","pushed_at":"2016-02-29T14:15:36Z","git_url":"git://github.com/docker/docker.git","ssh_url":"git@github.com:docker/docker.git","clone_url":"https://github.com/docker/docker.git","svn_url":"https://github.com/docker/docker","homepage":"http://www.docker.com","size":137537,"stargazers_count":29038,"watchers_count":29038,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":8127,"mirror_url":null,"open_issues_count":1399,"forks":8127,"open_issues":1399,"watchers":29038,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/20629"},"html":{"href":"https://github.com/docker/docker/pull/20629"},"issue":{"href":"https://api.github.com/repos/docker/docker/issues/20629"},"comments":{"href":"https://api.github.com/repos/docker/docker/issues/20629/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker/pulls/20629/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/docker/pulls/20629/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker/statuses/3bdc66c7fb8d8cde381ee5a5a1ddd83f95390185"}}}}