Viewing Projects in a Dashboard View
Platform Admins can view all of the projects in the Projects Dashboard by selecting All from the taskbar. A project summary lists the Project Admins assigned to the project and the project quota status. In addition, the dashboard displays quota status alerts, which indicate the status of the project.
Modifying a Project
Platform Admins can change the basic settings of a project by clicking the Edit Settings above the project.
Managing Storage Quotas
Only Platform Admins can set storage quotas on a project.
By default, projects are set with an unlimited storage quota. The Storage Quota functions differently based on JFrog Platform Environment:
- In a self-hosted environment, Platform Admins can limit the space allocated for uploading repositories by setting storage quotas at the project level when creating a new project.
- In a cloud-based environment, Platform Admins can set a limit for informational purposes by selecting the Deploy Beyond Limit field.
To help Project Admins manage storage quotas, a set of quota alerts are displayed within the Project dashboard in the UI. These alerts are displayed when a project reaches 75 percent capacity and at 100 percent, whereby no additional artifacts can be deployed.
At the project level, under the Storage tab in the left pane, you can view the artifacts size for each repository in the project.
Sharing Repositories Across Multiple Projects
Platform Admins can share local and remote repositories across multiple projects to allow members in more than one project to have access to the repository. A classic use case for sharing a repository is the need to share an external remote repository (for instance, DockerHub) with multiple projects. A repository can be shared with a single project or across all projects. Once the repository is shared, it is added to the target project/s and tagged as Shared in the Repositories page. In addition to the managing shares in the UI, you can also set share projects using the REST API. For more information, see Share Repository with All Projects.
Shared Repositories Rules and Guidelines
- A Repository can be shared only after it has been created.
- Project Members are granted actions to the shared repo according to their Roles and Role actions assigned in the target project.
- Only the owner of the shared repository can delete the shared repository. A Shared repository can be removed from the project, but this will not trigger the deletion of the repository.
- The Storage Quota is calculated for the source repository of the shared repository.
To share a repository:
- In the Administration module, select Projects and navigate to [Project_Name] | Repositories and click the Share icon.
- You have the option to share the selected repository:
- Across all the projects, by selecting the Auto share with all projects field.
- Only with specific projects, by Project Name from the projects list.
- Click Save.
Assigning Multiple Projects to Resources
You can assign projects to resources from the central resources page. This is useful if you have upgraded from a previous version of the JFrog Platform and your resources are set as unassigned and you need to assign multiple unassigned resources to projects.
To assign projects to repositories:
- In the Administration module, select Projects | Unassigned tab and click Go to unassigned repositories.
The Repositories page opens with an Unassigned filter applied.
- In Repositories, select one of the following: Local | Remote | Virtual | Distribution.
Deleting a Project
Platform Admins can delete a project that does not contain any assigned or available resources.
To delete a project, you will first need to remove or reassign the project's resources to another project.
Removing a Project Member
Remove a project member from a project by removing the projects's role assignment of that Project member. This will automatically remove the project member from the project.