Managing Projects
The manage view supports a number of management related tasks, such as renaming a project, configuring badges, deleting branch scan data, managing Dependent Projects and deleting the entire project.
Project names can be easily set and edited when using GitHub or CI/CD integrations. When using the Manifest Scan analysis, SOOS will determine a project name based on the the name defined in the manifest, or by using the file name (if the manifest does not support package/project naming).
In certain circumstances users may wish to rename projects in the SOOS UI once they have been scanned. Project names may be changed multiple times if needed.
Learn more about SOOS Badges.
SOOS accounts are limited to 50 branches per project. If you receive the error message "You have reached the maximum number of branches for this project. (50)", you will need to delete any unneeded branches from the respective project in order to scan additional ones.
The Manage tab provides availability to bulk select and delete any branches that are no longer needed.
SOOS recommends configuring Branch Scan Configurations to ensure that only necessary branches will be scanned without having to setup complex CI/CD rules to manage which branches are scanned.
A retention period can also be configured so that certain branch scans will be automatically purge after a specified period of time.
Deleting the last remaining branch for a project will not delete the project from the account.
Learn more about Dependent Projects.
To delete a selected project, navigate to the bottom of the Manage tab...to the "Danger Zone".
Select Delete Project and confirm the action in the pop-up message.
Here are some things to consider:
- Once you delete a branch or project, the scan data is unrecoverable - once it's gone, it's gone!
- Please ensure that you do not need access to the scan history before you make the decision to delete!
- You may want to export necessary SBOMs or other reports before you perform the deletion.
- Be smart about permissions granted to the users added to your account. Any user with the permission to modify projects is also able to delete branch scans.
- Developer and Administrator users are the only users with this access. Make sure that only users who can make this judgement call are assigned these permission levels.
