{"action":"created","comment":{"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments/203452522","pull_request_review_id":138344325,"id":203452522,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIwMzQ1MjUyMg==","diff_hunk":"@@ -0,0 +1,159 @@\n+---\n+title: Using Namespaced Broker Resources\n+layout: docwithnav\n+---\n+\n+# Cluster-Scoped vs Namespace-Scoped Broker Resources\n+\n+Service Catalog enables service brokers to be registered in two manners: as a cluster-scoped resource or as a namespace-scoped resource. As a user of service catalog, you might use these approaches to accomplish different goals, like providing a common set of service broker resources to all users or extending your existing role based access control (RBAC) policies to the lifecycle of service broker resources. This document will explain some use cases for namespace-scoped resources and how to accomplish them using Service Catalog.\n+\n+## Possible Use Cases\n+\n+When using `ClusterServiceBroker` and associated `ClusterServiceClass` and `ClusterServicePlan` resources, service broker resources existing within the cluster as cluster-scoped resources. This means that you are limited in how you can apply RBAC and you can only have a single instance of that resource for a given identifier. As an example, if the service broker you are registering has fixed class and plan identifiers, you will be limited to one instance of the broker. With namespace-scoped brokers, however, the `ServiceBroker`, along with the `ServiceClass` and `ServicePlan` resources are scoped to a particular namespace. This allows for some more complicated use cases that were not possible with the cluster-scoped broker resources. ","path":"docs/namespaced-broker-resources.md","position":12,"original_position":12,"commit_id":"dd99f7fd77691183afbf42623162235cedcda5a7","original_commit_id":"dd99f7fd77691183afbf42623162235cedcda5a7","user":{"login":"carolynvs","id":1368985,"node_id":"MDQ6VXNlcjEzNjg5ODU=","avatar_url":"https://avatars1.githubusercontent.com/u/1368985?v=4","gravatar_id":"","url":"https://api.github.com/users/carolynvs","html_url":"https://github.com/carolynvs","followers_url":"https://api.github.com/users/carolynvs/followers","following_url":"https://api.github.com/users/carolynvs/following{/other_user}","gists_url":"https://api.github.com/users/carolynvs/gists{/gist_id}","starred_url":"https://api.github.com/users/carolynvs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carolynvs/subscriptions","organizations_url":"https://api.github.com/users/carolynvs/orgs","repos_url":"https://api.github.com/users/carolynvs/repos","events_url":"https://api.github.com/users/carolynvs/events{/privacy}","received_events_url":"https://api.github.com/users/carolynvs/received_events","type":"User","site_admin":false},"body":"Also I suggest saying \"advanced use cases\" instead of \"complicated\" so it sounds less scary. 😁 ","created_at":"2018-07-18T16:49:38Z","updated_at":"2018-07-18T17:00:46Z","html_url":"https://github.com/kubernetes-incubator/service-catalog/pull/2210#discussion_r203452522","pull_request_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments/203452522"},"html":{"href":"https://github.com/kubernetes-incubator/service-catalog/pull/2210#discussion_r203452522"},"pull_request":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210"}},"in_reply_to_id":203452178},"pull_request":{"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210","id":202088503,"node_id":"MDExOlB1bGxSZXF1ZXN0MjAyMDg4NTAz","html_url":"https://github.com/kubernetes-incubator/service-catalog/pull/2210","diff_url":"https://github.com/kubernetes-incubator/service-catalog/pull/2210.diff","patch_url":"https://github.com/kubernetes-incubator/service-catalog/pull/2210.patch","issue_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/2210","number":2210,"state":"open","locked":false,"title":"Adding docs for namespaced broker resources","user":{"login":"jeremyrickard","id":33884483,"node_id":"MDQ6VXNlcjMzODg0NDgz","avatar_url":"https://avatars1.githubusercontent.com/u/33884483?v=4","gravatar_id":"","url":"https://api.github.com/users/jeremyrickard","html_url":"https://github.com/jeremyrickard","followers_url":"https://api.github.com/users/jeremyrickard/followers","following_url":"https://api.github.com/users/jeremyrickard/following{/other_user}","gists_url":"https://api.github.com/users/jeremyrickard/gists{/gist_id}","starred_url":"https://api.github.com/users/jeremyrickard/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jeremyrickard/subscriptions","organizations_url":"https://api.github.com/users/jeremyrickard/orgs","repos_url":"https://api.github.com/users/jeremyrickard/repos","events_url":"https://api.github.com/users/jeremyrickard/events{/privacy}","received_events_url":"https://api.github.com/users/jeremyrickard/received_events","type":"User","site_admin":false},"body":"This PR adds relevant wording to the docs/resources.md file to introduce the namespaced resources. \r\n\r\nIt also introduces a new section to docs/README.md called 'Topics for operators' and introduces a page dedicated to namespaced brokers. \r\n\r\ndocs/namespaced-broker-resources.md provides:\r\n* Example use cases\r\n* How to enable the feature flag\r\n* How to create namespaced resources and use them from Service Instances\r\n* How to combine with catalog restrictions (need to link to this later) to make tight control of what can be provisioned\r\n\r\nCloses: #2202","created_at":"2018-07-17T22:10:44Z","updated_at":"2018-07-18T17:00:47Z","closed_at":null,"merged_at":null,"merge_commit_sha":"61a52ce89c3e966ba3ca24ece37b018facf29ec9","assignee":null,"assignees":[],"requested_reviewers":[{"login":"eriknelson","id":410933,"node_id":"MDQ6VXNlcjQxMDkzMw==","avatar_url":"https://avatars3.githubusercontent.com/u/410933?v=4","gravatar_id":"","url":"https://api.github.com/users/eriknelson","html_url":"https://github.com/eriknelson","followers_url":"https://api.github.com/users/eriknelson/followers","following_url":"https://api.github.com/users/eriknelson/following{/other_user}","gists_url":"https://api.github.com/users/eriknelson/gists{/gist_id}","starred_url":"https://api.github.com/users/eriknelson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eriknelson/subscriptions","organizations_url":"https://api.github.com/users/eriknelson/orgs","repos_url":"https://api.github.com/users/eriknelson/repos","events_url":"https://api.github.com/users/eriknelson/events{/privacy}","received_events_url":"https://api.github.com/users/eriknelson/received_events","type":"User","site_admin":false},{"login":"vaikas-google","id":11279988,"node_id":"MDQ6VXNlcjExMjc5OTg4","avatar_url":"https://avatars3.githubusercontent.com/u/11279988?v=4","gravatar_id":"","url":"https://api.github.com/users/vaikas-google","html_url":"https://github.com/vaikas-google","followers_url":"https://api.github.com/users/vaikas-google/followers","following_url":"https://api.github.com/users/vaikas-google/following{/other_user}","gists_url":"https://api.github.com/users/vaikas-google/gists{/gist_id}","starred_url":"https://api.github.com/users/vaikas-google/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vaikas-google/subscriptions","organizations_url":"https://api.github.com/users/vaikas-google/orgs","repos_url":"https://api.github.com/users/vaikas-google/repos","events_url":"https://api.github.com/users/vaikas-google/events{/privacy}","received_events_url":"https://api.github.com/users/vaikas-google/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[{"id":485046198,"node_id":"MDU6TGFiZWw0ODUwNDYxOTg=","url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/labels/cncf-cla:%20yes","name":"cncf-cla: yes","color":"ededed","default":false},{"id":678322476,"node_id":"MDU6TGFiZWw2NzgzMjI0NzY=","url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/labels/size/L","name":"size/L","color":"ededed","default":false}],"milestone":null,"commits_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210/commits","review_comments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210/comments","review_comment_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/2210/comments","statuses_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/dd99f7fd77691183afbf42623162235cedcda5a7","head":{"label":"jeremyrickard:ns-broker-docs","ref":"ns-broker-docs","sha":"dd99f7fd77691183afbf42623162235cedcda5a7","user":{"login":"jeremyrickard","id":33884483,"node_id":"MDQ6VXNlcjMzODg0NDgz","avatar_url":"https://avatars1.githubusercontent.com/u/33884483?v=4","gravatar_id":"","url":"https://api.github.com/users/jeremyrickard","html_url":"https://github.com/jeremyrickard","followers_url":"https://api.github.com/users/jeremyrickard/followers","following_url":"https://api.github.com/users/jeremyrickard/following{/other_user}","gists_url":"https://api.github.com/users/jeremyrickard/gists{/gist_id}","starred_url":"https://api.github.com/users/jeremyrickard/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jeremyrickard/subscriptions","organizations_url":"https://api.github.com/users/jeremyrickard/orgs","repos_url":"https://api.github.com/users/jeremyrickard/repos","events_url":"https://api.github.com/users/jeremyrickard/events{/privacy}","received_events_url":"https://api.github.com/users/jeremyrickard/received_events","type":"User","site_admin":false},"repo":{"id":112221318,"node_id":"MDEwOlJlcG9zaXRvcnkxMTIyMjEzMTg=","name":"service-catalog","full_name":"jeremyrickard/service-catalog","owner":{"login":"jeremyrickard","id":33884483,"node_id":"MDQ6VXNlcjMzODg0NDgz","avatar_url":"https://avatars1.githubusercontent.com/u/33884483?v=4","gravatar_id":"","url":"https://api.github.com/users/jeremyrickard","html_url":"https://github.com/jeremyrickard","followers_url":"https://api.github.com/users/jeremyrickard/followers","following_url":"https://api.github.com/users/jeremyrickard/following{/other_user}","gists_url":"https://api.github.com/users/jeremyrickard/gists{/gist_id}","starred_url":"https://api.github.com/users/jeremyrickard/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jeremyrickard/subscriptions","organizations_url":"https://api.github.com/users/jeremyrickard/orgs","repos_url":"https://api.github.com/users/jeremyrickard/repos","events_url":"https://api.github.com/users/jeremyrickard/events{/privacy}","received_events_url":"https://api.github.com/users/jeremyrickard/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/jeremyrickard/service-catalog","description":"Consume services in Kubernetes using the Open Service Broker API","fork":true,"url":"https://api.github.com/repos/jeremyrickard/service-catalog","forks_url":"https://api.github.com/repos/jeremyrickard/service-catalog/forks","keys_url":"https://api.github.com/repos/jeremyrickard/service-catalog/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jeremyrickard/service-catalog/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jeremyrickard/service-catalog/teams","hooks_url":"https://api.github.com/repos/jeremyrickard/service-catalog/hooks","issue_events_url":"https://api.github.com/repos/jeremyrickard/service-catalog/issues/events{/number}","events_url":"https://api.github.com/repos/jeremyrickard/service-catalog/events","assignees_url":"https://api.github.com/repos/jeremyrickard/service-catalog/assignees{/user}","branches_url":"https://api.github.com/repos/jeremyrickard/service-catalog/branches{/branch}","tags_url":"https://api.github.com/repos/jeremyrickard/service-catalog/tags","blobs_url":"https://api.github.com/repos/jeremyrickard/service-catalog/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jeremyrickard/service-catalog/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jeremyrickard/service-catalog/git/refs{/sha}","trees_url":"https://api.github.com/repos/jeremyrickard/service-catalog/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jeremyrickard/service-catalog/statuses/{sha}","languages_url":"https://api.github.com/repos/jeremyrickard/service-catalog/languages","stargazers_url":"https://api.github.com/repos/jeremyrickard/service-catalog/stargazers","contributors_url":"https://api.github.com/repos/jeremyrickard/service-catalog/contributors","subscribers_url":"https://api.github.com/repos/jeremyrickard/service-catalog/subscribers","subscription_url":"https://api.github.com/repos/jeremyrickard/service-catalog/subscription","commits_url":"https://api.github.com/repos/jeremyrickard/service-catalog/commits{/sha}","git_commits_url":"https://api.github.com/repos/jeremyrickard/service-catalog/git/commits{/sha}","comments_url":"https://api.github.com/repos/jeremyrickard/service-catalog/comments{/number}","issue_comment_url":"https://api.github.com/repos/jeremyrickard/service-catalog/issues/comments{/number}","contents_url":"https://api.github.com/repos/jeremyrickard/service-catalog/contents/{+path}","compare_url":"https://api.github.com/repos/jeremyrickard/service-catalog/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jeremyrickard/service-catalog/merges","archive_url":"https://api.github.com/repos/jeremyrickard/service-catalog/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jeremyrickard/service-catalog/downloads","issues_url":"https://api.github.com/repos/jeremyrickard/service-catalog/issues{/number}","pulls_url":"https://api.github.com/repos/jeremyrickard/service-catalog/pulls{/number}","milestones_url":"https://api.github.com/repos/jeremyrickard/service-catalog/milestones{/number}","notifications_url":"https://api.github.com/repos/jeremyrickard/service-catalog/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jeremyrickard/service-catalog/labels{/name}","releases_url":"https://api.github.com/repos/jeremyrickard/service-catalog/releases{/id}","deployments_url":"https://api.github.com/repos/jeremyrickard/service-catalog/deployments","created_at":"2017-11-27T16:37:19Z","updated_at":"2018-07-17T17:41:55Z","pushed_at":"2018-07-18T02:32:48Z","git_url":"git://github.com/jeremyrickard/service-catalog.git","ssh_url":"git@github.com:jeremyrickard/service-catalog.git","clone_url":"https://github.com/jeremyrickard/service-catalog.git","svn_url":"https://github.com/jeremyrickard/service-catalog","homepage":"","size":103562,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"kubernetes-incubator:master","ref":"master","sha":"670745d6db400d8367b38618a4d798979ec4fc42","user":{"login":"kubernetes-incubator","id":20862812,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIwODYyODEy","avatar_url":"https://avatars2.githubusercontent.com/u/20862812?v=4","gravatar_id":"","url":"https://api.github.com/users/kubernetes-incubator","html_url":"https://github.com/kubernetes-incubator","followers_url":"https://api.github.com/users/kubernetes-incubator/followers","following_url":"https://api.github.com/users/kubernetes-incubator/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes-incubator/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes-incubator/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes-incubator/subscriptions","organizations_url":"https://api.github.com/users/kubernetes-incubator/orgs","repos_url":"https://api.github.com/users/kubernetes-incubator/repos","events_url":"https://api.github.com/users/kubernetes-incubator/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes-incubator/received_events","type":"Organization","site_admin":false},"repo":{"id":68024288,"node_id":"MDEwOlJlcG9zaXRvcnk2ODAyNDI4OA==","name":"service-catalog","full_name":"kubernetes-incubator/service-catalog","owner":{"login":"kubernetes-incubator","id":20862812,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIwODYyODEy","avatar_url":"https://avatars2.githubusercontent.com/u/20862812?v=4","gravatar_id":"","url":"https://api.github.com/users/kubernetes-incubator","html_url":"https://github.com/kubernetes-incubator","followers_url":"https://api.github.com/users/kubernetes-incubator/followers","following_url":"https://api.github.com/users/kubernetes-incubator/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes-incubator/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes-incubator/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes-incubator/subscriptions","organizations_url":"https://api.github.com/users/kubernetes-incubator/orgs","repos_url":"https://api.github.com/users/kubernetes-incubator/repos","events_url":"https://api.github.com/users/kubernetes-incubator/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes-incubator/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kubernetes-incubator/service-catalog","description":"Consume services in Kubernetes using the Open Service Broker API","fork":false,"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog","forks_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/forks","keys_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/teams","hooks_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/hooks","issue_events_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/events{/number}","events_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/events","assignees_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/assignees{/user}","branches_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/branches{/branch}","tags_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/tags","blobs_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/refs{/sha}","trees_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/{sha}","languages_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/languages","stargazers_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/stargazers","contributors_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/contributors","subscribers_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/subscribers","subscription_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/subscription","commits_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/commits{/sha}","git_commits_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/commits{/sha}","comments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/comments{/number}","issue_comment_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/comments{/number}","contents_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/contents/{+path}","compare_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/merges","archive_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/downloads","issues_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues{/number}","pulls_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls{/number}","milestones_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/milestones{/number}","notifications_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/labels{/name}","releases_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/releases{/id}","deployments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/deployments","created_at":"2016-09-12T15:58:39Z","updated_at":"2018-07-18T15:23:05Z","pushed_at":"2018-07-18T10:01:25Z","git_url":"git://github.com/kubernetes-incubator/service-catalog.git","ssh_url":"git@github.com:kubernetes-incubator/service-catalog.git","clone_url":"https://github.com/kubernetes-incubator/service-catalog.git","svn_url":"https://github.com/kubernetes-incubator/service-catalog","homepage":"","size":103504,"stargazers_count":559,"watchers_count":559,"language":"Go","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":192,"mirror_url":null,"archived":false,"open_issues_count":242,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":192,"open_issues":242,"watchers":559,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210"},"html":{"href":"https://github.com/kubernetes-incubator/service-catalog/pull/2210"},"issue":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/2210"},"comments":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/2210/comments"},"review_comments":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210/comments"},"review_comment":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/2210/commits"},"statuses":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/dd99f7fd77691183afbf42623162235cedcda5a7"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"carolynvs"}}