library/buildpack-deps

buildpack-deps 镜像文档

概述

buildpack-deps 镜像在设计理念上类似于 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%E5%BC%80%E5%8F%91%E6%89%80%E9%9C%80%E7%9A%84%22%E5%A4%B4%E6%96%87%E4%BB%B6%22%E5%8C%85%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E Ruby Gems、PyPI 模块等各类依赖的编译安装。例如，使用 buildpack-deps 可以在任意应用目录中执行 bundle install，而无需预先知晓构建依赖模块是否需要 ssl.h 等头文件。

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/buildpack-deps/logo.png

核心功能与特性

完整版本（主标签）

包含大量开发依赖包，支持绝大多数 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 buildpack-deps:latest
RUN apt-get update && apt-get install -y ruby && rm -rf /var/lib/apt/lists/*

变体使用示例

curl 变体：下载文件

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

scm 变体：克隆代码仓库

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

完整版本：安装 Ruby Gems

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

维护与支持

• 维护者：https://github.com/docker-library/buildpack-deps
• 获取帮助：Docker Community Slack、Server Fault、Unix & Linux、Stack Overflow
• 支持架构：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

许可证

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