跳至主要内容

为您的仓库配置自动依赖提交

您可以使用自动依赖提交在仓库中提交传递依赖数据。这使您能够使用依赖图来分析这些传递依赖。

谁可以使用此功能?

仓库所有者、组织所有者、安全管理者,以及拥有 admin 角色的用户

先决条件

必须为仓库启用依赖图,才能启用自动依赖提交。

您还必须为仓库启用 GitHub Actions 才能使用自动依赖提交。更多信息,请参阅 管理仓库的 GitHub Actions 设置

启用自动依赖提交

仓库管理员可以按照本流程中的步骤启用或禁用仓库的自动依赖提交。

组织所有者可以使用安全配置为多个仓库启用自动依赖提交。更多信息,请参阅 创建自定义安全配置

  1. 在 GitHub 上,导航至仓库的主页面。

  2. 在您的仓库名称下,点击 Settings。如果看不到 “Settings” 选项卡,请选择 下拉菜单,然后点击 Settings

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. 在侧边栏的Security部分,点击 Advanced Security

  4. 在 “Dependency graph” 下,点击 “Automatic dependency submission” 旁的下拉菜单,然后选择 Enabled(已启用)。

为仓库启用自动依赖提交后,GitHub 将

  • 监视对仓库的推送。
  • 对仓库中的任何清单,运行与相应软件包生态系统关联的依赖图构建操作。
  • 使用结果执行自动依赖提交。

您可以通过查看仓库的 Actions(操作)选项卡来查看自动工作流的详细信息。

注意

启用自动依赖提交后,我们会自动触发一次操作运行。启用后,每当对默认分支的提交更新清单时,它都会运行一次。

使用自托管运行器访问私有注册表

您可以配置自托管运行器来运行自动依赖提交作业,而不是使用 GitHub Actions 基础设施。这对于访问私有 Maven 注册表是必需的。自托管运行器必须运行在 Linux 或 macOS 上。对于 .NET 和 Python 的自动提交,它们必须能够访问公共互联网,以下载最新的 component-detection 发布版。

  1. 在仓库或组织层面配置一个或多个自托管运行器。更多信息,请参阅 自托管运行器添加自托管运行器
  2. 为每个希望用于自动依赖提交的运行器分配一个 dependency-submission 标签。更多信息,请参阅 使用标签管理自托管运行器
  3. 在侧边栏的Security部分,点击 Advanced Security
  4. 在 “Dependency graph” 下,点击 “Automatic dependency submission” 旁的下拉菜单,然后选择 Enabled for labeled runners(已为带标签的运行器启用)。

启用后,自动依赖提交作业将在自托管运行器上运行,除非

  • 自托管运行器不可用。
  • 没有任何带有 dependency-submission 标签的运行器组。

注意

对于使用自托管运行器访问私有 Maven 注册表的 Maven 或 Gradle 项目,您需要修改 Maven 服务器设置文件,以允许依赖提交工作流连接到注册表。有关 Maven 服务器设置文件的更多信息,请参阅 Maven 文档中的 安全和部署设置

有关网络白名单 URL、更大运行器配置、故障排查细节以及特定软件包生态系统的信息,请参阅 自动依赖提交

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.