SonarQube 与 Bitbucket Server 的集成使您可以维护 Bitbucket Server 存储库中的代码质量和安全性。

SonarQube 与 Bitbucket Server 的集成使您可以维护 Bitbucket Server 存储库中的代码质量和安全性。

通过这种集成，您将能够：

• 导入 BitBucket Server 存储库：将 Bitbucket Server 存储库导入 SonarQube 以轻松设置 SonarQube 项目。

• 向拉取请求报告您的 Quality Gate 状态（从Developer Edition开始 ）：直接在 Bitbucket Server 中查看您的 Quality Gate 和代码指标结果，以便了解合并更改是否安全。

先决条件

• 与 Bitbucket Server 集成至少需要 Bitbucket Server 版本 5.15。

• 您已在 Administration  >  Configuration  >  General Settings > General中设置了 SonarQube Server 基本 URL。

分支分析

Community Edition 不支持多个分支的分析，因此您只能分析您的主分支。从 Developer Edition开始，您可以分析多个分支和拉取请求。

将 Bitbucket 服务器存储库导入 SonarQube

设置将 BitBucket Server 存储库导入到 SonarQube 中，您可以轻松地从 Bitbucket Server 存储库创建 SonarQube 项目。如果您使用的是 Developer Edition 或更高版本，这也是添加拉取请求修饰的第一步。

要设置 BitBucket Server 存储库的导入：

1. 设置全局 DevOps 平台集成设置

2. 添加个人访问令牌以导入存储库

设置您的全球 DevOps 平台集成设置

要设置全局 DevOps 平台集成设置，请导航到 Administration > Configuration > General Settings > DevOps Platform Integrations，选择 Bitbucket 选项卡，然后选择 Bitbucket Server 作为要配置的变体。从此处指定以下设置：

• 配置名称 （仅限企业版和数据中心版）：用于在项目级别标识 Bitbucket Server 配置的名称。使用简洁且易于识别的内容。

• Bitbucket 服务器 URL：您的实例 URL。例如，  https://bitbucket-server.your-company.com。

• 个人访问令牌：Bitbucket Server 用户帐户用于装饰拉取请求。我们建议使用具有管理员权限的专用 Bitbucket Server 帐户。您需要  此帐户的 个人访问令牌，并对 将分析的存储库具有读取权限。管理员可以在Administration > Configuration > Encryption中加密此令牌 。 有关详细信息，请参阅 “安全”页面 的 “设置加密”部分。此个人访问令牌用于向拉取请求报告您的质量门状态。在下一部分中，您将被要求提供另一个个人访问令牌来导入项目。

添加个人访问令牌以导入存储库

设置全局设置后，您可以通过单击 项目 主页右上角的 添加项目按钮 并选择 Bitbucket从 Bitbucket Server 添加项目。

然后，系统会要求您从您的用户帐户提供个人访问令牌，该令牌 Read 具有项目和存储库的权限。该令牌将存储在 SonarQube 中，并且可以随时在 Bitbucket Server 中撤销。

保存您的个人访问令牌后，您将看到可以设置并添加到 SonarQube 的 Bitbucket Server 项目列表。以这种方式设置项目还会设置拉取请求装饰的项目设置。

向 Bitbucket 服务器报告您的质量门状态

如上一节所示，设置 SonarQube 以导入 Bitbucket Server 存储库后，SonarQube 可以将质量门状态和分析指标直接报告给 Bitbucket Server 拉取请求。

为此，请选择 项目 主页右上角的 添加项目按钮，然后 从下拉菜单中 选择 Bitbucket，从 Bitbucket 添加项目。

然后，按照 SonarQube 中的步骤分析您的项目。SonarQube 会自动设置在拉取请求中显示质量门所需的项目设置。

如果您手动创建项目或将质量门报告添加到现有项目，请参阅以下部分。

报告手动创建或现有项目中的质量门状态

SonarQube 还可以向 Bitbucket Server 报告现有项目和手动创建项目的质量门状态。按照上面将Bitbucket Server 存储库导入 SonarQube部分所示更新全局设置后 ，请在Project Settings > General Settings > DevOps Platform Integration 中设置以下项目设置 ：

• 配置名称：与您的 DevOps 平台实例对应的配置名称。

• 项目密钥：项目密钥是 BitBucket Server 存储库 URL 的一部分  (.../projects/<key>/repos/<slug>/browse).

• 存储库 SLUG：存储库 SLUG 是 BitBucket Server 存储库 URL 的一部分(.../projects/<key>/repos/<slug>/browse).

高级配置

当质量门失败时防止拉取请求合并

设置拉取请求分析后，如果拉取请求未通过质量门，您可以阻止合并拉取请求。去做这个：

1. 在 Bitbucket Server 中，导航到 存储库设置>代码见解。

2. 添加  名为的 必需报告com.sonarsource.sonarqube

3. 选择 必须通过 作为 必需状态。

4. 选择 不能有任何注释 作为 注释要求。