4. 制品库架构设计：制品库定义、版本管理、元数据存储、制品签名与校验、制品库高可用设计

eBPF 网络观测制品库是自动化运维体系的核心数据底座，承载着从内核态采集、用户态解析到可视化展示的全链路观测制品。本章围绕制品库的五大核心设计维度展开，确保制品在存储、分发、校验与恢复过程中的一致性、安全性与可用性。

4.1 制品库定义与制品类型

制品库（Artifact Repository）是一个集中存储、版本化管理和分发 eBPF 观测产物的系统。每个制品是一个不可变的、自描述的二进制或文本包，包含观测数据及其元数据。

4.2 版本管理策略

版本管理采用语义化版本（SemVer）与时间戳双轨制，兼顾人工可读性与机器排序效率。

• 主版本号（Major）： eBPF 程序接口或观测数据 schema 发生不兼容变更时递增。
• 次版本号（Minor）： 新增观测指标或扩展字段，向后兼容时递增。
• 补丁版本号（Patch）： 修复数据采集 bug、优化性能，不改变接口时递增。
• 构建元数据： 附加 +YYYYMMDDHHMMSS 时间戳，确保唯一性。

# 制品版本示例
eBPF_network_observer-v2.3.1+20250401120000.tar.gz
├── artifact_id: net_observer_bpf
├── version: 2.3.1
├── build_timestamp: 2025-04-01T12:00:00Z
├── checksum: sha256:abc123...
└── signature: rsa2048:def456...

4.3 元数据存储设计

元数据采用关系型数据库（PostgreSQL）与键值存储（etcd）混合架构，兼顾强一致性与高并发查询。

-- 元数据表核心结构（PostgreSQL）
CREATE TABLE artifacts (
    id              UUID PRIMARY KEY,
    name            VARCHAR(255) NOT NULL,
    version         VARCHAR(32) NOT NULL,
    checksum_sha256 VARCHAR(64) NOT NULL,
    signature       TEXT,
    size_bytes      BIGINT,
    storage_path    TEXT,
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(name, version)
);

CREATE INDEX idx_artifacts_name_version ON artifacts(name, version);

4.4 制品签名与校验

采用 GPG 签名与 SHA-256 双重校验机制，确保制品在传输与存储过程中的完整性与来源可信。

1. 签名生成： 使用制品库私钥对制品哈希进行签名，生成 .sig 文件。
2. 校验流程： 下载端获取公钥，验证签名是否匹配；同时计算本地 SHA-256 与元数据记录比对。
3. 自动拒绝： 签名不匹配或哈希不一致的制品自动标记为“损坏”，触发告警并阻止部署。

# 签名生成命令示例
gpg --detach-sign --armor --output net_observer_v2.3.1.tar.gz.sig \
    net_observer_v2.3.1.tar.gz

# 校验命令示例
gpg --verify net_observer_v2.3.1.tar.gz.sig net_observer_v2.3.1.tar.gz
sha256sum net_observer_v2.3.1.tar.gz

4.5 制品库高可用设计

高可用架构采用多副本、跨区域部署与自动故障转移策略，确保制品库在单点故障时仍可正常服务。

4.6 高可用关键指标与自动恢复