bandsintown/ruby

Ruby镜像

镜像概述和主要用途

Ruby是一种动态、反射式、面向对象的通用开源编程语言，受Perl、Smalltalk、Eiffel、Ada和Lisp等语言影响，支持函数式、面向对象和命令式等多种编程范式，具有动态类型系统和自动内存管理。本镜像基于Alpine Linux，在官方Ruby镜像基础上使用自定义Alpine基础镜像，集成Consul和Consul Template以实现Ruby应用的动态配置，适用于Ruby应用的容器化部署。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 动态配置：集成Consul和Consul Template，支持Ruby应用的动态配置
• 便捷构建：包含多个ONBUILD触发器，自动复制应用代码并安装依赖（bundle install）
• 版本支持：提供不同Ruby版本标签（如2.4.2），满足多样化应用需求

使用场景和适用范围

• Ruby应用的容器化部署
• 需要动态配置的Ruby应用环境
• 简单Ruby脚本的快速运行与测试
• 开发和生产环境中的Ruby应用容器化管理

使用方法和配置说明

创建Ruby应用项目的Dockerfile

在Ruby应用项目根目录下创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/bandsintown/ruby:2.4.2
CMD ["./your-daemon-or-script.rb"]

将此文件放在应用根目录（与Gemfile同级）。该镜像包含ONBUILD触发器，自动执行：

• COPY . /usr/src/app：复制应用代码到容器内
• RUN bundle install：安装项目依赖

构建并运行镜像：

console
$ docker build -t my-ruby-app .
$ docker run -it --name my-running-script my-ruby-app

生成Gemfile.lock

onbuild标签要求应用目录中存在Gemfile.lock。在应用根目录（与Gemfile同级）执行以下命令生成：

console
$ docker run --rm -v "$PWD":/usr/src/app -w /usr/src/app bandsintown/ruby:2.4.2 bundle install

运行单个Ruby脚本

对于简单单文件项目，可直接使用镜像运行脚本，无需编写Dockerfile：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp bandsintown/ruby:2.4.2 ruby your-daemon-or-script.rb

镜像背景

本镜像基于https://github.com/docker-library/docs/tree/master/ruby%EF%BC%8C%E4%BD%86%E4%BD%BF%E7%94%A8https://github.com/bandsintown/docker-alpine%E6%9E%84%E5%BB%BA%E3%80%82%E6%97%A8%E5%9C%A8%E9%80%9A%E8%BF%87%E9%9B%86%E6%88%90Consul%E5%92%8CConsul Template，实现Ruby应用的动态配置能力。

许可

本仓库所有代码（除非另有明确说明）均采用ISC许可。详细许可信息参见LICENSE文件。