mellanox/bluefield

mellanox/bluefield 镜像文档

概述

mellanox/bluefield容器提供用于创建BlueField OS镜像（BFB）的环境，生成的BFB可通过以下命令安装到BlueField设备：
$ cat <BFB file> [<bf.conf>] > /dev/rshim0/boot

核心功能与特性

• 支持构建多种BlueField OS镜像：Ubuntu 20.04、Debian10、CentOS7.6 ALT、CentOS8.2
• 允许自定义文件系统：安装/移除软件包、修改配置等
• 支持指定内核版本生成BFB
• 兼容x86_64和aarch64架构服务器（aarch64服务器运行效率更高）

使用场景

适用于需要为BlueField设备构建自定义BFB镜像的场景，如：

• 定制化系统配置
• 预装特定软件包
• 适配特定内核版本

使用方法

1. 安装Docker

在x86_64或aarch64服务器上安装Docker，参考官方文档：[***]

注意：在ARM（aarch64）服务器上运行无需qemu，速度更快

2. x86_64服务器额外配置（qemu）

若使用x86_64服务器，需安装并配置qemu：

Ubuntu服务器：

bash
$ sudo apt install qemu-user-static

CentOS服务器：

bash
$ sudo yum install epel-release
$ sudo yum install qemu-system-arm

Fedora服务器：

bash
$ sudo yum install qemu-system-aarch64

3. 配置binfmt

创建/etc/binfmt.d/qemu-aarch64.conf文件：

bash
$ cat /etc/binfmt.d/qemu-aarch64.conf
:qemu-aarch64:M::\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7:\xff\xff\xff\xff\xff\xff\xff\xfc\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff:/usr/bin/qemu-aarch64-static:

重启binfmt服务：

bash
$ sudo systemctl restart systemd-binfmt

4. 运行容器

拉取镜像

bash
$ docker pull mellanox/bluefield:bfb_builder_ubuntu18.04.3-5.0-2.1.8.3.2

启动容器

bash
$ docker run --privileged -it -e container=docker mellanox/bluefield:bfb_builder_ubuntu18.04.3-5.0-2.1.8.3.2

5. 自定义文件系统

在容器内进行系统定制，例如：

• 使用apt安装/移除软件包
• 修改配置文件
• 调整系统参数

CentOS注意事项：在x86_64服务器上运行ARM容器构建内核RPM时，需禁用内核调试信息包：

bash
cat > /root/.rpmmacros << EOF
%debug_package %{nil}
%with_debuginfo 0
%__debug_install_post %{nil}
EOF

6. 修改BFB版本（可选）

编辑/etc/mlnx-release文件可修改生成的BFB版本信息。

7. 创建BFB

在容器内执行以下命令生成BFB：

bash
$ /root/workspace/create_bfb -k <kernel version>

• <kernel version>：BlueField设备将运行的内核版本，需确保/lib/modules/<kernel version>目录存在

生成的BFB文件路径示例：
/root/workspace/Ubuntu18.04.3-MLNX_OFED_LINUX-UPSTREAM-LIBS-5.0-2.1.8.3.2-aarch64.bfb

参考链接

• BlueField软件更多信息：[***]
• BFB构建详细指南：https://github.com/Mellanox/bfb-build