islandora/abuild

ABuild

镜像概述和主要用途

ABuild是一个基于abuild工具的Docker镜像，用于创建apk软件包，生成的软件包可供其他Docker容器使用。该镜像并非作为服务部署，而是作为创建软件包的基础镜像，例如在islandora/imagemagick等项目中用于构建特定依赖包。

核心功能和特性

• 提供abuild工具完整运行环境，支持Alpine软件包的标准构建流程
• 内置密钥生成功能，可生成用于软件包签名的私钥/公钥对
• 优化的构建缓存机制，提升依赖安装效率
• 标准化的构建用户权限管理，确保构建过程安全

使用场景和适用范围

适用于需要创建自定义Alpine软件包的场景，特别是作为Docker镜像构建流水线中的基础环节，用于生成项目特定的依赖包，供后续镜像通过多阶段构建方式引入。

使用方法和配置说明

构建准备

1. 在项目目录中创建/build文件夹，存放描述软件包构建流程的APKBUILD文件
2. 准备构建所需的依赖列表（仅包含构建时依赖，无需运行时依赖）

Dockerfile构建示例

dockerfile
# syntax=docker/dockerfile:1.2.1
FROM islandora/abuild:latest

# 安装构建软件包所需的依赖（替换为实际依赖包名）
RUN --mount=type=cache,id=base-apk,sharing=locked,target=/var/cache/apk \
    apk-install.sh \
        package-require-for-building-1 \
        package-require-for-building-2 \

COPY /build /build

WORKDIR /build

RUN chown -R builder /build

# 可选：指定包维护者信息
ARG PACKAGER="Packer Name <packager@gmail.com>"

USER builder

RUN export PACKAGER="${PACKAGER}" && \
    abuild-keygen -ain && \  # 生成签名密钥
    abuild-apk update && \   # 更新APK索引
    abuild                   # 执行构建

后续镜像使用示例

通过多阶段构建和Buildkit绑定挂载方式，在目标镜像中引入构建好的软件包：

dockerfile
FROM islandora/package_image:latest as PACKAGE_IMAGE  # 引用构建好的软件包镜像

FROM islandora/crayfish:latest

RUN --mount=type=bind,from=PACKAGE_IMAGE,source=/home/builder/packages/x86_64,target=/packages \
    --mount=type=bind,from=PACKAGE_IMAGE,source=/etc/apk/keys,target=/etc/apk/keys \
    --mount=type=cache,target=/root/.composer/cache \
    apk add /packages/PACKAGE_NAME-*.apk && \  # 安装自定义软件包
    ... 其他构建步骤 ... && \
    cleanup.sh  # 清理构建缓存

依赖

构建此镜像需要基础镜像：alpine:3.11.6

参考

• 创建Alpine软件包
• Abuild和辅助工具