buildpack-deps (arm32v5架构) 镜像文档

注意事项

注意： 这是 buildpack-deps 官方镜像 的 arm32v5 架构专用仓库。更多信息请参见官方镜像文档中的 "非 amd64 架构说明" 及官方镜像 FAQ 中的 "镜像源码在 Git 中变更后如何处理？"。

镜像概述与主要用途

buildpack-deps 是一系列常用构建依赖的集合，用于安装各类模块（如 Ruby Gems、PyPI 模块等）。其设计理念类似于 Heroku 的 stack 镜像，包含大量 "开发头文件" 包，可解决模块安装过程中因缺少依赖（如 ssl.h）导致的构建失败问题，为语言栈镜像提供基础构建环境。

核心功能与特性

• 丰富的依赖覆盖：集成大量开发头文件和工具链，支持大多数 gem install、npm install、pip install 等命令无需额外安装依赖即可完成
• 多变体设计：提供不同功能级别的镜像变体，满足不同场景需求
• 多架构支持：包含 arm32v5 等多种架构版本，适配嵌入式设备等特定硬件环境
• 基于 Debian：以 Debian 稳定版为基础，确保系统级依赖的可靠性和兼容性

支持的标签与对应 Dockerfile 链接

快速参考

• 维护者：Docker 社区
• 获取帮助：Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow
• 问题反馈：GitHub Issues
• 支持架构：amd64、arm32v5、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
• 镜像工件详情：repo-info 仓库的 buildpack-deps 目录（包含元数据、传输大小等）
• 镜像更新：official-images 仓库的 library/buildpack-deps 标签 及 配置文件
• 描述来源：docs 仓库的 buildpack-deps 目录

使用场景与适用范围

• 语言栈镜像基础：作为 Ruby、Python、Node.js 等语言镜像的基础层，提供构建依赖
• 模块安装环境：需执行 gem install、pip install、npm install 等命令的场景
• 轻量级下载工具：通过 curl 变体快速获取网络资源（如 JAR 包、安装脚本）
• 源码管理操作：通过 scm 变体执行 git/svn/hg 等版本控制命令
• ARM 架构开发：在树莓派等 arm32v5 架构设备上构建应用依赖

使用方法与配置说明

基础使用

该镜像主要作为基础镜像用于构建其他镜像，或直接运行容器执行依赖安装、资源下载等操作。

变体说明

1. curl 变体

包含工具：curl、wget、ca-certificates
适用场景：仅需下载网络资源（如 JAR 包、安装脚本）的场景，例如 Java JRE 镜像基础。

示例：使用 curl 变体下载文件

docker run --rm arm32v5/buildpack-deps:bookworm-curl curl -O [***]

2. scm 变体

基于：curl 变体
额外工具：bzr（Bazaar）、git、hg（Mercurial）、svn（Subversion）
适用场景：需检出代码的场景，例如 Java JDK 镜像基础或源码构建环境。

示例：使用 scm 变体克隆 Git 仓库

docker run --rm arm32v5/buildpack-deps:bookworm-scm git clone [***]

3. 完整变体（无后缀标签）

基于：scm 变体
包含内容：完整的开发依赖（如编译器、库头文件等）
适用场景：大多数需要安装模块的场景，支持 gem install、pip install 等命令无需额外依赖。

示例：作为基础镜像构建 Python 应用镜像（Dockerfile）

FROM arm32v5/buildpack-deps:bookworm AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

FROM arm32v5/python:slim-bookworm
WORKDIR /app
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY . .
CMD ["python", "app.py"]

4. 完整版本（无变体后缀标签）

标签示例：bookworm、stable、latest
包含内容：所有开发依赖，支持绝大多数模块安装
适用场景：需要完整构建依赖的通用场景。

示例：直接运行容器安装 Ruby Gem

docker run --rm -v $(pwd):/app arm32v5/buildpack-deps:bookworm bash -c "cd /app && gem install json"

许可证

• 镜像中软件的许可证信息参见 Debian 许可证指南。
• 镜像可能包含其他软件（如 Bash 等基础系统组件），其许可证可能不同。
• 自动检测的额外许可证信息可参见 repo-info 仓库的 buildpack-deps 目录。

使用责任：镜像用户需自行确保对镜像中所有软件的使用符合相关许可证要求。