{"action":"created","comment":{"url":"https://api.github.com/repos/habitat-sh/habitat/pulls/comments/66921152","id":66921152,"diff_hunk":"@@ -0,0 +1,27 @@\n+---\n+title: Kubernetes with Habitat\n+---\n+\n+[Kubernetes](http://kubernetes.io/) is an open source container cluster manager that is available as a stand-alone platform or embedded in several distributed platforms including [Google's Container Engine](https://cloud.google.com/container-engine/) and [Tectonic](https://tectonic.com/) by [CoreOS](https://coreos.com/). Habitat and Kubernetes are complementary, Kubernetes focuses on providing a platform for deployment, scaling, and operations of application containers across clusters of hosts while Habitat manages the creation and configuration of those application containers.\n+\n+## Docker and ACI\n+\n+Habitat packages are supported in both Docker and ACI formats. Kubernetes currently supports the Docker runtime and integration of the rkt container runtime (an implementation of the App Container spec) is under active development.\n+\n+## kubectl\n+\n+Habitat packages exported as containers may be deployed into Kubernetes through the [`kubectl` command](http://kubernetes.io/docs/user-guide/pods/single-container/). Using the [Docker exporter](/docs/run-packages-export) to create a containerized application, the container may be launched like this example:\n+\n+       kubectl run mytutorial --image=myorigin/mytutorial --port=8080\n+\n+Assuming the Docker image is pulled from `myorigin/mytutorial` we are exposing port 8080 on the container for access. Networking ports exposed by Habitat need to be passed to `kubectl run` as `--port` options. We can see our deployment with the `kubectl get` command:\n+\n+       kubectl get pods -l run=mytutorial\n+\n+## Environment variables and Networking\n+\n+Kubernetes supports passing [environment variables](http://kubernetes.io/docs/user-guide/environment-guide/) into containers, this needs to be documented for use with Habitat.\n+\n+## Multi-container Pods\n+\n+Multi-container pod support through Habitat is still under active development, there may need to be a generated configuration file output from a CLI. Habitat's gossip protocol is on port 9634 and transmitted via UDP, it needs to be available by default to all of the containers in the pod.","path":"www/source/docs/kubernetes.html.md","position":null,"original_position":27,"commit_id":"ed42e0b93485e0b9f6bea94d5a375048c16be15e","original_commit_id":"174d884c025180d15a8247d7b1b06ae75ee8f4e5","user":{"login":"mattray","id":330023,"avatar_url":"https://avatars.githubusercontent.com/u/330023?v=3","gravatar_id":"","url":"https://api.github.com/users/mattray","html_url":"https://github.com/mattray","followers_url":"https://api.github.com/users/mattray/followers","following_url":"https://api.github.com/users/mattray/following{/other_user}","gists_url":"https://api.github.com/users/mattray/gists{/gist_id}","starred_url":"https://api.github.com/users/mattray/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattray/subscriptions","organizations_url":"https://api.github.com/users/mattray/orgs","repos_url":"https://api.github.com/users/mattray/repos","events_url":"https://api.github.com/users/mattray/events{/privacy}","received_events_url":"https://api.github.com/users/mattray/received_events","type":"User","site_admin":false},"body":"fixed\r\n","created_at":"2016-06-14T07:34:23Z","updated_at":"2016-06-14T07:34:23Z","html_url":"https://github.com/habitat-sh/habitat/pull/827#discussion_r66921152","pull_request_url":"https://api.github.com/repos/habitat-sh/habitat/pulls/827","_links":{"self":{"href":"https://api.github.com/repos/habitat-sh/habitat/pulls/comments/66921152"},"html":{"href":"https://github.com/habitat-sh/habitat/pull/827#discussion_r66921152"},"pull_request":{"href":"https://api.github.com/repos/habitat-sh/habitat/pulls/827"}}},"pull_request":{"url":"https://api.github.com/repos/habitat-sh/habitat/pulls/827","id":73690415,"html_url":"https://github.com/habitat-sh/habitat/pull/827","diff_url":"https://github.com/habitat-sh/habitat/pull/827.diff","patch_url":"https://github.com/habitat-sh/habitat/pull/827.patch","issue_url":"https://api.github.com/repos/habitat-sh/habitat/issues/827","number":827,"state":"open","locked":false,"title":"Document support for container cluster managers Mesos and Kubernetes.","user":{"login":"mattray","id":330023,"avatar_url":"https://avatars.githubusercontent.com/u/330023?v=3","gravatar_id":"","url":"https://api.github.com/users/mattray","html_url":"https://github.com/mattray","followers_url":"https://api.github.com/users/mattray/followers","following_url":"https://api.github.com/users/mattray/following{/other_user}","gists_url":"https://api.github.com/users/mattray/gists{/gist_id}","starred_url":"https://api.github.com/users/mattray/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattray/subscriptions","organizations_url":"https://api.github.com/users/mattray/orgs","repos_url":"https://api.github.com/users/mattray/repos","events_url":"https://api.github.com/users/mattray/events{/privacy}","received_events_url":"https://api.github.com/users/mattray/received_events","type":"User","site_admin":false},"body":"Initial documentation for working with both.","created_at":"2016-06-14T07:13:41Z","updated_at":"2016-06-14T07:34:23Z","closed_at":null,"merged_at":null,"merge_commit_sha":"8e23e23fac504a58ff285792fb4158f04a55045a","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/habitat-sh/habitat/pulls/827/commits","review_comments_url":"https://api.github.com/repos/habitat-sh/habitat/pulls/827/comments","review_comment_url":"https://api.github.com/repos/habitat-sh/habitat/pulls/comments{/number}","comments_url":"https://api.github.com/repos/habitat-sh/habitat/issues/827/comments","statuses_url":"https://api.github.com/repos/habitat-sh/habitat/statuses/ed42e0b93485e0b9f6bea94d5a375048c16be15e","head":{"label":"mattray:mesosize-docs","ref":"mesosize-docs","sha":"ed42e0b93485e0b9f6bea94d5a375048c16be15e","user":{"login":"mattray","id":330023,"avatar_url":"https://avatars.githubusercontent.com/u/330023?v=3","gravatar_id":"","url":"https://api.github.com/users/mattray","html_url":"https://github.com/mattray","followers_url":"https://api.github.com/users/mattray/followers","following_url":"https://api.github.com/users/mattray/following{/other_user}","gists_url":"https://api.github.com/users/mattray/gists{/gist_id}","starred_url":"https://api.github.com/users/mattray/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattray/subscriptions","organizations_url":"https://api.github.com/users/mattray/orgs","repos_url":"https://api.github.com/users/mattray/repos","events_url":"https://api.github.com/users/mattray/events{/privacy}","received_events_url":"https://api.github.com/users/mattray/received_events","type":"User","site_admin":false},"repo":{"id":61100389,"name":"habitat","full_name":"mattray/habitat","owner":{"login":"mattray","id":330023,"avatar_url":"https://avatars.githubusercontent.com/u/330023?v=3","gravatar_id":"","url":"https://api.github.com/users/mattray","html_url":"https://github.com/mattray","followers_url":"https://api.github.com/users/mattray/followers","following_url":"https://api.github.com/users/mattray/following{/other_user}","gists_url":"https://api.github.com/users/mattray/gists{/gist_id}","starred_url":"https://api.github.com/users/mattray/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattray/subscriptions","organizations_url":"https://api.github.com/users/mattray/orgs","repos_url":"https://api.github.com/users/mattray/repos","events_url":"https://api.github.com/users/mattray/events{/privacy}","received_events_url":"https://api.github.com/users/mattray/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/mattray/habitat","description":"Modern applications with built-in automation","fork":true,"url":"https://api.github.com/repos/mattray/habitat","forks_url":"https://api.github.com/repos/mattray/habitat/forks","keys_url":"https://api.github.com/repos/mattray/habitat/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mattray/habitat/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mattray/habitat/teams","hooks_url":"https://api.github.com/repos/mattray/habitat/hooks","issue_events_url":"https://api.github.com/repos/mattray/habitat/issues/events{/number}","events_url":"https://api.github.com/repos/mattray/habitat/events","assignees_url":"https://api.github.com/repos/mattray/habitat/assignees{/user}","branches_url":"https://api.github.com/repos/mattray/habitat/branches{/branch}","tags_url":"https://api.github.com/repos/mattray/habitat/tags","blobs_url":"https://api.github.com/repos/mattray/habitat/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mattray/habitat/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mattray/habitat/git/refs{/sha}","trees_url":"https://api.github.com/repos/mattray/habitat/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mattray/habitat/statuses/{sha}","languages_url":"https://api.github.com/repos/mattray/habitat/languages","stargazers_url":"https://api.github.com/repos/mattray/habitat/stargazers","contributors_url":"https://api.github.com/repos/mattray/habitat/contributors","subscribers_url":"https://api.github.com/repos/mattray/habitat/subscribers","subscription_url":"https://api.github.com/repos/mattray/habitat/subscription","commits_url":"https://api.github.com/repos/mattray/habitat/commits{/sha}","git_commits_url":"https://api.github.com/repos/mattray/habitat/git/commits{/sha}","comments_url":"https://api.github.com/repos/mattray/habitat/comments{/number}","issue_comment_url":"https://api.github.com/repos/mattray/habitat/issues/comments{/number}","contents_url":"https://api.github.com/repos/mattray/habitat/contents/{+path}","compare_url":"https://api.github.com/repos/mattray/habitat/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mattray/habitat/merges","archive_url":"https://api.github.com/repos/mattray/habitat/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mattray/habitat/downloads","issues_url":"https://api.github.com/repos/mattray/habitat/issues{/number}","pulls_url":"https://api.github.com/repos/mattray/habitat/pulls{/number}","milestones_url":"https://api.github.com/repos/mattray/habitat/milestones{/number}","notifications_url":"https://api.github.com/repos/mattray/habitat/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mattray/habitat/labels{/name}","releases_url":"https://api.github.com/repos/mattray/habitat/releases{/id}","deployments_url":"https://api.github.com/repos/mattray/habitat/deployments","created_at":"2016-06-14T07:12:21Z","updated_at":"2016-06-14T07:12:24Z","pushed_at":"2016-06-14T07:34:20Z","git_url":"git://github.com/mattray/habitat.git","ssh_url":"git@github.com:mattray/habitat.git","clone_url":"https://github.com/mattray/habitat.git","svn_url":"https://github.com/mattray/habitat","homepage":"https://www.habitat.sh","size":33862,"stargazers_count":0,"watchers_count":0,"language":"Rust","has_issues":false,"has_downloads":true,"has_wiki":false,"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":"habitat-sh:master","ref":"master","sha":"2078d105b63c6ac2c505bf6ea765b450cf8c701c","user":{"login":"habitat-sh","id":18171698,"avatar_url":"https://avatars.githubusercontent.com/u/18171698?v=3","gravatar_id":"","url":"https://api.github.com/users/habitat-sh","html_url":"https://github.com/habitat-sh","followers_url":"https://api.github.com/users/habitat-sh/followers","following_url":"https://api.github.com/users/habitat-sh/following{/other_user}","gists_url":"https://api.github.com/users/habitat-sh/gists{/gist_id}","starred_url":"https://api.github.com/users/habitat-sh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/habitat-sh/subscriptions","organizations_url":"https://api.github.com/users/habitat-sh/orgs","repos_url":"https://api.github.com/users/habitat-sh/repos","events_url":"https://api.github.com/users/habitat-sh/events{/privacy}","received_events_url":"https://api.github.com/users/habitat-sh/received_events","type":"Organization","site_admin":false},"repo":{"id":36098429,"name":"habitat","full_name":"habitat-sh/habitat","owner":{"login":"habitat-sh","id":18171698,"avatar_url":"https://avatars.githubusercontent.com/u/18171698?v=3","gravatar_id":"","url":"https://api.github.com/users/habitat-sh","html_url":"https://github.com/habitat-sh","followers_url":"https://api.github.com/users/habitat-sh/followers","following_url":"https://api.github.com/users/habitat-sh/following{/other_user}","gists_url":"https://api.github.com/users/habitat-sh/gists{/gist_id}","starred_url":"https://api.github.com/users/habitat-sh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/habitat-sh/subscriptions","organizations_url":"https://api.github.com/users/habitat-sh/orgs","repos_url":"https://api.github.com/users/habitat-sh/repos","events_url":"https://api.github.com/users/habitat-sh/events{/privacy}","received_events_url":"https://api.github.com/users/habitat-sh/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/habitat-sh/habitat","description":"Modern applications with built-in automation","fork":false,"url":"https://api.github.com/repos/habitat-sh/habitat","forks_url":"https://api.github.com/repos/habitat-sh/habitat/forks","keys_url":"https://api.github.com/repos/habitat-sh/habitat/keys{/key_id}","collaborators_url":"https://api.github.com/repos/habitat-sh/habitat/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/habitat-sh/habitat/teams","hooks_url":"https://api.github.com/repos/habitat-sh/habitat/hooks","issue_events_url":"https://api.github.com/repos/habitat-sh/habitat/issues/events{/number}","events_url":"https://api.github.com/repos/habitat-sh/habitat/events","assignees_url":"https://api.github.com/repos/habitat-sh/habitat/assignees{/user}","branches_url":"https://api.github.com/repos/habitat-sh/habitat/branches{/branch}","tags_url":"https://api.github.com/repos/habitat-sh/habitat/tags","blobs_url":"https://api.github.com/repos/habitat-sh/habitat/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/habitat-sh/habitat/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/habitat-sh/habitat/git/refs{/sha}","trees_url":"https://api.github.com/repos/habitat-sh/habitat/git/trees{/sha}","statuses_url":"https://api.github.com/repos/habitat-sh/habitat/statuses/{sha}","languages_url":"https://api.github.com/repos/habitat-sh/habitat/languages","stargazers_url":"https://api.github.com/repos/habitat-sh/habitat/stargazers","contributors_url":"https://api.github.com/repos/habitat-sh/habitat/contributors","subscribers_url":"https://api.github.com/repos/habitat-sh/habitat/subscribers","subscription_url":"https://api.github.com/repos/habitat-sh/habitat/subscription","commits_url":"https://api.github.com/repos/habitat-sh/habitat/commits{/sha}","git_commits_url":"https://api.github.com/repos/habitat-sh/habitat/git/commits{/sha}","comments_url":"https://api.github.com/repos/habitat-sh/habitat/comments{/number}","issue_comment_url":"https://api.github.com/repos/habitat-sh/habitat/issues/comments{/number}","contents_url":"https://api.github.com/repos/habitat-sh/habitat/contents/{+path}","compare_url":"https://api.github.com/repos/habitat-sh/habitat/compare/{base}...{head}","merges_url":"https://api.github.com/repos/habitat-sh/habitat/merges","archive_url":"https://api.github.com/repos/habitat-sh/habitat/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/habitat-sh/habitat/downloads","issues_url":"https://api.github.com/repos/habitat-sh/habitat/issues{/number}","pulls_url":"https://api.github.com/repos/habitat-sh/habitat/pulls{/number}","milestones_url":"https://api.github.com/repos/habitat-sh/habitat/milestones{/number}","notifications_url":"https://api.github.com/repos/habitat-sh/habitat/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/habitat-sh/habitat/labels{/name}","releases_url":"https://api.github.com/repos/habitat-sh/habitat/releases{/id}","deployments_url":"https://api.github.com/repos/habitat-sh/habitat/deployments","created_at":"2015-05-22T22:47:14Z","updated_at":"2016-06-14T06:54:27Z","pushed_at":"2016-06-14T07:34:20Z","git_url":"git://github.com/habitat-sh/habitat.git","ssh_url":"git@github.com:habitat-sh/habitat.git","clone_url":"https://github.com/habitat-sh/habitat.git","svn_url":"https://github.com/habitat-sh/habitat","homepage":"https://www.habitat.sh","size":34316,"stargazers_count":4,"watchers_count":4,"language":"Rust","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":2,"mirror_url":null,"open_issues_count":10,"forks":2,"open_issues":10,"watchers":4,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/habitat-sh/habitat/pulls/827"},"html":{"href":"https://github.com/habitat-sh/habitat/pull/827"},"issue":{"href":"https://api.github.com/repos/habitat-sh/habitat/issues/827"},"comments":{"href":"https://api.github.com/repos/habitat-sh/habitat/issues/827/comments"},"review_comments":{"href":"https://api.github.com/repos/habitat-sh/habitat/pulls/827/comments"},"review_comment":{"href":"https://api.github.com/repos/habitat-sh/habitat/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/habitat-sh/habitat/pulls/827/commits"},"statuses":{"href":"https://api.github.com/repos/habitat-sh/habitat/statuses/ed42e0b93485e0b9f6bea94d5a375048c16be15e"}}}}
{"actor":{"display_login":"mattray"}}