buildpack-deps 镜像文档

概述

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

!logo

核心功能与特性

完整版本（主标签）

包含大量开发依赖包，支持绝大多数 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 指令的基础镜像：

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

变体使用示例

curl 变体：下载文件

docker run --rm buildpack-deps:curl wget [***]

scm 变体：克隆代码仓库

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

完整版本：安装 Ruby Gems

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

维护与支持

• 维护者：Docker 社区
• 获取帮助：Docker Community Slack、Server Fault、Unix & Linux、Stack Overflow
• 支持架构：amd64、arm32v5、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
• 镜像更新：official-images 仓库 library/buildpack-deps 标签
• 问题反馈：GitHub Issues

许可证

镜像中软件的许可证信息请参见 Debian 许可指南。
Docker 镜像可能包含其他软件（如 Bash 等基础发行版组件），其许可证可能不同。
额外许可证信息可在 repo-info 仓库的 buildpack-deps 目录 中找到。
使用前请确保遵守所有包含软件的许可证要求。