arm32v5/buildpack-deps

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

注意事项

注意： 这是 https://hub.docker.com/_/buildpack-deps 的 arm32v5 架构专用仓库。更多信息请参见官方镜像文档中的 "https://github.com/docker-library/official-images#architectures-other-than-amd64" 及官方镜像 FAQ 中的 "https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%22%E3%80%82

镜像概述与主要用途

buildpack-deps 是一系列常用构建依赖的集合，用于安装各类模块（如 Ruby Gems、PyPI 模块等）。其设计理念类似于 https://github.com/heroku/stack-images/blob/master/bin/cedar.sh%EF%BC%8C%E5%8C%85%E5%90%AB%E5%A4%A7%E9%87%8F "开发头文件" 包，可解决模块安装过程中因缺少依赖（如 ssl.h）导致的构建失败问题，为语言栈镜像提供基础构建环境。

核心功能与特性

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

支持的标签与对应 Dockerfile 链接

快速参考

• 维护者：https://github.com/docker-library/buildpack-deps
• 获取帮助：Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow
• 问题反馈：https://github.com/docker-library/buildpack-deps/issues
• 支持架构：https://hub.docker.com/r/amd64/buildpack-deps/%E3%80%81https://hub.docker.com/r/arm32v5/buildpack-deps/%E3%80%81https://hub.docker.com/r/arm32v7/buildpack-deps/%E3%80%81https://hub.docker.com/r/arm64v8/buildpack-deps/%E3%80%81https://hub.docker.com/r/i386/buildpack-deps/%E3%80%81https://hub.docker.com/r/mips64le/buildpack-deps/%E3%80%81https://hub.docker.com/r/ppc64le/buildpack-deps/%E3%80%81https://hub.docker.com/r/riscv64/buildpack-deps/%E3%80%81https://hub.docker.com/r/s390x/buildpack-deps/
• 镜像工件详情：https://github.com/docker-library/repo-info/blob/master/repos/buildpack-deps%EF%BC%88%E5%8C%85%E5%90%AB%E5%85%83%E6%95%B0%E6%8D%AE%E3%80%81%E4%BC%A0%E8%BE%93%E5%A4%A7%E5%B0%8F%E7%AD%89%EF%BC%89
• 镜像更新：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fbuildpack-deps 及 https://github.com/docker-library/official-images/blob/master/library/buildpack-deps
• 描述来源：https://github.com/docker-library/docs/tree/master/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 变体下载文件

bash
docker run --rm arm32v5/buildpack-deps:bookworm-curl curl -O https://example.com/file.tar.gz

2. scm 变体

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

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

bash
docker run --rm arm32v5/buildpack-deps:bookworm-scm git clone https://github.com/example/repo.git

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

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

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

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

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

许可证

• 镜像中软件的许可证信息参见 Debian 许可证指南。
• 镜像可能包含其他软件（如 Bash 等基础系统组件），其许可证可能不同。
• 自动检测的额外许可证信息可参见 https://github.com/docker-library/repo-info/tree/master/repos/buildpack-deps%E3%80%82

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