Getting Started with Projects
After familiarizing yourself with the terminology and concepts, follow these steps according to your status:
- For a New JFrog Platform Environment
- Set up Global roles and members, see Managing Project Roles and Members.
- Set up a new Project, create Project roles (optional) and assign users/groups as members in the project, and add resources, see Creating a Project.
- Start to manage your projects. See Managing Projects.
- For an upgraded (Existing )JFrog Platform: proceed to Onboarding Projects in an Upgraded Environment.
Viewing Projects in the JFrog Platform
The project-related features in the JFrog Platform UI are:
1 | In the Administration module, Platform Admins and Project Admins can view a Projects dropdown on the taskbar. The All dropdown lists all the projects created by the Platform Admin, including an All entry, displaying the global project settings for the entire platform. |
2 | A Projects tab is displayed in the Administration module left pane. The Platform Admin has access to this page and can view and create projects. |
3 | The Global Roles sub tab is added under Access and Identity to the Administration module. The Platform Administrator can define Global roles that will be available across the projects. |
Selecting an individual project, displays these views:
4 | A Project Overview page allowing the Project Admin to review and manage project members and resources. |
5 | The Roles page is added to the Project view in the Administration module, which allows Project Admin to create roles that will be available for the selected project only. |
Onboarding Projects in an Upgraded Environment
From Artifactory 7.17.4, Projects is enabled by default in the JFrog Platform for Enterprise and Enterprise+ users. The upgraded resources - packages, builds and Pipelines are saved under the 'Unassigned' tab and not yet allocated to specific projects. The resources in the Application module - packages, builds, Release Bundles, and Pipelines are displayed according to the predefined permission targets set prior to the upgrade.
Xray version 3.21.2 is now supported in Projects. When upgrading to Artifactory 7.17.4 and Xray 3.21.2, all Xray related UI entities will appear in the scope of Projects. All previously created Watches and Policies will appear in the Watches & Policies page as Global Watches and Global Policies meaning they are not assigned to a project. To create a Project Watch and Project Policy, you will have to create them in the project scope. To learn more about Xray in Projects, see Projects Concepts and Terminology.
To onboard your existing users or group and resources into projects, do the following:
- Set up a new Project.
- Assign Platform users and groups with Roles in the Project.
- Assign your existing repositories to the Project.
- Remove the current permission targets from your reassigned resources.
- Navigate to Access and Identity | Permissions and click the required Permission Target in the the Permission Target Name column.
- In the Edit Permissions Target page, modify the resource assignment in the Repositories tab. For more information, see Permissions.
- Assign your resources to the relevant Project.
- Click Go to unassigned repositories.
From the Administration module, under Repositories | Repositories, select a repository and select a Project from the Projects list.
- Click Go to unassigned repositories.