GitHub 可通过 CoroidGitHub App或个人访问令牌。可在设置 → 连接 → 源代码管理.
App 或令牌
优先选用 App。它按代码库而非用户授予权限,即便配置人员离职仍能正常运行,且无需轮询即可接收 Webhook 事件。
若安装 App 需要无法获取的组织管理员审批,则可使用令牌。
| GitHub App | 个人访问令牌 | |
|---|---|---|
| 访问范围 | 按代码库 | 用户可查看的所有内容 |
| 不受安装人员离职影响 | 是 | 否 |
| Webhook 事件 | 是 | 轮询 |
| 归属关系 | 该 App | 令牌所有者 |
安装应用
在GitHub中选择设置 → 连接 → 源代码管理随后按照安装流程操作。GitHub会询问要授予权限的代码仓库,后续也可从GitHub自身的设置中修改该配置。
如果创建项目时未显示某代码仓库,几乎可以确定是该应用未被授予该仓库的访问权限,这是最常见的原因。
使用令牌
创建一个具备以下范围的经典令牌:repo或者创建一个细粒度令牌,赋予其对代码内容和拉取请求的读写权限,之后将其粘贴到源代码管理设置中。
令牌在存储时会加密,API绝不会返回令牌内容,也不会将其包含在设置导出数据中。
GitHub Issue
同一连接支持将Issue导入为工作任务。详情请参阅导入工作任务.
Coroid在您的代码仓库中的操作
- 读取代码以理解并修改代码
- 为每个任务创建独立分支
- 推送该分支并向您的基准分支发起pull request
它绝不会向您的默认分支提交代码,也不会执行合并操作。您的分支保护规则、必填检查项及审核规则仍会正常生效。