This is an archived version of the documentation for SonarQube-7.3.
See the Latest Documentation for current functionality.

Applications

Applications are available as part of the Enterprise Edition.

What is an Application?

An Application is an aggregation of projects into a synthetic project.

Why would I want to use an Application?

Assume you have a set of projects which has been split for technical reasons, but which shares a lifecycle; they interact directly in production and are always released together. With an Application, they can be treated as a single entity in SonarQube with a unified Project Homepage, Issues list, Measures space, and most importantly: Quality Gate.

How is this different from a Portfolio?

Applications and Portfolios are both aggregations of projects, but they have different goals and therefore different presentations. A Portfolio is designed to be a very high-level, executive overview that shows how a package of projects that may only be tangentially related are doing quality-wise, and what the trends are. Applications allow you to see your set of projects as a larger, overall meta-project. For instance, because all the projects in an application ship together, if one of them isn't releasable then none of them are, and an Application's consolidated Quality Gate gives you an immediate summary of what must be fixed across all projects in order to allow you to release the set.

How do I set up an Application?

Applications are created and edited in the global Portfolio administration interface: Administration > Configuration > Portfolios. For more, see Configuring Portfolios and Applications. Applications must be created initially by a user with global administration rights, but after set-up, administration of an individual Application can be delegated to other users.

Okay, I made an Application, but it doesn't have any data in it. Now what?

An Application is automatically re-calculated after each analysis of one of its projects. If you want immediate (re)calculation, a user with administration rights on the Application can use the Recompute button in the Application-level Administration > Edit Definition interface. The global Portfolio administration interface: Administration > Configuration > Portfolios offers the ability to queue recomputation of all Applications and Portfolios at once.

I use branch analysis with my projects. Can I do that in Applications too?

Long-lived Branches are available for applications. They allow you to aggregate long-lived branches from the projects in an application.

How do I get an Application branch?

Once an Application has been set up, anyone with administration rights on the Application can manually create a new branch in the Administration > Edit Definition interface. Branches can also be managed from the global Administration > Configuration > Portfolios interface. For each Application branch you can choose which project branch should be included, or whether the project should be represented in the branch at all.