设置GitHub Enterprise与TinaCloud的集成

这是一个TinaCloud企业功能

本指南提供了将GitHub Enterprise（GHE）实例与TinaCloud集成的逐步说明。此集成支持GitHub Enterprise Server（自托管）和GitHub Enterprise Cloud（GitHub托管），但需要注意的是GitHub Enterprise Server必须可被TinaCloud访问。

先决条件

  1. 一个GitHub Enterprise实例（无论是GitHub Enterprise Server还是GitHub Enterprise Cloud）。
  2. 管理访问权限以在您的GitHub组织中配置GitHub应用。
  3. 如果自托管GitHub Enterprise Server，请确保它可被TinaCloud访问。

第一步：在GitHub Enterprise中配置GitHub应用

创建GitHub应用

  1. 进入您的GitHub组织，导航到设置 > 开发者设置 > GitHub应用。
  2. 点击新建GitHub应用。
  3. 提供以下详细信息：
    1. 应用名称：为您的应用选择一个名称（例如，“TinaCloud集成”）。
    2. 描述：为应用添加描述（例如，“用于TinaCloud管理内容和拉取请求的集成”）。
    3. 主页URL：输入应用的URL（例如，https://tina.io）。
  4. 在回调URL下，输入：https://app.tina.io/github-authenticating。
  5. 保持以下选项未选中：
    1. 安装期间请求用户授权（OAuth）
    2. 启用设备流
  6. 在安装后配置中，设置以下内容：
    2. 勾选更新时重定向的选项。
  7. Webhook URL：此集成不需要Webhook URL。
  8. 权限：为GitHub应用配置以下权限：
    1. 内容：读 + 写
    2. 元数据：读
    3. 拉取请求：读 + 写
    4. Webhooks：读 + 写
  9. 在“此GitHub应用可以安装在哪里？”下，选择任何账户。

生成凭据

  1. 创建应用后，导航到应用设置页面的常规选项卡。
  2. 记下此页面上显示的应用ID和客户端ID。
  3. 点击生成新的客户端密钥以生成客户端密钥。
  4. 点击生成私钥以生成私钥。安全地保存.pem文件。

第二步：在TinaCloud中配置GitHub Enterprise Server

  1. 导航到TinaCloud GitHub主机配置页面：https://app.tina.io/githosts/new。
  2. 输入以下详细信息：
  3. 服务器名称：为您的GitHub Enterprise实例命名（例如，“我的GitHub Enterprise”）。
  4. 主机名：您的GitHub Enterprise实例的URL。
  5. 应用ID：从GitHub应用设置中获取的应用ID。
  6. 客户端ID：从GitHub应用设置中获取的客户端ID。
  7. 客户端密钥：在GitHub应用设置中生成的客户端密钥。
  8. 私钥：上传在GitHub应用设置中生成的.pem文件。
  9. 点击验证按钮以验证配置。如果验证成功，继续保存配置。

一旦服务器配置成功，用户将在TinaCloud中创建新项目时能够选择它。

第三步：验证集成

  1. 配置GitHub应用和GitHub Enterprise Server后，返回TinaCloud。
  2. 创建一个新项目并选择配置的GitHub Enterprise实例。
  3. 如果集成成功，您将看到GitHub Enterprise实例上可用的存储库列表。

故障排除

  • GitHub Enterprise Server无法访问：确保您的GitHub Enterprise Server可被TinaCloud访问。检查防火墙规则和网络配置。
  • 权限问题：验证GitHub应用是否具有上述正确的权限。
  • 配置错误：仔细检查GitHub应用设置期间输入的URL、凭据和设置。
  • 验证失败：如果验证失败，请确保所有凭据（应用ID、客户端ID、客户端密钥和私钥）输入正确并与GitHub应用设置匹配。

支持

如需更多帮助，请联系TinaCloud支持。

Last Edited: March 24, 2025