vCluster.Pro Management Roles

Management roles in vCluster.Pro are just that, roles that can be applied to users or teams that govern that user or teams permissions with respect to the vCluster.Pro instance itself. Management Roles are actually ClusterRoleTemplate objects, which in turn are just a thin wrapper around normal Kubernetes ClusterRole objects. The ClusterRoleTemplate object is then deployed as a ClusterRole to each connected cluster in the vCluster.Pro deployment.

Users can create additional Management Roles, or use one of the many default roles that exist. Some examples of default roles are as follows:

• Cluster Admin: a role that gives a user/team full admin privileges over connected clusters.
• App Viewer: a role that allows a user/team to view all Apps (but not edit them).

In many vCluster.Pro deployments you can get away with using the pre-defined Management Roles, but you are always free to create more of your own if needed.

vCluster.Pro Default Objects

If you don't see any Management Roles present in your vCluster.Pro installation, they have either been deleted, or, more likely, your vCluster.Pro instance was deployed with the DISABLE_DEFAULT environment variable set which causes vCluster.Pro to not install default objects, including the Management Roles.

Create Management Role

Management Roles can be created in the vCluster.Pro UI.

1. In the vCluster.Pro UI, select the Users field on the left-most menu bar.
2. From the User Management pane, click Management Roles button.
3. Click the button.
4. In the drawer that appears from the right, give your Management Role a name by replacing the 'my-role' placeholder name, or by updating the manifest YAML 'metadata.name' field.
5. On the Rules tab, the RBAC Rules section contains settings relating to the permissions that this role should grant. The rules here follow standard Kubernetes RBAC configuration, please see the Kubernetes [documentation](https://kubernetes.io/docs/reference/access-authn-authz/rbac/) for more details.
6. On the Rules tab, the Aggregation section allows users to include rules from other ClusterRoles into this role, by matching the additional ClusterRoles by label. This is a nice way to aggregate multiple smaller roles into a single role that can then be applied to users/teams.
7. Access allows you to define which users and teams have access to modify the role you are currently creating.
8. Click on the button.

Apply Management Role

Management Roles are not very useful if they are not applied to a user or team. Applying a Management Role can be done via the vCluster.Pro UI.

User

1. In the vCluster.Pro UI, select the Users field on the left-most menu bar.
2. From the User Management pane, click Users button.
3. Find the user you would like to apply a Management Role to from the list of users. Click the drop down arrow next to your desired user, and click theEdit button in the drop down menu.
4. In the drawer that appears from the right, select the Advanced Options configuration tab.
5. Click in the Cluster Roles For User box, find the role you would like to apply to the user and select it. You can add as many roles ad you would like from this section.
6. Click the button.

Team

1. In the vCluster.Pro UI, select the Users field on the left-most menu bar.
2. From the User Management pane, click Teams button.
3. Find the team you would like to apply a Management Role to from the list of teams. Click the drop down arrow next to your desired team, and click theEdit button in the drop down menu.
4. In the drawer that appears from the right, select the Advanced Options configuration tab.
5. Click in the Cluster Roles For Team box, find the role you would like to apply to the team and select it. You can add as many roles ad you would like from this section.
6. Click the button.