Buildah项目安装指南：从入门到精通

羿辰果Gemstone

于 2025-06-05 09:09:55 发布

阅读量398

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01078/article/details/148441740

Buildah项目安装指南：从入门到精通

buildah A tool that facilitates building OCI images. 项目地址: https://gitcode.com/gh_mirrors/bui/buildah

什么是Buildah？

Buildah是一个专注于构建Open Container Initiative（OCI）容器镜像的工具，它允许用户在不依赖完整容器运行时的情况下创建、构建和修改容器镜像。与传统的容器构建工具不同，Buildah提供了更精细的控制能力，特别适合需要定制化构建流程的场景。

主流Linux发行版安装方法

基于RPM的发行版

Fedora/RHEL/CentOS系统：

# Fedora
sudo dnf -y install buildah

# RHEL/CentOS 7
sudo yum -y install buildah

# RHEL/CentOS 8+
sudo yum module enable -y container-tools:1.0
sudo yum module install -y buildah

在这些系统中，Buildah通常已经包含在默认软件仓库中，安装过程简单直接。值得注意的是，RHEL/CentOS 8及以上版本使用了模块化的软件仓库结构，需要通过启用container-tools模块来安装。

基于DEB的发行版

Debian/Ubuntu系统：

# Debian 12(Bookworm)及更新版本
sudo apt-get update
sudo apt-get -y install buildah

# Ubuntu 20.10及更新版本
sudo apt-get update
sudo apt-get -y install buildah

对于基于Debian的系统，Buildah从Debian 12和Ubuntu 20.10开始被纳入官方仓库，安装过程与其他软件包无异。

其他发行版

openSUSE：

sudo zypper install buildah

Gentoo：

sudo emerge app-containers/buildah

Arch Linux：

sudo pacman -S buildah

系统要求与依赖

内核版本要求

Buildah需要Linux内核支持OverlayFS或fuse-overlayfs文件系统：

RHEL/CentOS：需要7.4或更高版本
其他发行版：需查阅文档确认支持OverlayFS的内核版本

运行时依赖

runc：Buildah使用runc来执行容器命令，通常通过包管理器安装时会自动解决此依赖
CNI插件：用于配置容器网络命名空间，可通过以下方式安装：

git clone https://github.com/containernetworking/plugins
( cd ./plugins; ./build_linux.sh )
sudo mkdir -p /opt/cni/bin
sudo install -v ./plugins/bin/* /opt/cni/bin

从源码编译安装

准备工作

安装必要的构建工具和依赖：

Fedora：

sudo dnf -y install make golang bats btrfs-progs-devel glib2-devel \
    gpgme-devel libassuan-devel libseccomp-devel git bzip2 \
    go-md2man runc containers-common

Debian/Ubuntu：

sudo apt-get -y install bats btrfs-progs git go-md2man golang \
    libapparmor-dev libglib2.0-dev libgpgme11-dev libseccomp-dev \
    libselinux1-dev make skopeo

编译安装步骤

设置GOPATH环境变量
克隆Buildah源码仓库
执行编译和安装

完整示例：

mkdir ~/buildah
cd ~/buildah
export GOPATH=`pwd`
git clone https://github.com/containers/buildah ./src/github.com/containers/buildah
cd ./src/github.com/containers/buildah
make
sudo make install
buildah --help

重要配置文件

Buildah的正常运行依赖于几个关键配置文件，这些文件通常由containers-common软件包提供：

registries.conf：配置容器镜像仓库的搜索顺序、不安全仓库和阻止的仓库
- 位置：/etc/containers/registries.conf
mounts.conf：指定自动挂载到容器中的主机目录
- 位置：/usr/share/containers/mounts.conf或/etc/containers/mounts.conf
seccomp.json：定义容器内允许的系统调用规则
- 位置：/usr/share/containers/seccomp.json
policy.json：配置镜像来源的信任策略
- 位置：/etc/containers/policy.json