Skip to content

[FEATURE]: Add reconfigure-group-migration command #880

@Ben-Roche-work

Description

@Ben-Roche-work

Is there an existing issue for this?

  • I have searched the existing issues

Problem statement

When running databricks labs install ucx for the first time, a user is prompted to enter the workspace groups to migrate. If no groups are entered, it is challenging to retrospectively choose which workspace groups to migrate. This is because:

  • It is not clear which parameter(s) should be manually added to the config.yml file to define the comma-separated list of groups to migrate
  • There is a lack of examples for the config.yml template in ucx/docs/*

Additionally, this feature is useful as admins may decide to re-prioritize workspace groups migration based on the result of running the [UCX] assessment workflow; certain groups may have permissions on workspace objects that are more difficult to upgrade than others, resulting in a re-prioritization of groups due to perceived risk (e.g., certain group has very long list of tacls on legacy assets).

Proposed Solution

Create databricks labs ucx workspace-groups-to-migrate command. It should:

  • Show which workspace groups are currently listed to be migrated
  • Ask the user if they want to update the current list
  • Prompt the user for a comma separated list of workspace group names.
  • Update the config.yml file in the workspace to reflect the listed group names.

Additional Context

When running databricks labs ucx validate-groups-membership or the [UCX] migrate-groups workflow, I am getting 0 WorkspaceGroup's returned. I believe this to be due to missing parameters in the config.yml file created during install (databricks labs install ucx). I believe this is because a comma-separated list of workspace groups was not specified during install, and therefore the relevant parameter was omitted from the workspace config.yml file.

When running databricks labs groups list with the same PAT token, I am getting 2 (all) workspace groups returned, so this is specifically an issue with ucx and not auth.

Metadata

Metadata

Assignees

No one assigned

    Labels

    feat/cliCLI commandsgood first issueGood for newcomersmigrate/groupsCorresponds to Migrate Groups Step of go/uc/upgrade

    Projects

    Status

    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions