Buildpack Deps Docker 镜像

buildpack-deps 镜像文档

概述

buildpack-deps 镜像在设计理念上类似于 https://github.com/heroku/stack-images/blob/master/bin/cedar.sh，包含大量开发所需的"头文件"包，适用于 Ruby Gems、PyPI 模块等各类依赖的编译安装。例如，使用 buildpack-deps 可以在任意应用目录中执行 bundle install，而无需预先知晓构建依赖模块是否需要 ssl.h 等头文件。

核心功能与特性

完整版本（主标签）

包含大量开发依赖包，支持绝大多数 gem install、npm install、pip install 等命令无需额外安装头文件即可成功执行。

curl 变体

基于基础镜像，仅包含 curl、wget 和 ca-certificates 包。适用于需下载文件但无需版本控制的场景（如 Java JRE 环境下载 JAR 包）。

scm 变体

基于 curl 变体，额外包含多种版本控制工具：bzr、git、hg 和 svn（不含 cvs）。适用于需下载文件且需版本控制的场景（如 Java JDK 环境中检出代码）。

支持的标签

Debian 系列

Ubuntu 系列

使用场景与适用范围

• 语言栈基础镜像：作为 Ruby、Python、Node.js 等语言栈镜像的基础，提供编译依赖。
• 模块安装场景：需执行 gem install、npm install、pip install 等命令，且预先未知依赖的开发头文件时。
• 精简需求场景：仅需下载功能（curl 变体）或版本控制功能（scm 变体）时，减少镜像体积。

使用方法

基础使用

该镜像设计为语言栈镜像的基础层，通常作为 FROM 指令的基础镜像：

dockerfile
# 使用完整版本作为 Ruby 镜像基础
FROM docker.xuanyuan.run/buildpack-deps:latest
RUN apt-get update && apt-get install -y ruby && rm -rf /var/lib/apt/lists/*

变体使用示例

curl 变体：下载文件

bash
docker run --rm docker.xuanyuan.run/buildpack-deps:curl wget https://example.com/file.tar.gz

scm 变体：克隆代码仓库

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

完整版本：安装 Ruby Gems

bash
docker run -v $(pwd):/app --rm docker.xuanyuan.run/buildpack-deps:latest sh -c "cd /app && gem install bundler && bundle install"

维护与支持

• 维护者：https://github.com/docker-library/buildpack-deps
• 获取帮助：https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic、https://stackoverflow.com/help/on-topic
• 支持架构：amd64、arm32v5、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
• 镜像更新：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fbuildpack-deps
• 问题反馈：https://github.com/docker-library/buildpack-deps/issues

许可证

镜像中软件的许可证信息请参见 https://www.debian.org/social_contract#guidelines。
Docker 镜像可能包含其他软件（如 Bash 等基础发行版组件），其许可证可能不同。
额外许可证信息可在 https://github.com/docker-library/repo-info/tree/master/repos/buildpack-deps 中找到。
使用前请确保遵守所有包含软件的许可证要求。