什么是PBOM?Plumber定义CI/CD流水线的SBOM新标准
什么是PBOM?Plumber定义CI/CD流水线的SBOM新标准
如果你熟悉 SBOM(软件物料清单),那么 PBOM(Pipeline Bill of Materials,流水线物料清单)就是它的"流水线版本"。开源工具 Plumber 正是 PBOM 这一新标准的定义者:它自动盘点 GitHub Actions 与 GitLab CI 流水线中的全部依赖——容器镜像、第三方 Action、模板与组件——并给出 CI/CD 流水线安全评分。
为什么 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 后,整个流水线的依赖就进入了可长期追踪的看板:
更多工具的手把手测试步骤见 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输入。
以 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 公告等增强信息。
延伸阅读
- PBOM 规范全文:docs/PBOM.md
- 工具联调指南:docs/PBOM_TESTING.md
- 评分算法说明:docs/scoring.md
- 示例输出文件:output-example.json
- 生成器源码:pbom/generate.go、pbom/cyclonedx.go

