{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker/pulls/comments/73614234","id":73614234,"diff_hunk":"@@ -0,0 +1,291 @@\n+<!--[metadata]>\n++++\n+title = \"Attach services to an overlay network\"\n+description = \"Use swarm mode networking features\"\n+keywords = [\"guide\", \"swarm mode\", \"swarm\", \"network\"]\n+[menu.main]\n+identifier=\"networking-guide\"\n+parent=\"engine_swarm\"\n+weight=16\n++++\n+<![end-metadata]-->\n+\n+# Attach services to an overlay network\n+\n+Docker Engine swarm mode provides networking features to help you attach services to a user-defined network:\n+\n+* Swarm mode natively supports **overlay networks**, so you can enable\n+container-to-conatiner networks. When you use swarm mode, you don't need an\n+external key-value store.\n+* By default, **service discovery** assigns a virtual IP address and DNS\n+entry to each service in the swarm, making it available by its service name to\n+containers on the same network.\n+* You can configure the service to use DNS round-robin instead of a VIP.\n+\n+In order to use overlay networks in the swarm, you need to have the following\n+ports open before you create the overlay network:\n+\n+* Port `7946` TCP/UDP for container network discovery.\n+* Port `4789` UDP for the container overlay network.\n+\n+## Create an overlay network in a swarm\n+\n+When you run Docker Engine in swarm mode, you can run `docker network create`\n+from a manager node to create an overlay network. For instance, to create a\n+network named `my-network`:\n+\n+```\n+$ docker network create \\\n+  --driver overlay \\\n+  --subnet=10.0.9.0/24 \\\n+  --opt encrypted \\\n+  my-network\n+\n+273d53261bcdfda5f198587974dae3827e947ccd7e74a41bf1f482ad17fa0d33\n+```\n+\n+The `--opt encrypted` flag is optional. It configures the overlay driver to\n+encrypt vxlan traffic between the nodes.","path":"docs/swarm/networking.md","position":48,"original_position":48,"commit_id":"5d785da5dff078d80cc496bcd5cb7e7f10a6b376","original_commit_id":"5d785da5dff078d80cc496bcd5cb7e7f10a6b376","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":"Haven't had time yet to catch up on our networking deep-dive part 2, but *without* `--opt encrypted`, can someone \"snoop\" the network traffic? I think it would be good to add slightly more information; this is something people will ask (\"why is it not the default\"? \"should I enable this\"? \"is it secure out of the box\"?)","created_at":"2016-08-04T22:31:01Z","updated_at":"2016-08-04T22:31:01Z","html_url":"https://github.com/docker/docker/pull/25420#discussion_r73614234","pull_request_url":"https://api.github.com/repos/docker/docker/pulls/25420","_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/73614234"},"html":{"href":"https://github.com/docker/docker/pull/25420#discussion_r73614234"},"pull_request":{"href":"https://api.github.com/repos/docker/docker/pulls/25420"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/25420","id":80144895,"html_url":"https://github.com/docker/docker/pull/25420","diff_url":"https://github.com/docker/docker/pull/25420.diff","patch_url":"https://github.com/docker/docker/pull/25420.patch","issue_url":"https://api.github.com/repos/docker/docker/issues/25420","number":25420,"state":"open","locked":false,"title":"add overlay networking guide","user":{"login":"sfsmithcha","id":2415653,"avatar_url":"https://avatars.githubusercontent.com/u/2415653?v=3","gravatar_id":"","url":"https://api.github.com/users/sfsmithcha","html_url":"https://github.com/sfsmithcha","followers_url":"https://api.github.com/users/sfsmithcha/followers","following_url":"https://api.github.com/users/sfsmithcha/following{/other_user}","gists_url":"https://api.github.com/users/sfsmithcha/gists{/gist_id}","starred_url":"https://api.github.com/users/sfsmithcha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sfsmithcha/subscriptions","organizations_url":"https://api.github.com/users/sfsmithcha/orgs","repos_url":"https://api.github.com/users/sfsmithcha/repos","events_url":"https://api.github.com/users/sfsmithcha/events{/privacy}","received_events_url":"https://api.github.com/users/sfsmithcha/received_events","type":"User","site_admin":false},"body":"**- What I did**\r\nAdd overlay networking guide to `manage a swarm` guide\r\n**- How I did it**\r\nadded networking.md\r\n**- How to verify it**\r\nread networking.md for accuracy/correctness\r\n\r\nSigned-off-by: Charles Smith <charles.smith@docker.com>","created_at":"2016-08-04T20:33:28Z","updated_at":"2016-08-04T22:31:01Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b9bad6f43fa882fe566feaf6b715fc8a02ab5be4","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker/pulls/25420/commits","review_comments_url":"https://api.github.com/repos/docker/docker/pulls/25420/comments","review_comment_url":"https://api.github.com/repos/docker/docker/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/docker/issues/25420/comments","statuses_url":"https://api.github.com/repos/docker/docker/statuses/5d785da5dff078d80cc496bcd5cb7e7f10a6b376","head":{"label":"sfsmithcha:add_networking_guide","ref":"add_networking_guide","sha":"5d785da5dff078d80cc496bcd5cb7e7f10a6b376","user":{"login":"sfsmithcha","id":2415653,"avatar_url":"https://avatars.githubusercontent.com/u/2415653?v=3","gravatar_id":"","url":"https://api.github.com/users/sfsmithcha","html_url":"https://github.com/sfsmithcha","followers_url":"https://api.github.com/users/sfsmithcha/followers","following_url":"https://api.github.com/users/sfsmithcha/following{/other_user}","gists_url":"https://api.github.com/users/sfsmithcha/gists{/gist_id}","starred_url":"https://api.github.com/users/sfsmithcha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sfsmithcha/subscriptions","organizations_url":"https://api.github.com/users/sfsmithcha/orgs","repos_url":"https://api.github.com/users/sfsmithcha/repos","events_url":"https://api.github.com/users/sfsmithcha/events{/privacy}","received_events_url":"https://api.github.com/users/sfsmithcha/received_events","type":"User","site_admin":false},"repo":{"id":55171255,"name":"docker","full_name":"sfsmithcha/docker","owner":{"login":"sfsmithcha","id":2415653,"avatar_url":"https://avatars.githubusercontent.com/u/2415653?v=3","gravatar_id":"","url":"https://api.github.com/users/sfsmithcha","html_url":"https://github.com/sfsmithcha","followers_url":"https://api.github.com/users/sfsmithcha/followers","following_url":"https://api.github.com/users/sfsmithcha/following{/other_user}","gists_url":"https://api.github.com/users/sfsmithcha/gists{/gist_id}","starred_url":"https://api.github.com/users/sfsmithcha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sfsmithcha/subscriptions","organizations_url":"https://api.github.com/users/sfsmithcha/orgs","repos_url":"https://api.github.com/users/sfsmithcha/repos","events_url":"https://api.github.com/users/sfsmithcha/events{/privacy}","received_events_url":"https://api.github.com/users/sfsmithcha/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/sfsmithcha/docker","description":"Docker - the open-source application container engine","fork":true,"url":"https://api.github.com/repos/sfsmithcha/docker","forks_url":"https://api.github.com/repos/sfsmithcha/docker/forks","keys_url":"https://api.github.com/repos/sfsmithcha/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/sfsmithcha/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/sfsmithcha/docker/teams","hooks_url":"https://api.github.com/repos/sfsmithcha/docker/hooks","issue_events_url":"https://api.github.com/repos/sfsmithcha/docker/issues/events{/number}","events_url":"https://api.github.com/repos/sfsmithcha/docker/events","assignees_url":"https://api.github.com/repos/sfsmithcha/docker/assignees{/user}","branches_url":"https://api.github.com/repos/sfsmithcha/docker/branches{/branch}","tags_url":"https://api.github.com/repos/sfsmithcha/docker/tags","blobs_url":"https://api.github.com/repos/sfsmithcha/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/sfsmithcha/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/sfsmithcha/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/sfsmithcha/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/sfsmithcha/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/sfsmithcha/docker/languages","stargazers_url":"https://api.github.com/repos/sfsmithcha/docker/stargazers","contributors_url":"https://api.github.com/repos/sfsmithcha/docker/contributors","subscribers_url":"https://api.github.com/repos/sfsmithcha/docker/subscribers","subscription_url":"https://api.github.com/repos/sfsmithcha/docker/subscription","commits_url":"https://api.github.com/repos/sfsmithcha/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/sfsmithcha/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/sfsmithcha/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/sfsmithcha/docker/issues/comments{/number}","contents_url":"https://api.github.com/repos/sfsmithcha/docker/contents/{+path}","compare_url":"https://api.github.com/repos/sfsmithcha/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/sfsmithcha/docker/merges","archive_url":"https://api.github.com/repos/sfsmithcha/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/sfsmithcha/docker/downloads","issues_url":"https://api.github.com/repos/sfsmithcha/docker/issues{/number}","pulls_url":"https://api.github.com/repos/sfsmithcha/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/sfsmithcha/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/sfsmithcha/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/sfsmithcha/docker/labels{/name}","releases_url":"https://api.github.com/repos/sfsmithcha/docker/releases{/id}","deployments_url":"https://api.github.com/repos/sfsmithcha/docker/deployments","created_at":"2016-03-31T17:50:02Z","updated_at":"2016-03-31T17:50:14Z","pushed_at":"2016-08-04T22:29:57Z","git_url":"git://github.com/sfsmithcha/docker.git","ssh_url":"git@github.com:sfsmithcha/docker.git","clone_url":"https://github.com/sfsmithcha/docker.git","svn_url":"https://github.com/sfsmithcha/docker","homepage":"http://www.docker.com","size":96895,"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":"979d48bbf58599ecf236984463ae94ee59ba3b47","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-08-04T21:48:29Z","pushed_at":"2016-08-04T22:29:58Z","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":204325,"stargazers_count":33750,"watchers_count":33750,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":9808,"mirror_url":null,"open_issues_count":2101,"forks":9808,"open_issues":2101,"watchers":33750,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/25420"},"html":{"href":"https://github.com/docker/docker/pull/25420"},"issue":{"href":"https://api.github.com/repos/docker/docker/issues/25420"},"comments":{"href":"https://api.github.com/repos/docker/docker/issues/25420/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker/pulls/25420/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/docker/pulls/25420/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker/statuses/5d785da5dff078d80cc496bcd5cb7e7f10a6b376"}}}}
{"actor":{"display_login":"thaJeztah"}}