Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Slimming down Helm chart k8s api-server privileges (RBAC) #661

Open
3 tasks
consideRatio opened this issue Dec 21, 2022 · 8 comments
Open
3 tasks

Slimming down Helm chart k8s api-server privileges (RBAC) #661

consideRatio opened this issue Dec 21, 2022 · 8 comments

Comments

@consideRatio
Copy link
Collaborator

consideRatio commented Dec 21, 2022

Currently the Helm chart provides more cluster wide permissions against the k8s api-server than may be needed, depending on configuration of dask-gateway.

The following PRs are opened related to this, but I felt that reviewing them was focusing on technical details before I had considered the configuration API that would make to support. Due to that, I've opened this issue to brainstorm and try to establish what I'm looking for.

Situations

The helm chart is installed in one location which provides a dask-gateway-controller, dask-gateway-server (api pod), dask-gateway-proxy (traefik pod). They should be provided with the relevant permissions to create and interact with the k8s resources created.

Thanks to configuration, on demand created Dask clusters can be created in different namespaces. Due to that, we provide permissions to work with resources in all namespaces.

1. Local namespace: clusters created only in helm chart local namespace

Reduced permissions required.

With local I mean where the daks-gateway Helm chart was installed.

2. Other namespace: clusters created only in another pre-configured namespace

Reduced permissions required, but not just like as if everything was put in a local namespace.

3. Any namespace: clusters created in any namespace

Full cluster wide permissions required. My assumption is that it is not possible to provide RBAC resources defining permissions to namespaces matching a certain naming pattern or having a certain label, if that is incorrect we can do something smarter here as well.

Current configuration options

Future configuration options?

What we currently have seems sufficient to me.

  • If someone wants to accomplish a resitrction of permissions when a single namespace is to be used, we can require the helm chart configuration gateway.backend.namespace is used (as compared to setting c.KubeConfigCluster.namespace = "something" in a custom Python config file provided to dask-gateway-server).
  • If someone wants to accomplish a restriction of permissions in situations where users are provided their own namespaces etc if such feature would be supported, we should go with cluster wide permissions.

