GitHub Enterprise Server 集成

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

1. GitHub App (推荐) — 在你的 GHES 或 GHEC 实例中注册并安装专用的 GitHub App。此方式可简化设置流程，且无需管理个人访问令牌。
2. 个人访问令牌 (PAT) — 创建服务账户并生成细粒度个人访问令牌。此方法适用于所有 GHES 版本。

1. App 注册 — 在你的 GHES 或 GHEC 实例上注册一个 GitHub App。每个实例只需注册一个 App。
2. App 配置 — 在你的 GHES 或 GHEC 实例上配置已注册的 App (例如，将其设为公开，并禁用令牌过期) 。
3. App 安装 — 在你希望 Devin 访问的每个 GitHub 组织中安装已注册的 App。每个组织都需要安装一次。

• 拥有 管理 Git 权限 的 Devin 用户
• 对将注册该 App 的 GitHub 组织拥有所有者或管理员访问权限

1. 在你的 Devin 账户中，前往 企业设置 → 集成 → GitHub。
2. 展开 Advanced 部分，显示 GitHub Enterprise 选项。

3. 点击 Register App。
4. 在弹出的模态窗口中，输入你的 GHES 或 GHEC 实例的 hostname，以及要注册该 App 的 organization。

5. 你将被重定向到 GitHub。点击 Register App 完成注册。

6. 跳转回 Devin 后，该 GitHub App 即已注册到你的 GitHub 组织中。

1. 在你的 GHES 或 GHEC 实例中，前往注册时指定的 GitHub 组织。
2. 依次进入 Settings → Developer Settings → GitHub Apps，然后选择 Devin App。

3. 在 Advanced 部分的 Danger zone 下，点击 Make public。这样，该 App 就可以安装到同一实例中的其他组织。
4. 前往 Optional features 部分，并关闭 User-to-server token expiration。这样可防止访问令牌过期，避免用户需要定期重新授权该 App。

1. 在你的 Devin 账户中，前往 企业设置 → 集成 → GitHub。
2. 展开 Advanced 部分，然后点击 安装应用。
3. 在模态窗口中，选择在你的 GHES 或 GHEC 实例下注册的 GitHub App。

4. 你将被重定向到 GitHub，在那里可以选择一个 GitHub 组织，并选择要授权 Devin 访问的代码仓库。我们建议授权访问 所有代码仓库。
5. 完成安装后，你将被重定向回 Devin。随后，设置 → 集成 → GitHub 中会显示一条新的 Git 连接。

1. 在你的 GitHub Enterprise 中创建一个新的 GitHub 账号供 Devin 使用。这样可以确保 Devin 的所有访问和使用情况都能被正确跟踪和管理。
2. 将新创建的服务账号作为 Member 添加到所有相关的 GitHub 组织中。确认该账号可以访问所有预期由 Devin 访问的代码仓库。

1. 使用服务账号登录后，点击右上角的个人头像，然后点击 Settings (设置) 。
2. 在左侧边栏中，点击 Developer settings (开发者设置) 。
3. 在左侧边栏中，在 Personal access tokens (个人访问令牌) 下，点击 Fine-grained tokens (细粒度令牌) 。
4. 点击 Generate new token (生成新令牌) 。
5. 填写 Token name (令牌名称) 和 Expiration (过期时间) 。
   注意： 当令牌过期时，Devin 将立即失去对 GitHub 的所有访问权限，需要创建一个新的令牌。
6. 在 Resource owner (资源所有者) 下，选择正确的组织。

7. 在 Repository access (代码仓库访问) 下，选择你希望 Devin 使用的仓库。令牌始终包含对 GitHub 上所有公共仓库的只读访问权限。
8. 确保令牌具有以下 Devin 正常工作所需的权限：

9. 点击 Generate Token (生成令牌) 并保存显示的令牌。
   注意： 根据你的 GitHub 设置，可能需要管理员审批。
10. 为验证该令牌是否具有所有必要的访问和权限，请在本地机器上创建并推送一个测试分支到该组织中的某个仓库。
11. 令牌生成并测试完成后，请联系你在 Cognition 的对接人以完成配置流程。如果你当前并未直接与我们的团队合作，请发送邮件至 enterprise@cognition.ai 与我们联系。

# 使用您的令牌通过 gh CLI 进行身份验证
export GH_TOKEN=your_personal_access_token
export GH_HOST=your-github-enterprise-server.com

# 克隆代码仓库
gh repo clone your-organization/your-repository
cd your-repository

# 创建测试分支
git checkout -b test-devin-token-$(date +%s)

# 进行小改动
echo "# Test" >> TEST.md
git add TEST.md
git commit -m "Test: Validate Devin token permissions"

# 推送分支(测试内容写入权限)
git push origin HEAD

# 创建拉取请求(测试拉取请求写入权限)
gh pr create --title "Test: Validate Devin token permissions" \
  --body "This is a test PR to validate token permissions." \
  --base main

# 清理:关闭测试 PR 并删除测试分支
gh pr close pr-number --delete-branch

• 我们建议在 master 分支上启用分支保护，以确保在 Devin 合并任何变更之前，所有检查都已执行并通过。
• 如果 Devin 已连接到你组织的 GitHub 组织账号，那么对于任何同时拥有该 GitHub 组织和 Devin 组织访问权限的用户，Devin 将具备与其相同级别的权限。
• Devin 不会继承或仿照正在与其进行会话的用户权限，而是始终保留在组织级别授予它的权限。
• Devin 无法在你的 GitHub 账号中创建新的代码仓库。