buildpack-deps 镜像文档

1. 镜像概述和主要用途

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

本镜像为基于 Ubuntu 的 buildpack 镜像分支，更多信息可参考 官方上游仓库。

2. 支持的标签及 Dockerfile 链接

注：trusty、utopic、vivid 为 Ubuntu 版本代号；-curl 和 -scm 为功能变体。

3. 核心功能和特性

3.1 全量标签功能（如 trusty、utopic、vivid）

包含完整的依赖集合，支持大多数 gem install、npm install、pip install 操作，无需额外安装头文件或开发包。

3.2 curl 变体（如 trusty-curl、utopic-curl、vivid-curl）

基于基础镜像，仅包含 curl、wget 和 ca-certificates 包，适用于需频繁下载文件（如 JAR 包）但无需代码检出的场景（如 Java JRE）。

3.3 scm 变体（如 trusty-scm、utopic-scm、vivid-scm）

基于 curl 变体，额外添加 bzr、git、hg、svn 等源代码管理工具（不含 cvs），适用于需下载文件及代码检出的场景（如 Java JDK）。

4. 使用场景和适用范围

• 语言栈镜像基础：作为 Ruby、Node.js、Python 等语言栈镜像的底层依赖，提供完整构建环境。
• 全量标签：适用于需频繁安装各类模块、依赖大量外部 C 库链接的场景。
• curl 变体：适用于以下载操作为主，无需代码管理的场景（如运行时环境）。
• scm 变体：适用于需同时进行文件下载和代码检出的场景（如开发环境）。

5. 使用方法和配置说明

5.1 基础用法

本镜像设计为语言栈镜像的基础层，典型用法是在 Dockerfile 中作为基础镜像引用。

示例 1：基于全量标签构建 Python 环境

FROM buildpack-deps:trusty
RUN apt-get update && apt-get install -y python3 python3-pip && rm -rf /var/lib/apt/lists/*
# 无需额外安装开发包即可执行 pip install
RUN pip3 install numpy pandas

示例 2：基于 curl 变体构建 Java JRE 环境

FROM buildpack-deps:trusty-curl
# 使用 curl 下载并安装 JRE
RUN curl -fsSL [***] -o /tmp/jre.tar.gz && \
    tar -xzf /tmp/jre.tar.gz -C /opt && \
    rm /tmp/jre.tar.gz
ENV PATH="/opt/jre/bin:${PATH}"

示例 3：基于 scm 变体构建 Java JDK 环境

FROM buildpack-deps:trusty-scm
# 使用 git 检出代码，curl 下载依赖
RUN git clone [***] /app && \
    cd /app && \
    curl -fsSL [***] -o deps.tar.gz && \
    tar -xzf deps.tar.gz

5.2 变体选择依据

• 若需频繁执行 gem install/npm install/pip install，选择全量标签。
• 若仅需下载文件（如运行时依赖），选择curl 变体。
• 若需下载文件并检出代码，选择scm 变体。

6. 许可证

镜像包含软件的许可证信息参见 Debian 开源准则。

7. 支持的 Docker 版本

• 官方支持 Docker 1.5.0 及以上版本。
• 对 1.0 及以上旧版本提供尽力支持。

8. 用户反馈

8.1 问题反馈

如遇镜像相关问题或疑问，请通过 GitHub issue 提交。

8.2 贡献方式

欢迎提交新功能、修复或更新（大小不限）。建议重大变更前通过 GitHub issue 讨论，以确保方向一致。提交 PR 后，我们将尽快处理。