1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
---
title: Managing Portfolios
url: /project-administration/managing-portfolios/
---
*Portfolios are available starting in [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html).*
This page has information on managing and setting up Portfolios. For a general overview of Portfolios, see the [Portfolios](/user-guide/portfolios/) page in the User Guide.
## Permissions
### Creating Portfolios
Users with the Create Portfolios permission and global administrators can create Portfolios:
* **Create Portfolios permission** – Users with the Create Portfolios permission (granted at the global level at **Administration > Security > Global Permissions**) can create Portfolios by clicking the **Create Portfolio** button in the upper-right corner of the Portfolios homepage.
* **Global Administrators** – In addition to creating Portfolios from the Portfolios homepage, global administrators (with the global Administer System permission granted at [**Administration > Security > Global Permissions**](/#sonarqube-admin#/admin/permissions)) create portfolios from the overall Portfolio administration interface at **Administration > Configuration > Portfolios**.
### Editing Portfolios
Users need to have either **Administer** permissions for any Portfolios that they want to edit or the global **Administer System** permission.
[[info]]
|Giving a user **Administer** permission to an existing portfolio that was created using manual selection allows that user to see all project names and keys for the projects in the Portfolio, even if the user doesn't have access to those projects.
## Populating Portfolios
After you've created a portfolio, you can populate it with projects, applications, and other portfolios.
[[info]]
|**Uniqueness in portfolios**<br/><br/>
|Project branches, applications, and portfolios can only appear once in any given hierarchy in order to avoid magnifying their impacts on aggregated ratings. The portfolio configuration interface has some logic to prevent obvious duplications (such as manually adding the same project). However, in case of more subtle duplications (for example, due to regular expression or other bulk definition), the calculation of that portfolio will fail with a helpful error message.
### Adding another Portfolio to a Portfolio
To add another Portfolio to your Portfolio, from **[Administration > Configuration > Portfolios](/#sonarqube-admin#/admin/extension/governance/views_console)** click the **Add Portfolio** button at the top of the third column, and choose:
* **Standard** - This option allows you to create a new Portfolio from scratch and add it to the currently selected Portfolio. Once created, you can add projects, applications, and more layers of portfolios.
* **Local Reference** - This option allows you to reference an existing Portfolio in the currently selected Portfolio. Once added, it is not editable here, but must be chosen in the left-most column to be edited.
### Adding a project to a Portfolio
To add projects to a Portfolio, navigate to the Portfolio you want to add a project to. Select **Edit Definition** from **Portfolio Settings**. Click the pencil icon next to **Project selection mode**, and select one of the following options:
* **Manual** – choose the projects individually.
* **Tags** - select one or more project tags. Projects with those tags will automatically be included in the Portfolio.
* **Regular Expression** – specify a regular expression and projects with a matching name OR key will be included.
* **All Projects** – choose this option to add all projects not already included in this Portfolio (directly or via -Portfolio).
By default, adding a project to a portfolio shows the analysis of the project's main branch. See the following section if you want to select a non-main branch or multiple branches for your project.
#### **Selecting specific project branches for your portfolio**
In some situations, you may want to either monitor a project branch that's not your main branch or multiple project branches. For example:
* Your project has multiple release branches, and you want to monitor them all in a Portfolio.
* Your project's main branch isn't your release branch, and you want to monitor your release branch in your Portfolio.
To specify a project branch or branches to monitor in your portfolios, you can do the following:
* **Manual** – You can use manual selection to select one or multiple project branches. To do this:
1. From the Portfolio you want to edit, go to **Portfolio Settings > Edit Definition**.
2. Click the pencil icon next to the **Project selection mode**, set **Manual** as your **Project Selection Mode**, and click **Save**.
3. click the pencil icon next to the project you want to monitor.
4. Select the branches you want to monitor. If you don't select a branch, the main branch is selected by default.
* **Tags, Regular Expressions, All Remaining Projects** – To specify a branch to monitor in your portfolios using the tags, regular expressions, or all remaining projects options, do the following:
1. From the Portfolio you want to edit, go to **Portfolio Settings > Edit Definition**.
2. Click the pencil icon next to the **Project selection mode**, and select your desired **Project Selection Mode**.
3. Enter the name of the branch you want to monitor in the **Branch selection** field, and click **Save**.
### Adding Applications to a Portfolio
To add an Application to a Portfolio, make sure your Application is [already created](/user-guide/applications/). Then:
1. Navigate to the Portfolios configuration page by going to **[Administration > Configuration > Portfolios](/#sonarqube-admint#/admin/extension/governance/views_console/)**.
2. Select the Portfolio where you want to add your Application.
3. Click **Add Portfolio**.
4. Select **Local Reference**.
5. Choose your Application from the drop-down menu and click **Add**.
## Calculation
By default, Portfolios are queued to be recalculated after each analysis of an included project. For each relevant Portfolio, a “Background Task” is created, and you can follow the progress on each in the **[Administration > Projects > Background Tasks](/#sonarqube-admin#/admin/background_tasks)** by looking at the logs available for each item.
If you're having performance issues related to the automatic recalculation of large portfolios, you can specify the hour(s) at which you want them to be recalculated at **[Administration > Portfolios > Recalculation](/#sonarqube-admin#/admin/settings?category=portfolios)**. Portfolios are queued to be recalculated at the beginning of the hour(s) that you specify.
## Elasticsearch reindexing
During Elasticsearch reindexing due to disaster recovery or an upgrade, you won't have access to Portfolios until all projects are indexed.
|
