{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker/pulls/comments/43585718","id":43585718,"diff_hunk":"@@ -0,0 +1,454 @@\n+<!--[metadata]>\n++++\n+title = \"Work with network commands\"\n+description = \"How do we connect docker containers within and across hosts ?\"\n+keywords = [\"commands, Usage, network, docker, cluster\"]\n+[menu.main]\n+parent = \"smn_networking\"\n+weight=-4\n++++\n+<![end-metadata]-->\n+\n+# Work with network commands\n+\n+This article provides examples of the network subcommands you can use to interact with Docker networks and the containers in them. The commands are available through the Docker Engine CLI.  These commands are:\n+\n+* `docker network create`\n+* `docker network connect`\n+* `docker network ls`\n+* `docker network rm`\n+* `docker network disconnect`\n+* `docker network inspect`\n+\n+While not required, it is a good idea to read [Understanding Docker\n+network](dockernetworks.md) before trying the examples in this section. The\n+examples for the rely on a `bridge` network so that you can try them\n+immediately.  If you would prefer to experiment with an `overlay` network see\n+the [Getting started with multi-host networks](get-started-overlay.md) instead.\n+\n+## Create networks\n+\n+When you install Docker Engine it creates a `bridge` network automatically.\n+This network corresponds to the `docker0` bridge that Engine has traditionally\n+relied on. In addition to this network, you can create your own `bridge` or `overlay` network.  \n+\n+A `bridge` network resides on a single host running an instance of Docker Engine.  An `overlay` network can span multiple hosts running their own engines. If you run `docker network creat`e and supply only a network name, it creates a bridge network for you.\n+\n+```bash\n+$ docker network create simple-network\n+de792b8258895cf5dc3b43835e9d61a9803500b991654dacb1f4f0546b1c88f8\n+$ docker network inspect simple-network\n+[\n+    {\n+        \"Name\": \"simple-network\",\n+        \"Id\": \"de792b8258895cf5dc3b43835e9d61a9803500b991654dacb1f4f0546b1c88f8\",\n+        \"Scope\": \"local\",\n+        \"Driver\": \"bridge\",\n+        \"IPAM\": {\n+            \"Driver\": \"default\",\n+            \"Config\": [\n+                {}\n+            ]\n+        },\n+        \"Containers\": {},\n+        \"Options\": {}\n+    }\n+]\n+```\n+\n+Unlike `bridge` networks `overlay` networks require some pre-existing conditions\n+before you can create one. These conditions are:\n+\n+* Access to a key-value store. Engine supports Consul Etcd, and Zookeeper (Distributed store) key-value stores.\n+* A cluster of hosts with connectivity to the key-value store.\n+* A properly configured Engine `daemon` on each host in the cluster.\n+\n+The `docker daemon` options that support the `overlay` network are:\n+\n+* `--cluster-store`\n+* `--cluster-store-opt`\n+* `--cluster-advertise`\n+\n+It is also a good idea, though not required, that you install Docker Swarm on","path":"docs/userguide/networking/work-with-networks.md","position":72,"original_position":72,"commit_id":"7d4751da3caa22984e10600378a3a216860a4ceb","original_commit_id":"7d4751da3caa22984e10600378a3a216860a4ceb","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":"stray \"on\" after Swarm\r\n\r\n(Think this document is also still \"draft\"?)","created_at":"2015-11-01T18:39:58Z","updated_at":"2015-11-01T18:39:58Z","html_url":"https://github.com/docker/docker/pull/17340#discussion_r43585718","pull_request_url":"https://api.github.com/repos/docker/docker/pulls/17340","_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/43585718"},"html":{"href":"https://github.com/docker/docker/pull/17340#discussion_r43585718"},"pull_request":{"href":"https://api.github.com/repos/docker/docker/pulls/17340"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/17340","id":48669896,"html_url":"https://github.com/docker/docker/pull/17340","diff_url":"https://github.com/docker/docker/pull/17340.diff","patch_url":"https://github.com/docker/docker/pull/17340.patch","issue_url":"https://api.github.com/repos/docker/docker/issues/17340","number":17340,"state":"open","locked":false,"title":"Network docs for release","user":{"login":"moxiegirl","id":1347209,"avatar_url":"https://avatars.githubusercontent.com/u/1347209?v=3","gravatar_id":"","url":"https://api.github.com/users/moxiegirl","html_url":"https://github.com/moxiegirl","followers_url":"https://api.github.com/users/moxiegirl/followers","following_url":"https://api.github.com/users/moxiegirl/following{/other_user}","gists_url":"https://api.github.com/users/moxiegirl/gists{/gist_id}","starred_url":"https://api.github.com/users/moxiegirl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/moxiegirl/subscriptions","organizations_url":"https://api.github.com/users/moxiegirl/orgs","repos_url":"https://api.github.com/users/moxiegirl/repos","events_url":"https://api.github.com/users/moxiegirl/events{/privacy}","received_events_url":"https://api.github.com/users/moxiegirl/received_events","type":"User","site_admin":false},"body":"Removing old networking.md\r\nUpdating dockernetworks.md with images\r\nAdding information on network plugins\r\nAdding blurb about links to docker networking\r\nUpdating the working documentation\r\nAdding Overlay Getting Started\r\nDownplaying links by removing refs/examples, adding refs/examples for network.\r\nUpdating getting started to reflect networks not links\r\n\r\nSigned-off-by: Mary Anthony <mary@docker.com>","created_at":"2015-10-25T02:04:08Z","updated_at":"2015-11-01T18:39:58Z","closed_at":null,"merged_at":null,"merge_commit_sha":"0c07de5f8999bf744d1fa7d03c50234fde742576","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker/pulls/17340/commits","review_comments_url":"https://api.github.com/repos/docker/docker/pulls/17340/comments","review_comment_url":"https://api.github.com/repos/docker/docker/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/docker/issues/17340/comments","statuses_url":"https://api.github.com/repos/docker/docker/statuses/7d4751da3caa22984e10600378a3a216860a4ceb","head":{"label":"moxiegirl:new-networking-docs","ref":"new-networking-docs","sha":"7d4751da3caa22984e10600378a3a216860a4ceb","user":{"login":"moxiegirl","id":1347209,"avatar_url":"https://avatars.githubusercontent.com/u/1347209?v=3","gravatar_id":"","url":"https://api.github.com/users/moxiegirl","html_url":"https://github.com/moxiegirl","followers_url":"https://api.github.com/users/moxiegirl/followers","following_url":"https://api.github.com/users/moxiegirl/following{/other_user}","gists_url":"https://api.github.com/users/moxiegirl/gists{/gist_id}","starred_url":"https://api.github.com/users/moxiegirl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/moxiegirl/subscriptions","organizations_url":"https://api.github.com/users/moxiegirl/orgs","repos_url":"https://api.github.com/users/moxiegirl/repos","events_url":"https://api.github.com/users/moxiegirl/events{/privacy}","received_events_url":"https://api.github.com/users/moxiegirl/received_events","type":"User","site_admin":false},"repo":{"id":38079763,"name":"docker","full_name":"moxiegirl/docker","owner":{"login":"moxiegirl","id":1347209,"avatar_url":"https://avatars.githubusercontent.com/u/1347209?v=3","gravatar_id":"","url":"https://api.github.com/users/moxiegirl","html_url":"https://github.com/moxiegirl","followers_url":"https://api.github.com/users/moxiegirl/followers","following_url":"https://api.github.com/users/moxiegirl/following{/other_user}","gists_url":"https://api.github.com/users/moxiegirl/gists{/gist_id}","starred_url":"https://api.github.com/users/moxiegirl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/moxiegirl/subscriptions","organizations_url":"https://api.github.com/users/moxiegirl/orgs","repos_url":"https://api.github.com/users/moxiegirl/repos","events_url":"https://api.github.com/users/moxiegirl/events{/privacy}","received_events_url":"https://api.github.com/users/moxiegirl/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/moxiegirl/docker","description":"Docker - the open-source application container engine","fork":true,"url":"https://api.github.com/repos/moxiegirl/docker","forks_url":"https://api.github.com/repos/moxiegirl/docker/forks","keys_url":"https://api.github.com/repos/moxiegirl/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/moxiegirl/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/moxiegirl/docker/teams","hooks_url":"https://api.github.com/repos/moxiegirl/docker/hooks","issue_events_url":"https://api.github.com/repos/moxiegirl/docker/issues/events{/number}","events_url":"https://api.github.com/repos/moxiegirl/docker/events","assignees_url":"https://api.github.com/repos/moxiegirl/docker/assignees{/user}","branches_url":"https://api.github.com/repos/moxiegirl/docker/branches{/branch}","tags_url":"https://api.github.com/repos/moxiegirl/docker/tags","blobs_url":"https://api.github.com/repos/moxiegirl/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/moxiegirl/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/moxiegirl/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/moxiegirl/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/moxiegirl/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/moxiegirl/docker/languages","stargazers_url":"https://api.github.com/repos/moxiegirl/docker/stargazers","contributors_url":"https://api.github.com/repos/moxiegirl/docker/contributors","subscribers_url":"https://api.github.com/repos/moxiegirl/docker/subscribers","subscription_url":"https://api.github.com/repos/moxiegirl/docker/subscription","commits_url":"https://api.github.com/repos/moxiegirl/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/moxiegirl/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/moxiegirl/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/moxiegirl/docker/issues/comments{/number}","contents_url":"https://api.github.com/repos/moxiegirl/docker/contents/{+path}","compare_url":"https://api.github.com/repos/moxiegirl/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/moxiegirl/docker/merges","archive_url":"https://api.github.com/repos/moxiegirl/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/moxiegirl/docker/downloads","issues_url":"https://api.github.com/repos/moxiegirl/docker/issues{/number}","pulls_url":"https://api.github.com/repos/moxiegirl/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/moxiegirl/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/moxiegirl/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/moxiegirl/docker/labels{/name}","releases_url":"https://api.github.com/repos/moxiegirl/docker/releases{/id}","created_at":"2015-06-25T23:27:51Z","updated_at":"2015-06-25T23:27:58Z","pushed_at":"2015-11-01T16:22:34Z","git_url":"git://github.com/moxiegirl/docker.git","ssh_url":"git@github.com:moxiegirl/docker.git","clone_url":"https://github.com/moxiegirl/docker.git","svn_url":"https://github.com/moxiegirl/docker","homepage":"http://www.docker.com","size":73387,"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":1,"forks":0,"open_issues":1,"watchers":0,"default_branch":"master"}},"base":{"label":"docker:master","ref":"master","sha":"4468e1e74e225f38b251fbcfdce633b619ea2e7a","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}","created_at":"2013-01-18T18:10:57Z","updated_at":"2015-11-01T18:01:31Z","pushed_at":"2015-11-01T18:37:52Z","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":279176,"stargazers_count":25831,"watchers_count":25831,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":6889,"mirror_url":null,"open_issues_count":1190,"forks":6889,"open_issues":1190,"watchers":25831,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/17340"},"html":{"href":"https://github.com/docker/docker/pull/17340"},"issue":{"href":"https://api.github.com/repos/docker/docker/issues/17340"},"comments":{"href":"https://api.github.com/repos/docker/docker/issues/17340/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker/pulls/17340/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/docker/pulls/17340/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker/statuses/7d4751da3caa22984e10600378a3a216860a4ceb"}}}}