{"action":"created","comment":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments/31788170","id":31788170,"diff_hunk":"@@ -28,13 +28,27 @@ Distinct API versions present more clear, consistent views of system resources a\n \n The [API and release versioning proposal](versioning.md) describes the current thinking on the API version evolution process.\n \n-## v1beta1 and v1beta2 are deprecated; please move to v1beta3 ASAP\n+## v1beta1, v1beta2, and v1beta3 are deprecated; please move to v1 ASAP\n \n-As of April 1, 2015, the Kubernetes v1beta3 API has been enabled by default, and the v1beta1 and v1beta2 APIs are deprecated. v1beta3 should be considered the v1 release-candidate API, and the v1 API is expected to be substantially similar. As \"pre-release\" APIs, v1beta1, v1beta2, and v1beta3 will be eliminated once the v1 API is available, by the end of June 2015. \n+As of June 4, 2015, the Kubernetes v1 API has been enabled by default. The v1beta1 and v1beta2 APIs were deleted on June 1, 2015. v1beta3 is planned to be deleted before the end of June.\n \n-## v1beta3 conversion tips\n+### v1 conversion tips (from v1beta3)\n \n-We're working to convert all documentation and examples to v1beta3. Most examples already contain a v1beta3 subdirectory with the API objects translated to v1beta3. A simple [API conversion tool](cluster_management.md#switching-your-config-files-to-a-new-api-version) has been written to simplify the translation process. Use `kubectl create --validate` in order to validate your json or yaml against our Swagger spec. \n+We're working to convert all documentation and examples to v1. A simple [API conversion tool](cluster_management.md#switching-your-config-files-to-a-new-api-version) has been written to simplify the translation process. Use `kubectl create --validate` in order to validate your json or yaml against our Swagger spec.\n+\n+Some important difference between v1beta3 and v1:\n+\n+* Container's `privileged` or `capabilities` properties were nested under the `securityContext` property. See [Security Contexts](security_context.md).\n+* Container State's `termination` property was renamed to `terminated`.\n+* PodSpec's `host` property was renamed to `nodeName`.","path":"docs/api.md","position":20,"original_position":20,"commit_id":"4d0e4704fb8c17a42f3edb82cd7160a1ea0b84f4","original_commit_id":"4d0e4704fb8c17a42f3edb82cd7160a1ea0b84f4","user":{"login":"thockin","id":5595220,"avatar_url":"https://avatars.githubusercontent.com/u/5595220?v=3","gravatar_id":"","url":"https://api.github.com/users/thockin","html_url":"https://github.com/thockin","followers_url":"https://api.github.com/users/thockin/followers","following_url":"https://api.github.com/users/thockin/following{/other_user}","gists_url":"https://api.github.com/users/thockin/gists{/gist_id}","starred_url":"https://api.github.com/users/thockin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thockin/subscriptions","organizations_url":"https://api.github.com/users/thockin/orgs","repos_url":"https://api.github.com/users/thockin/repos","events_url":"https://api.github.com/users/thockin/events{/privacy}","received_events_url":"https://api.github.com/users/thockin/received_events","type":"User","site_admin":false},"body":"in general I think it's clearer to speak present tense: X is renamed to Y or X is now named Y.","created_at":"2015-06-05T05:14:22Z","updated_at":"2015-06-05T05:14:22Z","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/9276#discussion_r31788170","pull_request_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276","_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments/31788170"},"html":{"href":"https://github.com/GoogleCloudPlatform/kubernetes/pull/9276#discussion_r31788170"},"pull_request":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276"}}},"pull_request":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276","id":36979168,"html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/9276","diff_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/9276.diff","patch_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/9276.patch","issue_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9276","number":9276,"state":"open","locked":false,"title":"Adding v1 conversion tips","user":{"login":"krousey","id":157083,"avatar_url":"https://avatars.githubusercontent.com/u/157083?v=3","gravatar_id":"","url":"https://api.github.com/users/krousey","html_url":"https://github.com/krousey","followers_url":"https://api.github.com/users/krousey/followers","following_url":"https://api.github.com/users/krousey/following{/other_user}","gists_url":"https://api.github.com/users/krousey/gists{/gist_id}","starred_url":"https://api.github.com/users/krousey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krousey/subscriptions","organizations_url":"https://api.github.com/users/krousey/orgs","repos_url":"https://api.github.com/users/krousey/repos","events_url":"https://api.github.com/users/krousey/events{/privacy}","received_events_url":"https://api.github.com/users/krousey/received_events","type":"User","site_admin":false},"body":"@bgrant0607 @thockin ","created_at":"2015-06-04T21:16:21Z","updated_at":"2015-06-05T05:14:22Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5cc0caf3bfa0afd456e72b599b5aebc8e896d321","assignee":{"login":"bgrant0607","id":7725777,"avatar_url":"https://avatars.githubusercontent.com/u/7725777?v=3","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276/commits","review_comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276/comments","review_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments{/number}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9276/comments","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/4d0e4704fb8c17a42f3edb82cd7160a1ea0b84f4","head":{"label":"krousey:v1_conversion_doc","ref":"v1_conversion_doc","sha":"4d0e4704fb8c17a42f3edb82cd7160a1ea0b84f4","user":{"login":"krousey","id":157083,"avatar_url":"https://avatars.githubusercontent.com/u/157083?v=3","gravatar_id":"","url":"https://api.github.com/users/krousey","html_url":"https://github.com/krousey","followers_url":"https://api.github.com/users/krousey/followers","following_url":"https://api.github.com/users/krousey/following{/other_user}","gists_url":"https://api.github.com/users/krousey/gists{/gist_id}","starred_url":"https://api.github.com/users/krousey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krousey/subscriptions","organizations_url":"https://api.github.com/users/krousey/orgs","repos_url":"https://api.github.com/users/krousey/repos","events_url":"https://api.github.com/users/krousey/events{/privacy}","received_events_url":"https://api.github.com/users/krousey/received_events","type":"User","site_admin":false},"repo":{"id":33140890,"name":"kubernetes","full_name":"krousey/kubernetes","owner":{"login":"krousey","id":157083,"avatar_url":"https://avatars.githubusercontent.com/u/157083?v=3","gravatar_id":"","url":"https://api.github.com/users/krousey","html_url":"https://github.com/krousey","followers_url":"https://api.github.com/users/krousey/followers","following_url":"https://api.github.com/users/krousey/following{/other_user}","gists_url":"https://api.github.com/users/krousey/gists{/gist_id}","starred_url":"https://api.github.com/users/krousey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krousey/subscriptions","organizations_url":"https://api.github.com/users/krousey/orgs","repos_url":"https://api.github.com/users/krousey/repos","events_url":"https://api.github.com/users/krousey/events{/privacy}","received_events_url":"https://api.github.com/users/krousey/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/krousey/kubernetes","description":"Container Cluster Manager from Google","fork":true,"url":"https://api.github.com/repos/krousey/kubernetes","forks_url":"https://api.github.com/repos/krousey/kubernetes/forks","keys_url":"https://api.github.com/repos/krousey/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/krousey/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/krousey/kubernetes/teams","hooks_url":"https://api.github.com/repos/krousey/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/krousey/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/krousey/kubernetes/events","assignees_url":"https://api.github.com/repos/krousey/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/krousey/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/krousey/kubernetes/tags","blobs_url":"https://api.github.com/repos/krousey/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/krousey/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/krousey/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/krousey/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/krousey/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/krousey/kubernetes/languages","stargazers_url":"https://api.github.com/repos/krousey/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/krousey/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/krousey/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/krousey/kubernetes/subscription","commits_url":"https://api.github.com/repos/krousey/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/krousey/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/krousey/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/krousey/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/krousey/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/krousey/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/krousey/kubernetes/merges","archive_url":"https://api.github.com/repos/krousey/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/krousey/kubernetes/downloads","issues_url":"https://api.github.com/repos/krousey/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/krousey/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/krousey/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/krousey/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/krousey/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/krousey/kubernetes/releases{/id}","created_at":"2015-03-30T18:38:40Z","updated_at":"2015-04-20T21:05:26Z","pushed_at":"2015-06-04T21:14:57Z","git_url":"git://github.com/krousey/kubernetes.git","ssh_url":"git@github.com:krousey/kubernetes.git","clone_url":"https://github.com/krousey/kubernetes.git","svn_url":"https://github.com/krousey/kubernetes","homepage":"http://kubernetes.io","size":61728,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"GoogleCloudPlatform:master","ref":"master","sha":"521446503a12c23e8dbd8849e35437ea225fd0c3","user":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"repo":{"id":20580498,"name":"kubernetes","full_name":"GoogleCloudPlatform/kubernetes","owner":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/GoogleCloudPlatform/kubernetes","description":"Container Cluster Manager from Google","fork":false,"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes","forks_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/forks","keys_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/teams","hooks_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/events","assignees_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/tags","blobs_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/languages","stargazers_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/subscription","commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/merges","archive_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/downloads","issues_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/releases{/id}","created_at":"2014-06-06T22:56:04Z","updated_at":"2015-06-05T02:45:29Z","pushed_at":"2015-06-05T05:10:33Z","git_url":"git://github.com/GoogleCloudPlatform/kubernetes.git","ssh_url":"git@github.com:GoogleCloudPlatform/kubernetes.git","clone_url":"https://github.com/GoogleCloudPlatform/kubernetes.git","svn_url":"https://github.com/GoogleCloudPlatform/kubernetes","homepage":"http://kubernetes.io","size":305532,"stargazers_count":8120,"watchers_count":8120,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1720,"mirror_url":null,"open_issues_count":1255,"forks":1720,"open_issues":1255,"watchers":8120,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276"},"html":{"href":"https://github.com/GoogleCloudPlatform/kubernetes/pull/9276"},"issue":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9276"},"comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9276/comments"},"review_comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276/comments"},"review_comment":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/9276/commits"},"statuses":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/4d0e4704fb8c17a42f3edb82cd7160a1ea0b84f4"}}}}