s390x/buildpack-deps Docker 镜像

buildpack-deps (s390x架构) 镜像文档

镜像概述和主要用途

buildpack-deps 是 Docker 官方提供的基础镜像，专为 s390x 架构设计，旨在提供丰富的开发依赖环境。其设计理念类似于 Heroku 的 stack 镜像，包含大量"开发头文件"（development header）包，满足 Ruby Gems、PyPI 模块、npm 包等各类依赖的编译需求。例如，使用 buildpack-deps 可在任意应用目录中执行 bundle install，无需预先手动安装如 ssl.h 等编译依赖文件。

核心功能和特性

多场景依赖支持

包含大量编译依赖包（如开发头文件、库文件），覆盖绝大多数 gem install、npm install、pip install 等命令的依赖需求，减少手动安装开发包的操作。

多变体镜像

提供三种功能层级的镜像变体，适配不同开发场景：

• curl 变体：仅包含 curl、wget 和 ca-certificates，适用于需下载文件但无需源码控制的场景（如 Java JRE 环境）。
• scm 变体：基于 curl 变体，额外添加 bzr、git、hg、svn 等源码管理工具，适用于需拉取代码的开发环境（如 Java JDK 环境）。
• 完整变体（无后缀标签）：包含全部开发依赖，支持复杂的第三方库链接和模块编译，是通用开发环境的基础。

多系统版本支持

基于 Debian 和 Ubuntu 主流发行版，提供稳定版（stable）、测试版（testing/unstable）及特定版本（如 Ubuntu 22.04、24.04）的镜像，满足不同系统环境需求。

支持的标签及说明

Debian 系统标签

Ubuntu 系统标签

使用场景和适用范围

适用场景

• 语言栈基础镜像：作为 Python、Ruby、Node.js 等语言镜像的基础，提供编译环境。
• 依赖测试环境：快速验证第三方模块（如 Gems、PyPI 包）的编译可行性。
• CI/CD 流程：在持续集成中作为构建阶段的基础环境，减少依赖安装步骤。

不适用场景

• 生产环境：包含大量开发依赖，镜像体积较大，不适合直接用于生产部署。
• 无编译需求的场景：如仅需运行预编译二进制文件的环境（如 Go 应用）。

详细使用方法和配置说明

选择合适的变体

• 仅需下载文件：使用 curl 变体（如 trixie-curl）。
• 需下载并拉取代码：使用 scm 变体（如 trixie-scm）。
• 需完整编译环境：使用无后缀标签（如 trixie 或 latest）。

作为基础镜像构建自定义镜像

创建 Dockerfile 并以 buildpack-deps 为基础，例如构建 Python 开发环境：

dockerfile
# 使用 s390x 架构的 buildpack-deps 完整变体
FROM docker.xuanyuan.run/s390x/buildpack-deps:trixie

# 安装 Python 及相关工具
RUN apt-get update && apt-get install -y python3 python3-pip

# 设置工作目录
WORKDIR /app

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

# 复制应用代码
COPY . .

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

直接运行验证依赖

通过 docker run 启动容器，测试依赖安装：

bash
# 启动 s390x/buildpack-deps:trixie 容器
docker run -it --rm docker.xuanyuan.run/s390x/buildpack-deps:trixie bash

# 在容器内测试 gem install（需先安装 Ruby）
apt-get install -y ruby-full
gem install nokogiri  # 依赖 libxml2 等开发包，buildpack-deps 已包含

维护与支持

维护者

由 Docker 社区维护，源码托管于 https://github.com/docker-library/buildpack-deps。

获取帮助

• Docker 社区 Slack：https://dockr.ly/comm-slack
• Stack Overflow：https://unix.stackexchange.com/、Server Fault
• GitHub Issues：https://github.com/docker-library/buildpack-deps/issues

支持架构

仅支持 s390x 架构，其他架构需参考 https://hub.docker.com/_/buildpack-deps。

镜像更新

• 镜像更新跟踪：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fbuildpack-deps
• 源码变更历史：https://github.com/docker-library/buildpack-deps/commits/master

许可证

镜像中包含的软件许可证信息可参考 https://www.debian.org/social_contract#guidelines。镜像本身遵循 Docker 官方镜像的使用条款，用户需确保符合所有包含软件的许可证要求。

镜像元数据、传输大小等详细信息可在 https://github.com/docker-library/repo-info/blob/master/repos/buildpack-deps 查看。