{"action":"created","comment":{"url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments/85876300","pull_request_review_id":6564375,"id":85876300,"diff_hunk":"@@ -0,0 +1,195 @@\n+# Flex Volume API Proposal\n+## Abstract\n+The goal of this proposal is to extend and enhance the existing flex volume storage plugin model (#13840). It bridges the gap with existing in-tree plugins and defines a stable api.\n+\n+## Background:\n+The existing flex volume plugin enables administrators/vendors to create out-of-tree volume plugins, i.e., plugins which do not reside in Kubernetes project. But, it has the following gaps:\n+* It lacks support for the latest enhancements to in-tree plugins like dynamic provisioning and centralized attach-detach controller\n+* It does not define a stable driver api for administrators/vendors to work with.\n+* The current flex volume plugin deployment model is not suitable for environments like GCE & CoreOS, where access to the root file system is restricted. And in other environments the overall user experience is poor, as it requires manual installation of the plugin on every node and restart of kubelets & controller manager. This issue is covered in detail in another PR #32550.\n+\n+### Goals:\n+The goals of this proposal are \n+* Define new stable driver API.\n+* API should be versioned and backward compatible.\n+* API should be extensible to accommodate future enhancements.\n+* Add support for dynamic provisioning and centralized attach-detach controller and\n+* The biggest advantage of flex volume is it’s simplicity. It is just an adapter around the internal api. We will keep it simple in the new design and try to follow the same adapter pattern.\n+\n+### Non Goals:\n+* This proposal does not the address the poor installation model of existing model. It is covered in another PR #32550.\n+\n+## Terminology:\n+**Plugin**: refers to flex volume plugin.\n+\n+**Plugin Driver API**: API calls defined by flex volume plugin.\n+\n+**Plugin Driver**: Out-of-tree driver/plugin which implements plugin driver api.\n+\n+**In-tree plugin**: Plugins which are included in Kubernetes project/source tree.\n+\n+## API:\n+Existing flex volume plugin driver api is in alpha phase and are subject to change between Kubernetes versions. This section proposes stable api for plugin driver writers to work with.","path":"docs/proposals/flexvolume-api.md","position":32,"original_position":32,"commit_id":"7db5d80a9dd28af7f3d216a0fc2bbb770ccd72ef","original_commit_id":"7db5d80a9dd28af7f3d216a0fc2bbb770ccd72ef","user":{"login":"brendandburns","id":5751682,"avatar_url":"https://avatars.githubusercontent.com/u/5751682?v=3","gravatar_id":"","url":"https://api.github.com/users/brendandburns","html_url":"https://github.com/brendandburns","followers_url":"https://api.github.com/users/brendandburns/followers","following_url":"https://api.github.com/users/brendandburns/following{/other_user}","gists_url":"https://api.github.com/users/brendandburns/gists{/gist_id}","starred_url":"https://api.github.com/users/brendandburns/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brendandburns/subscriptions","organizations_url":"https://api.github.com/users/brendandburns/orgs","repos_url":"https://api.github.com/users/brendandburns/repos","events_url":"https://api.github.com/users/brendandburns/events{/privacy}","received_events_url":"https://api.github.com/users/brendandburns/received_events","type":"User","site_admin":false},"body":"\"is in _the_ alpha phase ...\"","created_at":"2016-11-01T05:12:48Z","updated_at":"2016-11-01T05:15:37Z","html_url":"https://github.com/kubernetes/kubernetes/pull/33538#discussion_r85876300","pull_request_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538","_links":{"self":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments/85876300"},"html":{"href":"https://github.com/kubernetes/kubernetes/pull/33538#discussion_r85876300"},"pull_request":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538"}}},"pull_request":{"url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538","id":86875681,"html_url":"https://github.com/kubernetes/kubernetes/pull/33538","diff_url":"https://github.com/kubernetes/kubernetes/pull/33538.diff","patch_url":"https://github.com/kubernetes/kubernetes/pull/33538.patch","issue_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/33538","number":33538,"state":"open","locked":false,"title":"New Flex volume API proposal.","user":{"login":"chakri-nelluri","id":9920367,"avatar_url":"https://avatars.githubusercontent.com/u/9920367?v=3","gravatar_id":"","url":"https://api.github.com/users/chakri-nelluri","html_url":"https://github.com/chakri-nelluri","followers_url":"https://api.github.com/users/chakri-nelluri/followers","following_url":"https://api.github.com/users/chakri-nelluri/following{/other_user}","gists_url":"https://api.github.com/users/chakri-nelluri/gists{/gist_id}","starred_url":"https://api.github.com/users/chakri-nelluri/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chakri-nelluri/subscriptions","organizations_url":"https://api.github.com/users/chakri-nelluri/orgs","repos_url":"https://api.github.com/users/chakri-nelluri/repos","events_url":"https://api.github.com/users/chakri-nelluri/events{/privacy}","received_events_url":"https://api.github.com/users/chakri-nelluri/received_events","type":"User","site_admin":false},"body":"Pull request for proposal in #32543\n\n<!-- Reviewable:start -->\n---\n\nThis change is [<img src=\"https://reviewable.kubernetes.io/review_button.svg\" height=\"34\" align=\"absmiddle\" alt=\"Reviewable\"/>](https://reviewable.kubernetes.io/reviews/kubernetes/kubernetes/33538)\n\n<!-- Reviewable:end -->\n","created_at":"2016-09-27T07:32:07Z","updated_at":"2016-11-01T05:15:38Z","closed_at":null,"merged_at":null,"merge_commit_sha":"643bcfb88190f4bf46444b6fb40d913954ce99c6","assignee":{"login":"brendandburns","id":5751682,"avatar_url":"https://avatars.githubusercontent.com/u/5751682?v=3","gravatar_id":"","url":"https://api.github.com/users/brendandburns","html_url":"https://github.com/brendandburns","followers_url":"https://api.github.com/users/brendandburns/followers","following_url":"https://api.github.com/users/brendandburns/following{/other_user}","gists_url":"https://api.github.com/users/brendandburns/gists{/gist_id}","starred_url":"https://api.github.com/users/brendandburns/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brendandburns/subscriptions","organizations_url":"https://api.github.com/users/brendandburns/orgs","repos_url":"https://api.github.com/users/brendandburns/repos","events_url":"https://api.github.com/users/brendandburns/events{/privacy}","received_events_url":"https://api.github.com/users/brendandburns/received_events","type":"User","site_admin":false},"assignees":[{"login":"brendandburns","id":5751682,"avatar_url":"https://avatars.githubusercontent.com/u/5751682?v=3","gravatar_id":"","url":"https://api.github.com/users/brendandburns","html_url":"https://github.com/brendandburns","followers_url":"https://api.github.com/users/brendandburns/followers","following_url":"https://api.github.com/users/brendandburns/following{/other_user}","gists_url":"https://api.github.com/users/brendandburns/gists{/gist_id}","starred_url":"https://api.github.com/users/brendandburns/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brendandburns/subscriptions","organizations_url":"https://api.github.com/users/brendandburns/orgs","repos_url":"https://api.github.com/users/brendandburns/repos","events_url":"https://api.github.com/users/brendandburns/events{/privacy}","received_events_url":"https://api.github.com/users/brendandburns/received_events","type":"User","site_admin":false}],"milestone":null,"commits_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538/commits","review_comments_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538/comments","review_comment_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/33538/comments","statuses_url":"https://api.github.com/repos/kubernetes/kubernetes/statuses/7db5d80a9dd28af7f3d216a0fc2bbb770ccd72ef","head":{"label":"chakri-nelluri:flex-proposals","ref":"flex-proposals","sha":"7db5d80a9dd28af7f3d216a0fc2bbb770ccd72ef","user":{"login":"chakri-nelluri","id":9920367,"avatar_url":"https://avatars.githubusercontent.com/u/9920367?v=3","gravatar_id":"","url":"https://api.github.com/users/chakri-nelluri","html_url":"https://github.com/chakri-nelluri","followers_url":"https://api.github.com/users/chakri-nelluri/followers","following_url":"https://api.github.com/users/chakri-nelluri/following{/other_user}","gists_url":"https://api.github.com/users/chakri-nelluri/gists{/gist_id}","starred_url":"https://api.github.com/users/chakri-nelluri/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chakri-nelluri/subscriptions","organizations_url":"https://api.github.com/users/chakri-nelluri/orgs","repos_url":"https://api.github.com/users/chakri-nelluri/repos","events_url":"https://api.github.com/users/chakri-nelluri/events{/privacy}","received_events_url":"https://api.github.com/users/chakri-nelluri/received_events","type":"User","site_admin":false},"repo":{"id":30275239,"name":"kubernetes","full_name":"chakri-nelluri/kubernetes","owner":{"login":"chakri-nelluri","id":9920367,"avatar_url":"https://avatars.githubusercontent.com/u/9920367?v=3","gravatar_id":"","url":"https://api.github.com/users/chakri-nelluri","html_url":"https://github.com/chakri-nelluri","followers_url":"https://api.github.com/users/chakri-nelluri/followers","following_url":"https://api.github.com/users/chakri-nelluri/following{/other_user}","gists_url":"https://api.github.com/users/chakri-nelluri/gists{/gist_id}","starred_url":"https://api.github.com/users/chakri-nelluri/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chakri-nelluri/subscriptions","organizations_url":"https://api.github.com/users/chakri-nelluri/orgs","repos_url":"https://api.github.com/users/chakri-nelluri/repos","events_url":"https://api.github.com/users/chakri-nelluri/events{/privacy}","received_events_url":"https://api.github.com/users/chakri-nelluri/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/chakri-nelluri/kubernetes","description":"Container Cluster Manager","fork":true,"url":"https://api.github.com/repos/chakri-nelluri/kubernetes","forks_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/forks","keys_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/teams","hooks_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/events","assignees_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/tags","blobs_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/languages","stargazers_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/subscription","commits_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/merges","archive_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/downloads","issues_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/releases{/id}","deployments_url":"https://api.github.com/repos/chakri-nelluri/kubernetes/deployments","created_at":"2015-02-04T01:44:45Z","updated_at":"2016-04-05T07:37:53Z","pushed_at":"2016-10-28T21:37:55Z","git_url":"git://github.com/chakri-nelluri/kubernetes.git","ssh_url":"git@github.com:chakri-nelluri/kubernetes.git","clone_url":"https://github.com/chakri-nelluri/kubernetes.git","svn_url":"https://github.com/chakri-nelluri/kubernetes","homepage":"http://kubernetes.io","size":319820,"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":"kubernetes:master","ref":"master","sha":"b77e13444f07071d7a15cb117b2a1d6c604e610a","user":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"repo":{"id":20580498,"name":"kubernetes","full_name":"kubernetes/kubernetes","owner":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kubernetes/kubernetes","description":"Production-Grade Container Scheduling and Management","fork":false,"url":"https://api.github.com/repos/kubernetes/kubernetes","forks_url":"https://api.github.com/repos/kubernetes/kubernetes/forks","keys_url":"https://api.github.com/repos/kubernetes/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kubernetes/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kubernetes/kubernetes/teams","hooks_url":"https://api.github.com/repos/kubernetes/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/kubernetes/kubernetes/events","assignees_url":"https://api.github.com/repos/kubernetes/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/kubernetes/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/kubernetes/kubernetes/tags","blobs_url":"https://api.github.com/repos/kubernetes/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kubernetes/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kubernetes/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/kubernetes/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kubernetes/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/kubernetes/kubernetes/languages","stargazers_url":"https://api.github.com/repos/kubernetes/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/kubernetes/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/kubernetes/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/kubernetes/kubernetes/subscription","commits_url":"https://api.github.com/repos/kubernetes/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/kubernetes/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/kubernetes/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/kubernetes/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kubernetes/kubernetes/merges","archive_url":"https://api.github.com/repos/kubernetes/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kubernetes/kubernetes/downloads","issues_url":"https://api.github.com/repos/kubernetes/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/kubernetes/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/kubernetes/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kubernetes/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/kubernetes/kubernetes/releases{/id}","deployments_url":"https://api.github.com/repos/kubernetes/kubernetes/deployments","created_at":"2014-06-06T22:56:04Z","updated_at":"2016-11-01T04:45:28Z","pushed_at":"2016-11-01T05:15:30Z","git_url":"git://github.com/kubernetes/kubernetes.git","ssh_url":"git@github.com:kubernetes/kubernetes.git","clone_url":"https://github.com/kubernetes/kubernetes.git","svn_url":"https://github.com/kubernetes/kubernetes","homepage":"http://kubernetes.io","size":610037,"stargazers_count":18054,"watchers_count":18054,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":5897,"mirror_url":null,"open_issues_count":5177,"forks":5897,"open_issues":5177,"watchers":18054,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538"},"html":{"href":"https://github.com/kubernetes/kubernetes/pull/33538"},"issue":{"href":"https://api.github.com/repos/kubernetes/kubernetes/issues/33538"},"comments":{"href":"https://api.github.com/repos/kubernetes/kubernetes/issues/33538/comments"},"review_comments":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538/comments"},"review_comment":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/33538/commits"},"statuses":{"href":"https://api.github.com/repos/kubernetes/kubernetes/statuses/7db5d80a9dd28af7f3d216a0fc2bbb770ccd72ef"}}}}
{"actor":{"display_login":"brendandburns"}}