From: michaelbirnstiehl Date: Tue, 9 Feb 2021 23:45:19 +0000 (-0600) Subject: DOCS update ALM integration for validation X-Git-Tag: 8.7.0.41497~13 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=3ec7fe7bfb070143fee123fa242279454251f709;p=sonarqube.git DOCS update ALM integration for validation --- diff --git a/server/sonar-docs/src/pages/analysis/azuredevops-integration.md b/server/sonar-docs/src/pages/analysis/azuredevops-integration.md index 731b5c4d995..ebfc4d2e8cd 100644 --- a/server/sonar-docs/src/pages/analysis/azuredevops-integration.md +++ b/server/sonar-docs/src/pages/analysis/azuredevops-integration.md @@ -261,7 +261,7 @@ Then, follow the steps in SonarQube to analyze your project. The project setting To set up a manually created or existing project or a project that's part of a mono repository, see the instructions in the following sections. ### Adding pull request decoration to a manually created or existing project -To add pull request decoration to a manually created or existing project, after you've updated your global ALM Integration settings as shown in the **Importing your Azure DevOps repositories into SonarQube** section above, set your project settings at **Project Settings > General Settings > Pull Request Decoration**. +To add pull request decoration to a manually created or existing project, make sure your global ALM Integration settings are set as shown above in the **Importing your Azure DevOps repositories into SonarQube** section, and set the following project settings at **Project Settings > General Settings > Pull Request Decoration**: From here, set your: @@ -273,19 +273,19 @@ From here, set your: [[collapse]] | ## Adding pull request decoration to projects that are part of a mono repository | -| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same repository. You'll need to set up pull request decoration for each SonarQube project. +| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same Azure DevOps repository. You'll need to set up pull request decoration for each SonarQube project that is part of a mono repository. | -| In Developer Edition, analyzing a pull request for a project that is part of a mono repository will override the current pull request decoration even if you're analyzing a different project. +| Pull request decoration for a mono repository setup is supported starting in [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html). Decorating pull requests in Developer Edition may lead to unexpected behavior. | -| In [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) and above, you can show pull request decoration for multiple projects simultaneously. +| To add pull request decoration to a project that's part of a mono repository, set your project up manually as shown in the **Adding pull request decoration to a manually created or existing project** above. You also need to set the **Enable mono repository support** setting to true. | -| To do this, set your global ALM Integration settings as shown in the **Importing your Azure DevOps repositories into SonarQube** section above, and set your project settings at **Project Settings > General Settings > Pull Request Decoration**. +| After setting your project settings, you need to ensure the correct project is being analyzed by adjusting the analysis scope and pass your project names to the scanner. See the following sections for more information. | -| From here, set your: +| ### Ensuring the correct project is analyzed +| You need to adjust the analysis scope to make sure SonarQube doesn't analyze code from other projects in your mono repository. To do this set up a **Source File Inclusion** for your project at **Project Settings > Analysis Scope** with a pattern that will only include files from the appropriate folder. For example, adding `./MyFolderName/**/*` to your inclusions would only include analysis of code in the `MyFolderName` folder. See [Narrowing the Focus](/project-administration/narrowing-the-focus/) for more information on setting your analysis scope. | -| - **Project name** -| - **Repository name** -| - **Enable mono repository support** – (Enterprise Edition and above only) Set this to true +| ### Passing project names to the scanner +| Because of the nature of a mono repository, SonarQube scanners might read all project names of your mono repository as identical. To avoid having multiple projects with the same name, you need to pass the `sonar.projectName` parameter to the scanner. For example, if you're using the Maven scanner, you would pass `mvn sonar:sonar -Dsonar.projectName=YourProjectName`. [[collapse]] | ## Configuring multiple ALM instances diff --git a/server/sonar-docs/src/pages/analysis/bitbucket-integration.md b/server/sonar-docs/src/pages/analysis/bitbucket-integration.md index 8e70a497b30..6c71ffe32b0 100644 --- a/server/sonar-docs/src/pages/analysis/bitbucket-integration.md +++ b/server/sonar-docs/src/pages/analysis/bitbucket-integration.md @@ -50,9 +50,7 @@ After you've set up SonarQube to import your Bitbucket Server repositories as sh Then, follow the steps in SonarQube to analyze your project. The project settings for pull request decoration are set automatically. ### Adding pull request decoration to a manually created or existing project -To add pull request decoration to a manually created or existing project, after you've updated your global ALM Integration settings as shown above, set your project settings at **Project Settings > General Settings > Pull Request Decoration**. - -From here, set your: +To add pull request decoration to a manually created or existing project, make sure your global ALM Integration settings are configured as shown in the **Importing your Bitbucket Server repositories into SonarQube** section above, and set the following project settings at **Project Settings > General Settings > Pull Request Decoration**: - **Configuration name** – The configuration name that corresponds to your ALM instance. - **Project Key** – the project key is part of your BitBucket Server repository URL (.../projects/**{KEY}**/repos/{SLUG}/browse). @@ -63,20 +61,19 @@ From here, set your: [[collapse]] | ## Adding pull request decoration to projects that are part of a mono repository | -| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same repository. You'll need to set up pull request decoration for each SonarQube project. +| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same BitBucket Server repository. You'll need to set up pull request decoration for each SonarQube project that is part of a mono repository. | -| In Developer Edition, analyzing a pull request for a project that is part of a mono repository will override the current pull request decoration even if you're analyzing a different project. +| Pull request decoration for a mono repository setup is supported starting in [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html). Decorating pull requests in Developer Edition might lead to unexpected behavior. | -| In [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) and above, you can show pull request decoration for multiple projects simultaneously. +| To add pull request decoration to a project that's part of a mono repository, set your project up manually as shown in the **Adding pull request decoration to a manually created or existing project** above. You also need to set the **Enable mono repository support** setting to true. | -| To do this, set your global ALM Integration settings as shown in the **Importing your Bitbucket Server repositories into SonarQube** section above, and set your project settings at **Project Settings > General Settings > Pull Request Decoration**. +| After setting your project settings, you need to ensure the correct project is being analyzed by adjusting the analysis scope and pass your project names to the scanner. See the following sections for more information. | -| From here, set your: +| ### Ensuring the correct project is analyzed +| You need to adjust the analysis scope to make sure SonarQube doesn't analyze code from other projects in your mono repository. To do this set up a **Source File Inclusion** for your project at **Project Settings > Analysis Scope** with a pattern that will only include files from the appropriate folder. For example, adding `./MyFolderName/**/*` to your inclusions would only include analysis of code in the `MyFolderName` folder. See [Narrowing the Focus](/project-administration/narrowing-the-focus/) for more information on setting your analysis scope. | -| - **Configuration name** – The configuration name that corresponds to your ALM instance. -| - **Project Key** – Part of your BitBucket Server repository URL (.../projects/**{KEY}**/repos/{SLUG}/browse). -| - **Repo Slug** – Part of your BitBucket Server repository URL (.../projects/{KEY}/repos/**{SLUG}**/browse). -| - **Enable mono repository support** – (Enterprise Edition and above only) Set this to true +| ### Passing project names to the scanner +| Because of the nature of a mono repository, SonarQube scanners might read all project names of your mono repository as identical. To avoid having multiple projects with the same name, you need to pass the `sonar.projectName` parameter to the scanner. For example, if you're using the Maven scanner, you would pass `mvn sonar:sonar -Dsonar.projectName=YourProjectName`. [[collapse]] | ## Configuring multiple ALM instances diff --git a/server/sonar-docs/src/pages/analysis/github-integration.md b/server/sonar-docs/src/pages/analysis/github-integration.md index e1f25aba179..05c3ef9167f 100644 --- a/server/sonar-docs/src/pages/analysis/github-integration.md +++ b/server/sonar-docs/src/pages/analysis/github-integration.md @@ -39,12 +39,12 @@ Specify the following settings in your app: - **Webhook URL** – Your instance's base URL. For example, `https://yourinstance.sonarqube.com`. - Grant access for the following **Repository permissions**: - | Permission | Access | - |---------------------|--------------| - | Checks | Read & write | - | **GitHub Enterprise:** Repository metadata
**GitHub.com:** Metadata
(this setting is automatically set by GitHub)| Read-only | - | Pull Requests | Read & write | - | Commit statuses | Read-only | + | Permission | Access | + |---------------------|--------------| + | Checks | Read & write | + | **GitHub Enterprise:** Repository metadata
**GitHub.com:** Metadata
(this setting is automatically set by GitHub)| Read-only | + | Pull Requests | Read & write | + | Commit statuses | Read-only | - Under "Where can this GitHub App be installed?," select **Any account**. @@ -79,9 +79,7 @@ The simplest way to add pull request decoration is by adding a project from GitH Then, follow the steps in SonarQube to analyze your project. The project settings for pull request decoration are set automatically. ### Adding pull request decoration to a manually created or existing project -To add pull request decoration to a manually created or existing project, after you've created and installed your GitHub App and updated your global ALM Integration settings as shown above, set your project settings at **Project Settings > General Settings > Pull Request Decoration**. - -From here, set your: +To add pull request decoration to a manually created or existing project, after you've created and installed your GitHub App and updated your global ALM Integration settings as shown in the **Importing your GitHub repositories into SonarQube** section above, set the following project settings at **Project Settings > General Settings > Pull Request Decoration**: - **Configuration name** – The configuration name that corresponds to your GitHub instance. - **Repository identifier** – The path of your repository URL. @@ -91,19 +89,19 @@ From here, set your: [[collapse]] | ## Adding pull request decoration to projects that are part of a mono repository | -| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same repository. You'll need to set up pull request decoration for each SonarQube project. +| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same GitHub repository. You'll need to set up pull request decoration for each SonarQube project that is part of a mono repository. +| +| Pull request decoration for a mono repository setup is supported starting in [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html). Decorating pull requests in Developer Edition might lead to unexpected behavior. | -| In Developer Edition, analyzing a pull request for a project that is part of a mono repository will override the current pull request decoration even if you're analyzing a different project. -| -| In [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) and above, you can show pull request decoration for multiple projects simultaneously. +| To add pull request decoration to a project that's part of a mono repository, set your project up manually as shown in the **Adding pull request decoration to a manually created or existing project** above. You also need to set the **Enable mono repository support** setting to true. | -| To do this, set your global ALM Integration settings as shown in the **Importing your GitHub repositories into SonarQube** section above, and set your project settings at **Project Settings > General Settings > Pull Request Decoration**. +| After setting your project settings, you need to ensure the correct project is being analyzed by adjusting the analysis scope and pass your project names to the scanner. See the following sections for more information. | -| From here, set your: +| ### Ensuring the correct project is analyzed +| You need to adjust the analysis scope to make sure SonarQube doesn't analyze code from other projects in your mono repository. To do this set up a **Source File Inclusion** for your project at **Project Settings > Analysis Scope** with a pattern that will only include files from the appropriate folder. For example, adding `./MyFolderName/**/*` to your inclusions would only include analysis of code in the `MyFolderName` folder. See [Narrowing the Focus](/project-administration/narrowing-the-focus/) for more information on setting your analysis scope. | -| - **Configuration name** – The configuration name that corresponds to your ALM instance. -| - **Repository identifier** – The path of your repository URL. -| - **Enable mono repository support** – (Enterprise Edition and above only) Set this to true. +| ### Passing project names to the scanner +| Because of the nature of a mono repository, SonarQube scanners might read all project names of your mono repository as identical. To avoid having multiple projects with the same name, you need to pass the `sonar.projectName` parameter to the scanner. For example, if you're using the Maven scanner, you would pass `mvn sonar:sonar -Dsonar.projectName=YourProjectName`. [[collapse]] | ## Showing the analysis summary under the GitHub Conversation tab diff --git a/server/sonar-docs/src/pages/analysis/gitlab-integration.md b/server/sonar-docs/src/pages/analysis/gitlab-integration.md index cd00484baca..28ddd1a2767 100644 --- a/server/sonar-docs/src/pages/analysis/gitlab-integration.md +++ b/server/sonar-docs/src/pages/analysis/gitlab-integration.md @@ -189,7 +189,7 @@ After you've set up SonarQube to import your GitLab projects as shown in the pre Then, follow the steps in SonarQube to analyze your project. The project settings for merge request decoration are set automatically. ### Adding merge request decoration to a manually created or existing project -To add merge request decoration to a manually created or existing project, after you've set your global ALM Integration settings as shown above, set your project-level settings at **Project Settings > General Settings > Pull Request Decoration**. +To add merge request decoration to a manually created or existing project, make sure your global ALM Integration settings are set as shown in the **Importing your GitLab projects into SonarQube** section above, and set the following project settings at **Project Settings > General Settings > Pull Request Decoration**: From here, set your: - **Configuration name** – The configuration name that corresponds to your GitLab instance. @@ -200,19 +200,19 @@ From here, set your: [[collapse]] | ## Adding merge request decoration to projects that are part of a mono repository | -| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same repository. You'll need to set up merge request decoration for each SonarQube project. +| In a mono repository setup, multiple SonarQube projects, each corresponding to a separate mono repository project, are all bound to the same GitLab repository. You'll need to set up merge request decoration for each SonarQube project that is part of a mono repository. | -| In Developer Edition, analyzing a merge request for a project that is part of a mono repository will override the current pull request decoration even if you're analyzing a different project. +| Merge request decoration for a mono repository setup is supported starting in [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html). Decorating merge requests in Developer Edition might lead to unexpected behavior. | -| In [Enterprise Edition](https://redirect.sonarsource.com/editions/enterprise.html) and above, you can show pull request decoration for multiple projects simultaneously. +| To add merge request decoration to a project that's part of a mono repository, set your project up manually as shown in the **Adding merge request decoration to a manually created or existing project** above. You also need to set the **Enable mono repository support** setting to true. | -| To do this, set your global ALM Integration settings as shown in the **Importing your GitLab projects into SonarQube** section above, and set your project settings at **Project Settings > General Settings > Pull Request Decoration**. +| After setting your project settings, you need to ensure the correct project is being analyzed by adjusting the analysis scope and pass your project names to the scanner. See the following sections for more information. | -| From here, set your: -| - **Configuration name** – The configuration name that corresponds to your GitLab instance. -| - **Project ID** – your GitLab Project ID found in GitLab. -| - **Enable mono repository support** – (Enterprise Edition and above only) Set this to true. - +| ### Ensuring the correct project is analyzed +| You need to adjust the analysis scope to make sure SonarQube doesn't analyze code from other projects in your mono repository. To do this set up a **Source File Inclusion** for your project at **Project Settings > Analysis Scope** with a pattern that will only include files from the appropriate folder. For example, adding `./MyFolderName/**/*` to your inclusions would only include analysis of code in the `MyFolderName` folder. See [Narrowing the Focus](/project-administration/narrowing-the-focus/) for more information on setting your analysis scope. +| +| ### Passing project names to the scanner +| Because of the nature of a mono repository, SonarQube scanners might read all project names of your mono repository as identical. To avoid having multiple projects with the same name, you need to pass the `sonar.projectName` parameter to the scanner. For example, if you're using the Maven scanner, you would pass `mvn sonar:sonar -Dsonar.projectName=YourProjectName`. [[collapse]] | ## Configuring multiple ALM instances