Implementation ideas

  • I think when someone configures the gateway.backend.namespace, we should reduce the permissions to that.

  • I think when someone doesn't configure the gateway.backend.namespace, we should reduce the permissions to the local namespace.

    A secure default is far better than an unsecure default. At the same time, a user should be able to request cluster wide permissions so that c.KubeClusterConfig.namespace` can be dynamically updated and still work.

    So, we would need another Helm char configuration option to provide cluster wide permissions. I note that rbac.scope is used by the prometheus helm chart.

With all this considered, I think we should let gateway.backend.namespace just be something we pass through to the Python configuration c.KubeConfigCluster.namespace, and let rbac.scope decide if we provide cluster wide or namespace scoped RBAC permissions. That way, we have sufficient flexibility I think.

Towards resolving this

  • Propose a rbac.scope like configuration syntax. It should support cluster wide mode and single namespace mode, support for multiple namespaces seems like more complexity than merited in my mind.
  • Seek and reach agreement on configuration syntax
  • Implement it technically and make sure we have at least one test case for this as well in our CI system
@holzman
Copy link
Contributor

holzman commented Dec 21, 2022

I agree that supporting multiple namespaces is not worth the additional complexity.

Do we actually need to support dynamic updates to c.KubeClusterConfig.namespace? Without it, things are considerably simpler; the downside, of course, is that you lose track of resources in the old namespace. That could be mitigated with emitting a noisy warning/error on helm upgrade.

If we do want to support dynamic updates - the proposal above LGTM.

@consideRatio
Copy link
Collaborator Author

consideRatio commented Dec 27, 2022

Hmmm your response didn't make me understand clearly what you meant, so I'll try to define some terminology. Also the configuration isn't defined by my response besides an idea about it should be nested under rbac the helm chart configuration, for example using the key scope, but its not clear what structure etc makes sense or is common in other helm charts.

Static / Dynamic terminology clarified

  1. Static credentials: k8s api-server RBAC credentials as resources like (Cluster)Role / (Cluster)RoleBinding / ServiceAccount created as part of installing/upgrading the Helm chart.

  2. Dynamic credentials: like static credentials above except they are dynamically created by the software deployed by the Helm chart.

  3. Dynamic configuration: where the dask-gateway client user or dask-gateway-server admin has enabled a way to set c.KubeClusterConfig.namespace for specific DaskCluster's created, so that they may end up in different namespaces without us knowing what ahead of time.

What to go for?

I think we should support static credentials and dynamic configuration, but not dynamic credentials. Support for dynamic configuration would be implemented with static credentials providing ClusterRole access, while the chart local namespace and other namespace situations would be supported by static credentials with Role resources where possible - created in one specific namespace.

The Helm chart configuration we add should be located under rbac in values.yaml as it only relates to the Helm chart and not the software deployed. I propose more specifically now:

  • rbac.clusterWideOperation, a boolean deciding if we are providing full permissions as we are now, or if we should only provide it to work against a specific namespace as configured via gateway.backend.namespace.

    With clusterWideOperation set, permissions should be retained as they are now. With it false, permissions should be sufficient to manage dask clusters in gateway.backend.namespace (the chart local namespace if unset)

RBAC resources currently provided

Practical changes

  • Identify what RBAC resources and verbs we need to always have in ClusterRole mode and put them in a dedicated ClusterRole / ClusterRoleBinding
  • The other resources should be separate and provided a metadata.namespace if needed to be created in their own dedicated namespace.

I'm not fully confident on where things are created etc, but I think this is doable. Here is relevant documentation. I think its fair to ask that the using a dedicated namespace also manually creates it ahead of time.

I suspect #626 may be almost doing exactly this, but I'm not sure.

@holzman
Copy link
Contributor

holzman commented Jan 12, 2023

I think we should support static credentials and dynamic configuration, but not dynamic credentials.

Thanks - I didn't understand this from the previous discussion. The only way to support dynamic configuration is with non-namespaced RBAC, since the DaskClusters may spawn in arbitrary namespaces.

I think that rbac.clusterWideOperation is a clear description for a boolean.

Practically, this means we will have three variations on RBAC configurations bound to the ServiceAccount in the chart-local namespace:

rbac.cWO gateway.backend.namespace RBAC
False unset or chart-local Role/Rolebinding in chart-local
False other-namespace Role/Rolebinding in other-namespace
True N/A ClusterRole/ClusterBinding

An addition to the "Practical Changes" section above: in addition to modifying the chart, there are also changes in code. For example: kubernetes/backend.py#L374 would need to call list_namespaced_custom_object for the first and second cases above.

@holzman
Copy link
Contributor

holzman commented Sep 18, 2023

@consideRatio: I think we all got busy with higher priority stuff for a while, but it's come back on my radar as there's another site that's interested in namespaced dask-gateway (@clundst).

Are you OK with my comment above and should we proceed on a generating a PR?

I'm also a little fuzzy on the 2nd use case above: where gateway.backend.namespace != .Release.namespace. Do we deploy everything into the release namespace except daskcluster objects?

@holzman
Copy link
Contributor

holzman commented Dec 19, 2023

@consideRatio: been a few months -- please let me know if you're OK with the approach before I sync up a PR against the current main.

@TomAugspurger
Copy link
Member

TomAugspurger commented Dec 20, 2023 via email

@consideRatio
Copy link
Collaborator Author

Looking through this again, okay this sounds reasonable @holzman.

Here are some thoughts summarized:

  1. With rbac.clusterWideOperation=true (the default), we retain existing functionality
  2. With rbac.clusterWideOperation=false we get a new kind of behavior that is influenced by gateway.backend.namespace
    • no ClusterRole/ClusterRuleBinding resources should need to be created, the Role/RoleBinding resources should suffice
    • I think we only need Role/RoleBinding resources to live in the namespace where the dask cluster resources are created, but I'm not sure, maybe the gateway-api/traefik/controller pod needs to do something in the namespace they run as well?

We've deliberated on using gateway.backend.namespace to create the RBAC resources here, but what we create influences traefik, the controller, and the gateway-api pod - this is unexpected given that this configuration is nested under gateway.

I propose the following config:

  • rbac.manageAnyNamespace, if true we create ClusterRole/ClusterRoleBindings and rbac.managedNamespaces is to be ignored
  • rbac.managedNamespaces, specifies namespaces where we provide permissions to create dask clusters in, where leaving it unset implies the release namespace (where the chart was installed)

An example config could then be rbac.manageAnyNamespace=false rbac.managedNamespaces=[my-dask-clusters] and gateway.backend.namespace=my-dask-clusters.


I'd like the PR implementing this to test specifying some other namespace in gateway.backend.namespace and not using cluster wide operation. There is a test right now that runs dask-clusters in another namespace already, that test can include specifying rbac.manageAnyNamespace to false. So I think this part could be quick and easy.

Overall, I think the PR could be quite small and simple: add the new config, transition from ClusterRole(Binding) to Role(Binding) if rbac.manageAnyNamespace=false and render resources per namespace specified.

If this is done, I think the test automation we have already will clarify if it works or not.

@holzman
Copy link
Contributor

holzman commented Apr 2, 2024

We were discussing this in our team meeting today. Just wanted to let you know that we haven't abandoned it, and I'll find some time in the next few weeks to work on this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants