配置 Issue Tracker

如果您希望能够从 Polyspace^® Access 界面中的 Bug 跟踪工具 (BTT) 创建工单，请配置 Issue Tracker。Polyspace Access 支持与 Jira Software 和 Redmine BTT 集成。如果您不希望将您的 BTT 与 Polyspace Access 集成，请在 Provider 字段中选择 none。

在 Cluster Dashboard 上，点击 Configure Apps 以转至 Cluster Settings。填写所有设置后，请点击 Save，返回到 Cluster Dashboard 并点击 Restart Apps，然后更改才会生效。在点击 Save 之前，请确保 Validate on Save 已启用。

注意

在 Windows^® 系统上，您指定的所有文件路径都必须指向本地驱动器。

前提条件

安装并启动 Cluster Admin。请参阅配置并启动 Cluster Admin。

配置 Bug 跟踪工具 Jira Software

设置	描述
Provider	Jira
Jira deployment type	指定 Jira 实例是托管在本地服务器上还是托管在云端服务提供商处。仅当选择 Jira 作为提供程序时此字段才可用。
Jira URL	为组织指定 Jira 实例的 URL，例如 `https://jira.mycompany.com`。如果 Jira 实例是使用 HTTPS 配置的，请参阅添加使用 HTTPS 配置的 BTT 实例。仅当选择 Jira 作为提供程序时此字段才可用。
Authentication method	指定 Issue Tracker 对从 Polyspace Access 登录 Jira 的用户进行身份验证时采用的方法。仅当选择 Jira 作为提供程序时此字段才可用。
OAuth1 callback URL	如果您选择 OAuth 作为身份验证方法，则您的 Jira 管理员必须首先在 Jira 中创建一个应用程序链接。Jira 管理员需要指定一个应用程序 URL（Polyspace Access 的 URL）并生成一个 RSA 公钥/私钥对。有关详细信息，请参阅此页面上的步骤 1。 OAuth1 callback URL 必须与 Jira 中指定的应用程序 URL（例如 `https://access-machine.company.com:9443`）一致。仅当选择 Jira 作为提供程序时此字段才可用。
OAuth1 consumer key	指定 Jira 管理员在 Jira 中配置应用程序链接时输入的使用者密钥值，例如 `OauthKey`。仅当选择 Jira 作为提供程序时此字段才可用。
OAuth1 private key file	指定 Jira 管理员在 Jira 中配置应用程序链接时生成的私钥文件的路径，例如 `/local/polyspace_access/jira_privatekey.pem`。注意创建 JIRA 私钥时指定的主机名必须与您在 Polyspace Access URL 中使用的主机名一致。如果主机名不一致，例如，假设您使用 `localhost` 而非 Polyspace Access URL 中的主机名，则当您尝试从 Polyspace Access 中创建 Jira 工单时，可能会发生用户身份验证错误。仅当选择 Jira 作为提供程序时此字段才可用。

限制

Polyspace Access 不支持创建包含自定义必填字段的 BTT 工单，除非这些字段是：
- 全数值。
- 纯字符串值。
- 单选自定义字段。
在用户从 Polyspace Access 登录到 Jira 并开始创建 Jira 工单之后，他们将保持已登录 Jira 会话的状态，直至会话过期。
在 Jira Software 版本 8.4 及更高版本中，请不要启用隐藏功能。请参阅在 Jira 中启用隐藏功能。

配置 Bug 跟踪工具 Redmine

设置描述

设置	描述
Provider	Redmine
Redmine URL	指定组织的 Redmine 实例的 URL，例如 `https://redmine.mycompany.com`。如果 Redmine 实例是使用 HTTPS 配置的，请参阅添加使用 HTTPS 配置的 BTT 实例。仅当选择 Redmine 作为提供程序时此字段才可用。
Redmine API key	指定 Redmine 管理员的 API 访问密钥。要获取 API 密钥，请以管理员身份登录到 Redmine 实例，点击右上角的 My account，然后在右侧窗格中点击 API access key 下的 Show。 Issue Tracker 不会验证 API 密钥。请定期检查 API 密钥是否已过期或无效。仅当选择 Redmine 作为提供程序时此字段才可用。

Provider

Redmine

Redmine URL

指定组织的 Redmine 实例的 URL，例如 https://redmine.mycompany.com。

如果 Redmine 实例是使用 HTTPS 配置的，请参阅添加使用 HTTPS 配置的 BTT 实例。

仅当选择 Redmine 作为提供程序时此字段才可用。

Redmine API key

指定 Redmine 管理员的 API 访问密钥。

要获取 API 密钥，请以管理员身份登录到 Redmine 实例，点击右上角的 My account，然后在右侧窗格中点击 API access key 下的 Show。

Issue Tracker 不会验证 API 密钥。请定期检查 API 密钥是否已过期或无效。

仅当选择 Redmine 作为提供程序时此字段才可用。

限制

Polyspace Access 不支持创建包含自定义必填字段的 BTT 工单，除非这些字段是全数值或纯字符串值字段。
要从 Polyspace Access 创建 Redmine 工单，用于登录 Polyspace Access 的用户名必须与 Redmine 帐户的用户名一致。
用户从 Polyspace Access 创建的 Redmine 工单只能使用默认字段值进行填充。用户在 Polyspace Access 中选择的部分工单字段值可能与 Redmine 工单中的字段值不一致。

添加使用 HTTPS 配置的 BTT 实例

如果您的 BTT 实例是使用 HTTPS 配置的，请将 BTT SSL 证书添加到您在 Nodes 设置的 CA File 字段中指定的证书信任存储文件中。要查看这些设置，请点击 Cluster Dashboard 上的 Configure Nodes。根据信任存储文件，BTT SSL 证书可能已包含在信任存储中。

证书信任存储文件通常对应于使用 HTTPS 配置 Cluster Admin 时通过 --ssl-ca-file 提供的文件。请参阅为 Polyspace Access 选择 HTTP 或 HTTPS 配置。

例如，在 Linux^® Debian^® 分发版中，要将 BTT 证书 btts_cert.pem 添加到信任存储文件 trust_store.pem，请使用以下命令：

cat trust_store.pem btts_cert.pem > combined_cert.pem

该命令将组合两个文件的内容并输出文件 combined_cert.pem。如果使用自签名证书配置 HTTPS，请将 BTT 证书添加到自签名证书中。

要完成配置，请在 Nodes 设置的 CA File 字段中输入 combined_cert.pem 的路径，保存更改，返回仪表板，并重新启动 App。

如果未使用 HTTPS 配置 Cluster Admin，请在 CA File 字段中指定 BTT SSL 证书的路径。