Skip to main content

Groups

Groups are how you assign the same VMO role and Kubernetes access to many users at once. PaletteAI VM Launchpad stores groups in Keycloak and, when a group is bound to a VMO role, automatically manages the corresponding Kubernetes ClusterRoleBindings and RoleBindings. This guide covers viewing, creating, editing, and deleting groups.

Prerequisites​

  • A cluster created using VM Launchpad. Refer to Install VM Launchpad for guidance.

  • An account with the Platform Admin VMO role, or membership in a group mapped to Platform Admin.

Groups Page​

From the left main menu, select Settings > Access Management > Groups to view all groups in the appliance.

The Groups table lists the following columns.

ColumnDescription
Group NameThe group name.
PathThe Keycloak group path.
MembersThe number of users in the group.
Kubernetes AccessThe Kubernetes ClusterRole bound to the group, shown as a pill.
VMO RoleThe VMO IAM role assigned to the group.
ActionsRow actions to edit or delete the group.

Select a column header to sort. Use the Filter rows search box to filter by any field.

Create a Group​

  1. From the left main menu, select Settings > Access Management > Groups.

  2. Select Create Group.

  3. Complete the following fields.

    FieldDescription
    Group NameRequired. Follow DNS label rules: lowercase alphanumeric characters and hyphens only. Up to 128 characters.
    NamespacesSelect Cluster-wide (all namespaces) to bind the group across the cluster, or select one or more specific namespaces from the list.
    VMO Role(Optional) Assign a VMO platform role to all members of the group. Select None to create a group without a VMO role.

    The following table describes each VMO role.

    RoleDescription
    Platform AdminFull control of Virtual Machine Orchestrator. All permissions, all namespaces.
    EditorBuild VM workflows and templates. Packages, templates, and dashboards (read and write).
    OperatorDay-to-day VM operations. Templates and dashboards (read and write), monitoring, storage (read).
    ViewerRead-only access. Templates, packages, and dashboards (read).
  4. Select Create.

info

If a VMO role is selected, a namespace scope (cluster-wide or at least one namespace) is required. VM Launchpad automatically binds the matching Kubernetes ClusterRole to the group in each selected scope.

VM Launchpad selects the matching Kubernetes ClusterRole automatically based on the VMO role you assign. The mapping is fixed.

VMO RoleKubernetes ClusterRole
Platform Adminspectro-vm-admin
Editorspectro-vm-power-user
Operatorspectro-vm-user
Viewerspectro-vm-viewer

Edit a Group​

  1. From the left main menu, select Settings > Access Management > Groups.

  2. In the Actions column, select the pencil icon for the group you want to edit, or select the group row to open its detail view.

  3. Update any of the following:

    • Namespaces - Change the namespace scope. Select Cluster-wide (all namespaces) or select one or more specific namespaces.

    • VMO Role - Change the VMO platform role assigned to group members. When you change the role, the corresponding Kubernetes ClusterRole is rebound automatically.

    • Members - Add or remove users from the group. Type a username to search, or select a user from the list to add them. Select the × on a member pill to remove them.

  4. Select Done.

info

Member changes take effect on the user's next sign-in or token refresh. VM Launchpad applies Kubernetes access changes immediately and creates or revokes ClusterRoleBindings and RoleBindings in the cluster. Existing API keys keep their previous permissions until the user signs in again. Refer to API Keys.

info

When a user belongs to any group that carries a VMO role, the group mappings determine their permissions and the role assigned to the user directly is ignored. A user in several mapped groups receives the combined permissions of those groups, so removing one group does not revoke permissions another group grants. Refer to How Effective Permissions Are Calculated for details.

Delete Groups​

You can delete a single group or select many groups to delete in a single operation.

Delete a Single Group​

  1. From the left main menu, select Settings > Access Management > Groups.

  2. In the Actions column, select the trash icon for the group, or right-click the row and select Delete Group.

  3. Type the group name to confirm.

  4. Select Delete.

Delete Groups in Bulk​

  1. From the left main menu, select Settings > Access Management > Groups.

  2. Select the checkbox for each group you want to delete. Use the header checkbox to select every group on the current page.

  3. Select the Delete button in the bulk actions toolbar at the top of the table.

  4. For a single selected group, type the group name to confirm. For many groups, type delete to confirm.

  5. A progress indicator tracks each deletion. VM Launchpad lists any failures after the operation completes.

warning

Deleting a group removes it from Keycloak and automatically revokes all associated access. VM Launchpad cleans up the VMO role mapping and any Kubernetes ClusterRoleBindings or RoleBindings bound to the group in the same operation. This prevents orphaned bindings from granting cluster access to future users who later join a group with the same name.

Next Steps​

  • Create users and assign them to your new groups. Refer to Users.