arm32v7/buildpack-deps 镜像文档

镜像概述和主要用途

arm32v7/buildpack-deps 是官方 buildpack-deps 镜像的 arm32v7 架构专用版本，旨在提供丰富的构建依赖环境。其设计理念类似于 Heroku 的 stack 镜像，包含大量开发头文件和库文件，适用于安装 Ruby Gems、PyPI 模块、npm 包等第三方依赖时，无需预先手动安装编译所需的系统级开发依赖（如 ssl.h 等）。

核心功能和特性

丰富的开发依赖集成

主要标签包含完整的开发工具链和头文件，支持绝大多数 gem install、npm install、pip install 等命令直接运行，无需额外安装系统依赖。

多变体设计

提供三种功能层级的镜像变体，满足不同场景需求：

• 基础变体（如 bookworm、jammy）：包含完整的开发依赖，支持复杂模块编译
• scm 变体（如 bookworm-scm、jammy-scm）：基于 curl 变体，额外集成 bzr、git、hg、svn 等版本控制工具
• curl 变体（如 bookworm-curl、jammy-curl）：仅包含 curl、wget 和 ca-certificates，适用于仅需文件下载的场景

多系统版本支持

基于 Debian（如 bookworm、bullseye）和 Ubuntu（如 jammy、noble）的多个稳定版本构建，提供灵活的基础环境选择。

使用场景和适用范围

语言栈基础镜像

作为 Ruby、Python、Node.js 等语言栈镜像的基础，提供编译环境支持，简化第三方依赖安装流程。

模块化依赖管理

• curl 变体：适用于仅需下载文件的场景（如 Java JRE 镜像，需下载 JAR 包但无需代码检出）
• scm 变体：适用于需要版本控制工具的场景（如 Java JDK 镜像，需检出代码并下载依赖）
• 基础变体：适用于需要完整编译环境的场景（如 Ruby 镜像，需编译大量原生扩展）

支持的标签及 Dockerfile 链接

使用方法和配置说明

作为基础镜像构建语言栈

buildpack-deps 主要用于作为其他语言栈镜像的基础。以下是基于 arm32v7/buildpack-deps 构建 Python 环境的示例 Dockerfile：

# 基于完整变体构建 Python 环境
FROM arm32v7/buildpack-deps:bookworm

# 安装 Python 及依赖
RUN apt-get update && apt-get install -y python3 python3-pip \
    && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /app

# 复制依赖文件并安装
COPY requirements.txt .
RUN pip3 install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 运行应用
CMD ["python3", "app.py"]

验证镜像功能

检查 curl 变体工具

docker run --rm arm32v7/buildpack-deps:bookworm-curl curl --version
docker run --rm arm32v7/buildpack-deps:bookworm-curl wget --version

检查 scm 变体版本控制工具

docker run --rm arm32v7/buildpack-deps:bookworm-scm git --version
docker run --rm arm32v7/buildpack-deps:bookworm-scm svn --version

检查完整变体开发依赖

# 验证是否可编译简单 C 程序
docker run --rm -v $(pwd):/app arm32v7/buildpack-deps:bookworm \
  sh -c "gcc /app/hello.c -o /app/hello && /app/hello"

参考信息

维护与支持

• 维护者：Docker 社区 (GitHub 仓库)
• 获取帮助：Docker Community Slack、Server Fault、Unix & Linux 或 Stack Overflow

架构支持

除 arm32v7 外，官方 buildpack-deps 还支持以下架构：amd64、arm32v5、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

镜像更新与元数据

• 镜像更新：通过 official-images 仓库的 library/buildpack-deps 标签 跟踪
• 元数据信息：包含在 repo-info 仓库的 buildpack-deps 目录

许可证

镜像中软件的许可证信息可参考 Debian 许可证指南。使用前需确保符合所有包含软件的许可证要求。

文档来源

本文档基于 docker-library/docs 仓库的 buildpack-deps 目录 生成。