{"action":"created","comment":{"url":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments/92075438","pull_request_review_id":12585074,"id":92075438,"diff_hunk":"@@ -1,24 +1,147 @@\n ---\n post_title: Using Pods\n feature_maturity: experimental\n-menu_order: 10\n+menu_order: 20\n ---\n \n-DC/OS handles and represents pods as single services. From the perspective of Marathon, pods are members of [groups](http://mesosphere.github.io/marathon/docs/application-groups.html). Containers in pods share networking namespace and ephemeral volumes.\n+You can create and manage your pods via the DC/OS CLI or via the `/v2/pods/` endpoint of the [Marathon REST API](http://mesosphere.github.io/marathon/docs/generated/api.html).\n \n-You can create and manage pods with the [DC/OS CLI](/docs/1.9/usage/pods/pods-cli/) or via the /v2/pods/ endpoint of the [Marathon REST API](http://mesosphere.github.io/marathon/docs/generated/api.html).\n+# Using the Pods CLI\n \n-# Pod Definitions\n-Pods are configured via a JSON pod definition, which is similar to a [Marathon application definition](http://mesosphere.github.io/marathon/docs/application-basics.html). See the [Examples](/docs/1.9/usage/pods/examples/) section for more information. You must declare the resources required by each container in the pod, even if Mesos is isolating at a higher (pod) level. \n+The following commands are available in the pods CLI:\n \n-**Note:** DC/OS reserves 32 MB and .1 CPUs per pod for overhead. Take this overhead into account when declaring resource needs for the containers in your pod.\n+* `dcos marathon pod add [<pod-resource>]`\n+* `dcos marathon pod list [--json]`\n+* `dcos marathon pod remove [--force] <pod-id>`\n+* `dcos marathon pod show <pod-id>`\n+* `dcos marathon pod update [--force] <pod-id>`\n \n-# Networking\n-Pods only support the [DC/OS Universal containerizer runtime](/docs/1.9/usage/containerizers/), which simplifies networking among containers. The containers of each pod instance share a network namespace and can communicate over localhost. \n+## Add a Pod\n \n-Containers in pods are created with endpoints. Other applications communicate with pods by addressing those endpoints. You can specify a default container network by using the CLI `dcos marathon` command. If you specify a container network without a name in a pod definition, it will be assigned to this default network.\n+To add a pod, first create a JSON pod definition. Then, run the following command:\n+```\n+$ dcos marathon pod add <pod-json-file>\n+```\n \n-In your pod definition you can declare a `host` or `container` network type. Pods created with `host` type share the network namespace of the host. Pods created with `container` type use virtual networking. If you specify the `container` network type, you must also declare a virtual network name in the `name` field. See the [Examples](/docs/1.9/usage/pods/examples/) section for the full JSON.\n+## List Pods\n+List pods and the number of containers they have with the following command:\n+```","path":"1.9/usage/pods/using-pods.md","position":38,"original_position":38,"commit_id":"dbd3ec87084226980c98ca1a5fe61ba58132867b","original_commit_id":"dbd3ec87084226980c98ca1a5fe61ba58132867b","user":{"login":"sascala","id":13338969,"avatar_url":"https://avatars.githubusercontent.com/u/13338969?v=3","gravatar_id":"","url":"https://api.github.com/users/sascala","html_url":"https://github.com/sascala","followers_url":"https://api.github.com/users/sascala/followers","following_url":"https://api.github.com/users/sascala/following{/other_user}","gists_url":"https://api.github.com/users/sascala/gists{/gist_id}","starred_url":"https://api.github.com/users/sascala/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sascala/subscriptions","organizations_url":"https://api.github.com/users/sascala/orgs","repos_url":"https://api.github.com/users/sascala/repos","events_url":"https://api.github.com/users/sascala/events{/privacy}","received_events_url":"https://api.github.com/users/sascala/received_events","type":"User","site_admin":false},"body":"👍 ","created_at":"2016-12-13T00:46:10Z","updated_at":"2016-12-13T00:46:10Z","html_url":"https://github.com/dcos/dcos-docs/pull/782#discussion_r92075438","pull_request_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/782","_links":{"self":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments/92075438"},"html":{"href":"https://github.com/dcos/dcos-docs/pull/782#discussion_r92075438"},"pull_request":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/782"}}},"pull_request":{"url":"https://api.github.com/repos/dcos/dcos-docs/pulls/782","id":97216146,"html_url":"https://github.com/dcos/dcos-docs/pull/782","diff_url":"https://github.com/dcos/dcos-docs/pull/782.diff","patch_url":"https://github.com/dcos/dcos-docs/pull/782.patch","issue_url":"https://api.github.com/repos/dcos/dcos-docs/issues/782","number":782,"state":"open","locked":false,"title":"pods updates","user":{"login":"sascala","id":13338969,"avatar_url":"https://avatars.githubusercontent.com/u/13338969?v=3","gravatar_id":"","url":"https://api.github.com/users/sascala","html_url":"https://github.com/sascala","followers_url":"https://api.github.com/users/sascala/followers","following_url":"https://api.github.com/users/sascala/following{/other_user}","gists_url":"https://api.github.com/users/sascala/gists{/gist_id}","starred_url":"https://api.github.com/users/sascala/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sascala/subscriptions","organizations_url":"https://api.github.com/users/sascala/orgs","repos_url":"https://api.github.com/users/sascala/repos","events_url":"https://api.github.com/users/sascala/events{/privacy}","received_events_url":"https://api.github.com/users/sascala/received_events","type":"User","site_admin":false},"body":"## What are your changes?\r\n\r\n## What type of changes does your doc introduce?\r\n- [X] Bug fix\r\n- [ ] New feature \r\n\r\n## What is the urgency level of this change?\r\n- [ ] Blocker\r\n- [X] High\r\n- [ ] Medium\r\n\r\n## I have completed these items:\r\n- [X] I have tested all commands and code snippets.\r\n- [X] I have built locally and tested for broken links and formatting.\r\n- [X] I have made this change for all affected versions (e.g. 1.7, 1.8, and 1.9).\r\n- [X] My doc follows the style guide: https://github.com/dcos/dcos-docs#contributing.\r\n\r\nPing `@emanic`, `@sascala`, or `@joel-hamill` for reviewing pull request changes.\r\n\r\n\r\n## If you included a comment with your commit, it appears here:\r\n","created_at":"2016-12-08T22:45:30Z","updated_at":"2016-12-13T00:46:10Z","closed_at":null,"merged_at":null,"merge_commit_sha":"877b116d85d62c274062125f8b50df393145c77f","assignee":{"login":"joel-hamill","id":11722533,"avatar_url":"https://avatars.githubusercontent.com/u/11722533?v=3","gravatar_id":"","url":"https://api.github.com/users/joel-hamill","html_url":"https://github.com/joel-hamill","followers_url":"https://api.github.com/users/joel-hamill/followers","following_url":"https://api.github.com/users/joel-hamill/following{/other_user}","gists_url":"https://api.github.com/users/joel-hamill/gists{/gist_id}","starred_url":"https://api.github.com/users/joel-hamill/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/joel-hamill/subscriptions","organizations_url":"https://api.github.com/users/joel-hamill/orgs","repos_url":"https://api.github.com/users/joel-hamill/repos","events_url":"https://api.github.com/users/joel-hamill/events{/privacy}","received_events_url":"https://api.github.com/users/joel-hamill/received_events","type":"User","site_admin":false},"assignees":[{"login":"joel-hamill","id":11722533,"avatar_url":"https://avatars.githubusercontent.com/u/11722533?v=3","gravatar_id":"","url":"https://api.github.com/users/joel-hamill","html_url":"https://github.com/joel-hamill","followers_url":"https://api.github.com/users/joel-hamill/followers","following_url":"https://api.github.com/users/joel-hamill/following{/other_user}","gists_url":"https://api.github.com/users/joel-hamill/gists{/gist_id}","starred_url":"https://api.github.com/users/joel-hamill/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/joel-hamill/subscriptions","organizations_url":"https://api.github.com/users/joel-hamill/orgs","repos_url":"https://api.github.com/users/joel-hamill/repos","events_url":"https://api.github.com/users/joel-hamill/events{/privacy}","received_events_url":"https://api.github.com/users/joel-hamill/received_events","type":"User","site_admin":false}],"milestone":null,"commits_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/782/commits","review_comments_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/782/comments","review_comment_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/issues/782/comments","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/dbd3ec87084226980c98ca1a5fe61ba58132867b","head":{"label":"dcos:ss/pods-updates","ref":"ss/pods-updates","sha":"dbd3ec87084226980c98ca1a5fe61ba58132867b","user":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"repo":{"id":53887483,"name":"dcos-docs","full_name":"dcos/dcos-docs","owner":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dcos/dcos-docs","description":"Documentation for DC/OS","fork":false,"url":"https://api.github.com/repos/dcos/dcos-docs","forks_url":"https://api.github.com/repos/dcos/dcos-docs/forks","keys_url":"https://api.github.com/repos/dcos/dcos-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dcos/dcos-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dcos/dcos-docs/teams","hooks_url":"https://api.github.com/repos/dcos/dcos-docs/hooks","issue_events_url":"https://api.github.com/repos/dcos/dcos-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dcos/dcos-docs/events","assignees_url":"https://api.github.com/repos/dcos/dcos-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dcos/dcos-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dcos/dcos-docs/tags","blobs_url":"https://api.github.com/repos/dcos/dcos-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dcos/dcos-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dcos/dcos-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dcos/dcos-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dcos/dcos-docs/languages","stargazers_url":"https://api.github.com/repos/dcos/dcos-docs/stargazers","contributors_url":"https://api.github.com/repos/dcos/dcos-docs/contributors","subscribers_url":"https://api.github.com/repos/dcos/dcos-docs/subscribers","subscription_url":"https://api.github.com/repos/dcos/dcos-docs/subscription","commits_url":"https://api.github.com/repos/dcos/dcos-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dcos/dcos-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dcos/dcos-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dcos/dcos-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dcos/dcos-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dcos/dcos-docs/merges","archive_url":"https://api.github.com/repos/dcos/dcos-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dcos/dcos-docs/downloads","issues_url":"https://api.github.com/repos/dcos/dcos-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dcos/dcos-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dcos/dcos-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dcos/dcos-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dcos/dcos-docs/labels{/name}","releases_url":"https://api.github.com/repos/dcos/dcos-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dcos/dcos-docs/deployments","created_at":"2016-03-14T19:58:33Z","updated_at":"2016-11-14T16:16:40Z","pushed_at":"2016-12-13T00:26:14Z","git_url":"git://github.com/dcos/dcos-docs.git","ssh_url":"git@github.com:dcos/dcos-docs.git","clone_url":"https://github.com/dcos/dcos-docs.git","svn_url":"https://github.com/dcos/dcos-docs","homepage":"http://dcos.io","size":38484,"stargazers_count":63,"watchers_count":63,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":71,"mirror_url":null,"open_issues_count":28,"forks":71,"open_issues":28,"watchers":63,"default_branch":"master"}},"base":{"label":"dcos:master","ref":"master","sha":"7be23136a8ade3bcbcc3f56ebff11987b0e36b4f","user":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"repo":{"id":53887483,"name":"dcos-docs","full_name":"dcos/dcos-docs","owner":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dcos/dcos-docs","description":"Documentation for DC/OS","fork":false,"url":"https://api.github.com/repos/dcos/dcos-docs","forks_url":"https://api.github.com/repos/dcos/dcos-docs/forks","keys_url":"https://api.github.com/repos/dcos/dcos-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dcos/dcos-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dcos/dcos-docs/teams","hooks_url":"https://api.github.com/repos/dcos/dcos-docs/hooks","issue_events_url":"https://api.github.com/repos/dcos/dcos-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dcos/dcos-docs/events","assignees_url":"https://api.github.com/repos/dcos/dcos-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dcos/dcos-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dcos/dcos-docs/tags","blobs_url":"https://api.github.com/repos/dcos/dcos-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dcos/dcos-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dcos/dcos-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dcos/dcos-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dcos/dcos-docs/languages","stargazers_url":"https://api.github.com/repos/dcos/dcos-docs/stargazers","contributors_url":"https://api.github.com/repos/dcos/dcos-docs/contributors","subscribers_url":"https://api.github.com/repos/dcos/dcos-docs/subscribers","subscription_url":"https://api.github.com/repos/dcos/dcos-docs/subscription","commits_url":"https://api.github.com/repos/dcos/dcos-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dcos/dcos-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dcos/dcos-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dcos/dcos-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dcos/dcos-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dcos/dcos-docs/merges","archive_url":"https://api.github.com/repos/dcos/dcos-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dcos/dcos-docs/downloads","issues_url":"https://api.github.com/repos/dcos/dcos-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dcos/dcos-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dcos/dcos-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dcos/dcos-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dcos/dcos-docs/labels{/name}","releases_url":"https://api.github.com/repos/dcos/dcos-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dcos/dcos-docs/deployments","created_at":"2016-03-14T19:58:33Z","updated_at":"2016-11-14T16:16:40Z","pushed_at":"2016-12-13T00:26:14Z","git_url":"git://github.com/dcos/dcos-docs.git","ssh_url":"git@github.com:dcos/dcos-docs.git","clone_url":"https://github.com/dcos/dcos-docs.git","svn_url":"https://github.com/dcos/dcos-docs","homepage":"http://dcos.io","size":38484,"stargazers_count":63,"watchers_count":63,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":71,"mirror_url":null,"open_issues_count":28,"forks":71,"open_issues":28,"watchers":63,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/782"},"html":{"href":"https://github.com/dcos/dcos-docs/pull/782"},"issue":{"href":"https://api.github.com/repos/dcos/dcos-docs/issues/782"},"comments":{"href":"https://api.github.com/repos/dcos/dcos-docs/issues/782/comments"},"review_comments":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/782/comments"},"review_comment":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/782/commits"},"statuses":{"href":"https://api.github.com/repos/dcos/dcos-docs/statuses/dbd3ec87084226980c98ca1a5fe61ba58132867b"}}}}
{"actor":{"display_login":"sascala"}}