openeuler/splitter

Splitter | openEuler Docker镜像文档

镜像概述

Splitter是openEuler官方Docker镜像，由openEuler CloudNative SIG维护，是创建openEuler无发行版(distroless)镜像的核心工具。它通过分析RPM包并基于slice-releases仓库定义的规则，将其分解为最小功能单元“切片”，从而构建仅包含应用运行所需必要组件的容器镜像，显著减小镜像体积并提升安全性。

核心功能与特性

• RPM包切片：将完整RPM包分解为细粒度“切片”，去除冗余组件
• 规则驱动：基于slice-releases仓库的规则定义进行切片处理
• 多版本支持：适配openEuler不同版本，提供多种镜像标签
• 跨架构支持：支持amd64和arm64架构
• 轻量级输出：生成的切片可用于构建极小化的无发行版容器镜像

支持的标签及对应Dockerfile链接

Splitter镜像标签由Splitter版本和基础镜像版本组成，具体如下：

使用方法

拉取镜像

首先拉取所需标签的镜像到本地：

bash
docker pull openeuler/splitter:{Tag}

注意：将{Tag}替换为上述表格中的具体标签，如1.0.3-oe2403lts

生成切片（cut命令）

这是镜像的主要使用方式，用于生成指定的切片。以下示例演示如何生成openEuler 24.03-LTS（x86_64）的python3_standard切片并保存到当前目录。

1. 在主机上准备输出目录：

   bash
   mkdir -p ./output
   

2. 运行splitter cut命令：

   bash
   docker run \
     -v "$(pwd)/output":/output \
     --rm \
     openeuler/splitter:{Tag} \
     /bin/bash -c "splitter cut -r 24.03-LTS -a x86_64 -o /output python3_standard"
   

命令说明：

• -v "$(pwd)/output":/output：将主机的./output目录挂载到容器内的/output目录，生成的切片将保存在此位置
• --rm：命令执行完成后自动删除容器
• /bin/bash -c "..."：在容器内执行splitter cut命令
• -r 24.03-LTS：指定openEuler版本
• -a x86_64：指定架构
• -o /output：指定输出目录
• python3_standard：指定要生成的切片名称

命令执行完成后，可在主机的./output目录中找到生成的切片包。

生成SDF文件（gen命令）

对于需要创建新切片规则的开发者，splitter gen命令可生成特定RPM包的SDF文件。

1. 准备输出目录（可复用上述目录）：

   bash
   mkdir -p ./output
   

2. 运行splitter gen命令：

   bash
   docker run \
     -v "$(pwd)/output":/output \
     --rm \
     openeuler/splitter:{Tag} \
     /bin/bash -c "dnf install -y brotli && splitter gen -r 24.03-LTS -a x86_64 -o /output -p brotli"
   

命令说明：

• dnf install -y brotli：在容器内安装目标包（splitter gen需要分析包的文件内容）
• -p brotli：指定要生成SDF文件的包名
• 生成的SDF文件（如brotli.yaml）将保存在主机的./output目录中

验证安装或获取帮助

可运行无参数的splitter命令或使用--help查看可用选项：

bash
docker run --rm openeuler/splitter:{Tag} /bin/bash -c "splitter --help"

交互式Shell

如需调试或探索，可启动容器内的交互式shell：

bash
docker run -it --rm openeuler/splitter:{Tag} bash

问答与支持

如有问题或需要使用特殊功能，请在openeuler-docker-images提交issue或Pull Request。

更多关于Splitter的信息，请访问Splitter仓库。