{"action":"created","issue":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9107","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9107/labels{/name}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9107/comments","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9107/events","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/issues/9107","id":83915195,"number":9107,"title":"Guestbook Key Examples Needs To Work With Core Kubernetes","user":{"login":"satnam6502","id":6164339,"avatar_url":"https://avatars.githubusercontent.com/u/6164339?v=3","gravatar_id":"","url":"https://api.github.com/users/satnam6502","html_url":"https://github.com/satnam6502","followers_url":"https://api.github.com/users/satnam6502/followers","following_url":"https://api.github.com/users/satnam6502/following{/other_user}","gists_url":"https://api.github.com/users/satnam6502/gists{/gist_id}","starred_url":"https://api.github.com/users/satnam6502/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/satnam6502/subscriptions","organizations_url":"https://api.github.com/users/satnam6502/orgs","repos_url":"https://api.github.com/users/satnam6502/repos","events_url":"https://api.github.com/users/satnam6502/events{/privacy}","received_events_url":"https://api.github.com/users/satnam6502/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/kind/documentation","name":"kind/documentation","color":"c7def8"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/priority/P1","name":"priority/P1","color":"eb6420"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/team/community","name":"team/community","color":"d2b48c"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/team/UX","name":"team/UX","color":"d2b48c"}],"state":"open","locked":false,"assignee":{"login":"amygdala","id":115093,"avatar_url":"https://avatars.githubusercontent.com/u/115093?v=3","gravatar_id":"","url":"https://api.github.com/users/amygdala","html_url":"https://github.com/amygdala","followers_url":"https://api.github.com/users/amygdala/followers","following_url":"https://api.github.com/users/amygdala/following{/other_user}","gists_url":"https://api.github.com/users/amygdala/gists{/gist_id}","starred_url":"https://api.github.com/users/amygdala/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/amygdala/subscriptions","organizations_url":"https://api.github.com/users/amygdala/orgs","repos_url":"https://api.github.com/users/amygdala/repos","events_url":"https://api.github.com/users/amygdala/events{/privacy}","received_events_url":"https://api.github.com/users/amygdala/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones/6","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/milestones/v1.0","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones/6/labels","id":969317,"number":6,"title":"v1.0","description":"Issues that need to be resolved for v1.0 of Kubernetes.","creator":{"login":"goltermann","id":9358478,"avatar_url":"https://avatars.githubusercontent.com/u/9358478?v=3","gravatar_id":"","url":"https://api.github.com/users/goltermann","html_url":"https://github.com/goltermann","followers_url":"https://api.github.com/users/goltermann/followers","following_url":"https://api.github.com/users/goltermann/following{/other_user}","gists_url":"https://api.github.com/users/goltermann/gists{/gist_id}","starred_url":"https://api.github.com/users/goltermann/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/goltermann/subscriptions","organizations_url":"https://api.github.com/users/goltermann/orgs","repos_url":"https://api.github.com/users/goltermann/repos","events_url":"https://api.github.com/users/goltermann/events{/privacy}","received_events_url":"https://api.github.com/users/goltermann/received_events","type":"User","site_admin":false},"open_issues":86,"closed_issues":440,"state":"open","created_at":"2015-02-06T20:27:16Z","updated_at":"2015-06-19T23:45:33Z","due_on":null,"closed_at":null},"comments":8,"created_at":"2015-06-02T08:37:40Z","updated_at":"2015-06-19T23:46:33Z","closed_at":null,"body":"This issue is a follow on from the discussion in PR #5284 by @piosz where folks like @pires and @eparis @nzwulfin  and maybe @derekwaynecarr complain about changing the key guestbook example to use DNS which makes it a nicer example for Kubernetes deployments that have a DNS add-on but breaks it for other clusters that don't. A very good point was made: the key example that most people try out should work on bare Kubernetes without the need to assume any add-ons services.\r\n\r\nAlthough we can imagine some post 1.0 fixes (e.g. absorb DNS functionality into core Kubernetes @thockin ) I think it is very important to get our examples and documentation in very good shape for the 1.0 release so that everyone has a very good out of the box experience with the key guestbook example for any Kubernetes deployment that we explicitly support.\r\n\r\nI propose the following approach for 1.0:\r\n* Produce a variety of guestbook examples which make different assumptions about the type of the Kubernetes deployment.\r\n* Have a `guestbook-bare` example that works without DNS.\r\n* Have a `guestbook-dns` example that works with DNS.\r\n* Have other `guestbook-XXX` examples that work with other Kubernetes deployments that can provide an alternative to our DNS add-on to achieve the same effect.\r\n* Produce a clear matrix in our documentation that explains which example should be run depending on your deployment.\r\n* Make clear at the beginning of the `README.md` for each of the examples the deployment that is expected.\r\n* Perhaps modify the examples to make sure the pre-requisites are available before running e.g. in a Makefile as a pre-check?\r\n\r\n@RichieEscarez @bgrant0607 \r\n"},"comment":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/comments/113674083","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/issues/9107#issuecomment-113674083","issue_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9107","id":113674083,"user":{"login":"eparis","id":8093535,"avatar_url":"https://avatars.githubusercontent.com/u/8093535?v=3","gravatar_id":"","url":"https://api.github.com/users/eparis","html_url":"https://github.com/eparis","followers_url":"https://api.github.com/users/eparis/followers","following_url":"https://api.github.com/users/eparis/following{/other_user}","gists_url":"https://api.github.com/users/eparis/gists{/gist_id}","starred_url":"https://api.github.com/users/eparis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eparis/subscriptions","organizations_url":"https://api.github.com/users/eparis/orgs","repos_url":"https://api.github.com/users/eparis/repos","events_url":"https://api.github.com/users/eparis/events{/privacy}","received_events_url":"https://api.github.com/users/eparis/received_events","type":"User","site_admin":false},"created_at":"2015-06-19T23:46:33Z","updated_at":"2015-06-19T23:46:33Z","body":"@thockin standard answer 'everyone who doesn't use salt'"}}