Alpine/Bundle Docker镜像文档

镜像概述与主要用途

基本信息

Alpine/Bundle是一个基于Alpine Linux的Docker镜像，集成了Bundler工具，用于管理Ruby应用的gem依赖。该镜像的标签对应容器内运行的Ruby版本（非Bundler版本）。

重要说明

• 仓库状态：本镜像的源代码仓库已于2023年6月30日被归档，目前处于只读状态，不再接收更新。
• 官方替代方案：官方ruby镜像已原生包含bundle工具，建议优先使用官方镜像满足Bundler需求。

核心功能与特性

1. 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低。
2. Bundler集成：预集成Bundler工具，可直接用于Ruby应用的依赖管理（如bundle install、bundle exec等）。
3. Ruby版本对应：镜像标签与Ruby版本绑定（非Bundler版本），例如alpine/bundle:2.4.2对应Ruby 2.4.2环境。

使用场景与适用范围

适用场景

• 需要在隔离环境中快速使用Bundler管理Ruby项目依赖。
• CI/CD流程中自动化执行bundle install等依赖安装命令。

局限性说明

由于官方ruby镜像已原生包含bundle工具，本镜像的使用场景已大幅缩减，建议优先评估官方镜像是否满足需求。

使用方法与配置说明

基本使用要求

容器运行时需将本地项目目录挂载至容器内/apps路径，Bundler操作将基于该目录下的项目文件（如Gemfile）。

示例1：交互式运行容器并执行Bundler命令

# 挂载当前目录至容器/apps，启动交互式bash终端
docker run -ti -v $(pwd):/apps alpine/bundle:2.4.2 bash

# 在容器内执行依赖安装
bundle install

# 执行项目命令（如rake任务）
bundle exec rake

示例2：创建alias简化Bundler命令调用

通过alias将本地bundle命令映射为容器运行，实现无缝使用：

# 设置alias（可添加至.bashrc或.zshrc）
alias bundle="docker run -ti --rm -v $(pwd):/apps alpine/bundle:2.4.2 bundle"

# 直接使用bundle命令（实际在容器中执行）
bundle --help
bundle install

镜像构建流程（历史说明）

本镜像的历史构建流程如下：

1. 通过Travis CI定时任务每日在master分支触发构建。
2. 调用GitHub REST API检查Ruby新标签/版本发布。
3. 调用Docker Hub REST API比对现有镜像标签。
4. 若版本不匹配，构建并推送新标签镜像至Docker Hub。
5. 注意：Ruby 2.5.0以下版本为手动构建并推送。

相关资源

• 源代码仓库：[***]
• 每日构建日志：[***]
• Docker镜像标签列表：[***]