Help us learn about your current experience with the documentation. Take the survey.

GitHub

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

您可以使用来自 GitLab 的流水线状态更新来更新 GitHub。 如果您使用 GitLab 进行 CI/CD,GitHub 集成可以帮助您。

Pipeline状态更新 on GitHub

此项目集成与实例范围的 GitHub 集成是分开的, 当您导入GitHub 项目时会自动配置。

配置集成

此集成需要一个授予了 repo:status 访问权限的 GitHub API token

在 GitHub 上完成以下步骤:

  1. 前往您的 Personal access tokens 页面:https://github.com/settings/tokens
  2. 选择 Generate new token
  3. Note 下,为新输入令牌名称。
  4. 确保 repo:status 已选中,然后选择 Generate token
  5. 复制生成的令牌以在 GitLab 中使用。

在 GitLab 中完成以下步骤:

  1. 在左侧边栏,选择 Search or go to 并找到您的项目。
  2. 选择 Settings > Integrations
  3. 选择 GitHub
  4. 确保 Active 复选框已选中。
  5. Token 中,粘贴您在 GitHub 上生成的令牌。
  6. Repository URL 中,输入您在 GitHub 上的项目路径,例如 https://github.com/username/repository
  7. 可选。要禁用静态状态检查名称,请清除 Enable static status check names 复选框。
  8. 可选。选择 Test settings
  9. 选择 Save changes

配置集成后,请参阅外部拉取请求的流水线 来配置为打开的拉取请求运行流水线。

静态或动态状态检查名称

状态检查名称可以是静态或动态的:

  • 静态:您的 GitLab 实例的主机名会附加到状态检查名称中。

  • 动态:分支名称会附加到状态检查名称中。

Enable static status check names 选项使您能够在 GitHub 中配置必需的状态检查, 这些检查需要一致的(静态)名称才能正常工作。

如果您禁用此选项, GitLab 会使用动态状态检查名称。