什么是PBOM?Plumber定义CI/CD流水线的SBOM新标准

原创2026-10-26 09:51:451,331 阅读

什么是PBOM?Plumber定义CI/CD流水线的SBOM新标准

如果你熟悉 SBOM(软件物料清单),那么 PBOM(Pipeline Bill of Materials,流水线物料清单)就是它的"流水线版本"。开源工具 Plumber 正是 PBOM 这一新标准的定义者:它自动盘点 GitHub Actions 与 GitLab CI 流水线中的全部依赖——容器镜像、第三方 Action、模板与组件——并给出 CI/CD 流水线安全评分。

Plumber CLI 扫描 CI/CD 流水线并生成 PBOM 安全报告

为什么 CI/CD 流水线需要"自己的 SBOM"?

传统 SBOM 关注的是应用代码的依赖(库、框架、包)。但现代软件交付中,真正干活的流水线本身就是供应链的一部分:

平台 流水线依赖
GitHub Actions 第三方 Action(uses: owner/repo@ref)、可复用 Workflow、container 与 services 镜像
GitLab CI CI 组件、模板、跨项目/本地/远程 include、image 与 services 镜像

这些依赖大多不在应用 SBOM 的覆盖范围内,却是攻击者最爱的入口——未固定版本的 Action 被投毒、模板被恶意修改、镜像 tag 被替换,都会直接污染构建产物。🔐

PBOM 的价值就在于给这套"基础设施依赖"建立一份可审计的清单,这正是 Plumber 在 docs/PBOM.md 中阐述的核心理念。

PBOM 清单里都有什么内容?

Plumber 生成的 PBOM(当前规范版本 1.0.0)按"上下文 → 统计 → 评分 → 清单"的顺序组织:

字段 说明
project 被分析项目的路径、提供商(gitlab / github)、分支与 commit
summary 镜像总数、镜像仓库数、各类 include 数量统计
plumberScore Plumber 安全评分(A–E 字母分 + 0–100 分 + 各严重级别计数)
containerImages 所有容器镜像,含注册表、tag、使用它的 job,以及"是否来自授权源""是否使用禁用 tag"等合规标记
includes 所有组件/模板/Action/可复用 Workflow,含版本、是否最新、是否被本地覆盖;GitHub Action 还会标注上游是否归档、是否有 CVE 公告
jobs / capabilities (GitLab)每个 job 的 service 镜像与 runner tag;流水线 job 实际具备的能力(如密钥检测)及证据

完整字段参考见 docs/PBOM.md,数据结构定义在 pbom/types.go。

两种输出格式,各有所长

格式 参数 适合场景
Plumber PBOM --pbom pbom.json 面向流水线的详细清单,含合规元数据与评分
CycloneDX SBOM --pbom-cyclonedx pipeline-sbom.json 对接 Grype、Trivy、Dependency-Track 等标准安全工具

选择 CycloneDX 而非 SPDX,是因为它的 container 组件类型天然贴合流水线场景,且安全工具生态对其支持最好(见 pbom/cyclonedx.go 的导出实现)。

3 步生成你的第一份 PBOM

第 1 步:安装 Plumber(macOS 用户推荐 Homebrew)

brew install plumber

第 2 步:在项目根目录运行分析,同时生成两种格式:

plumber analyze --pbom pbom.json --pbom-cyclonedx pipeline-sbom.json

第 3 步:查看结果——终端会打印安全评分与问题清单,两个 JSON 文件分别是流水线物料清单和标准 SBOM。无需任何配置文件,Plumber 会自动从 git remote 识别 CI 提供商。

PBOM 如何融入安全工具生态?

CycloneDX 格式让 PBOM 可以直接喂给主流工具:

工具 用途 命令
CycloneDX CLI 校验格式合法性 cyclonedx validate --input-file sbom.json --input-format json
Grype 漏洞扫描 grype sbom:sbom.json
Trivy 安全扫描 trivy sbom sbom.json
Dependency-Track 持续追踪组件清单与漂移 通过 API 或 Web UI 上传

⚠️ 一个常见疑问:用 Grype/Trivy 扫 PBOM 为什么查不到几个漏洞?这是设计如此——CI 组件和模板是配置文件而非软件包,公开漏洞数据库(NVD、OSV)并不跟踪它们的 CVE。PBOM 当下的核心价值是清单与可见性:明确知道流水线里有什么、追踪版本变更、做合规留档、用 Dependency-Track 检测长期漂移。

把 PBOM 上传到 Dependency-Track 后,整个流水线的依赖就进入了可长期追踪的看板:

Dependency-Track 看板展示 PBOM 中的流水线组件清单

更多工具的手把手测试步骤见 docs/PBOM_TESTING.md。

在 CI 中自动运行 Plumber

Plumber 官方支持两种接入方式,让 PBOM 与评分在每次构建中自动生成:

  • GitLab CI 组件:在 .gitlab-ci.yml 中 include 官方组件,生成的 PBOM 会自动作为流水线 artifact 保存,CycloneDX 报告还能在 GitLab 的 Licenses 标签页直接查看;
  • GitHub Action:官方 Action 会校验二进制校验和与构建溯源,并暴露 pbom 与 pbom-cyclonedx 输入。

Plumber 在 GitLab Merge Request 中自动发布的流水线合规报告

以 GitLab 为例,只需几行配置(版本固定使用官方组件):

include:
  - component: gitlab.com/getplumber/plumber/plumber@<version>

常见问题

Q:PBOM 会取代 SBOM 吗? 不会。两者互补:SBOM 覆盖应用代码依赖,PBOM 覆盖流水线基础设施依赖,完整的安全供应链视图 = SBOM + PBOM。

Q:GitHub 和 GitLab 生成的 PBOM 有区别吗? 顶层结构一致,清单内容按平台映射:GitLab 盘点组件/模板/include,GitHub 盘点 Action/可复用 Workflow;provider 字段会标明来源。

Q:没有配置 Token 能跑吗? 可以,本地分析 workflow 文件本身不需要 Token;配置 Token 后 Plumber 还能补齐 Action 上游归档状态、CVE 公告等增强信息。

延伸阅读

登录后查看全文
plumber