把 GitHub 或 GitLab 中的代码关联到任务

开发人员无需离开 GitHub 或 GitLab，就能把代码关联到任务。当提交信息、分支名称或拉取请求（GitLab 中称为合并请求）提到某个任务的编号（例如 CBS-74-T357）时，它会显示在该任务的关联的代码标签页中。此功能属于 Business 套餐，只有管理员可以连接。

连接仓库

1. 打开设置，选择集成。
2. 在 GitHub 和 GitLab 下输入名称（例如 Mobile app），选择 GitHub 或 GitLab，然后按连接。
3. Kaam360 会显示一个地址和一个密钥。现在就把两者都复制下来：密钥只显示一次。
4. 在 GitHub 中打开仓库（或您的组织），然后依次进入 Settings、Webhooks、Add webhook。把地址粘贴到 Payload URL，选择 application/json，把密钥粘贴到 Secret，选择 Let me select individual events，勾选 Pushes 和 Pull requests，然后按 Add webhook。
5. 在 GitLab 中打开项目（或您的群组），然后依次进入 Settings、Webhooks、Add new webhook。把地址粘贴到 URL，把密钥粘贴到 Secret token，勾选 Push events 和 Merge request events，然后按 Add webhook。

GitHub 会立即发送一条测试消息。之后连接会显示进行中，以及最后一条消息做了什么。

提到任务

把任务顶部的编号（例如 CBS-74-T357）复制到：

• 提交信息中，例如 Fix the login button (CBS-74-T357)；
• 分支名称中，例如 feature/CBS-74-T357-login；
• 拉取请求的标题或描述中。

编号必须包含其所属项目的代码，这样其他项目的编号永远不会被误关联。打开任务并选择关联的代码标签页，即可看到每个关联的提交、分支和拉取请求，以及它们的仓库和作者；对于拉取请求，还能看到它是打开、已合并还是已关闭。按某一行即可在 GitHub 或 GitLab 中打开它。任务的历史记录也会显示代码何时被关联。

拉取请求合并后完成任务

为某个连接勾选将其提到的任务标记为已完成。当提到某个任务的拉取请求被合并时，该任务会变为已完成，就像创建该连接的管理员完成的一样。

保持安全

• Kaam360 会在每条消息中检查密钥，拒绝任何没有密钥的消息。
• 如果密钥可能已泄露，请按钥匙按钮（新密钥），并把新密钥填入 Webhook 设置。旧密钥会立即失效。
• 按暂停可暂时停止关联，按移除可删除连接及其创建的关联。也请在 GitHub 或 GitLab 中移除该 Webhook。

如果出了问题

• 没有任何关联：请检查编号是否包含项目代码和正确的任务编号，以及 Webhook 是否发送推送和拉取请求。
• GitHub 在某次投递上显示红色标记：地址或密钥有误。按新密钥并重新粘贴。