Bitnami Ruby 镜像文档

Ruby简介

Ruby on Rails 是一个全栈开发环境，以程序员幸福感和可持续生产力为优化目标。它通过"约定优于配置"的原则，让你能够编写优雅的代码。

Ruby官方概述
商标说明：本软件包由Bitnami打包。所提及的相关商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

快速启动

docker run -it --name ruby bitnami/ruby:latest

重要通知：Bitnami 镜像目录即将变更

自2025年8月28日起，Bitnami将升级其公共镜像目录，通过新的Bitnami安全镜像计划提供精选的强化安全镜像集。此次变更包括：

• 首次向社区用户开放热门容器镜像的安全优化版本访问权限
• Bitnami将逐步停止对免费层级中非强化的Debian基础镜像的支持，并从公共目录中逐步移除非最新标签。社区用户将只能访问数量减少的强化镜像，这些镜像仅以"latest"标签发布，适用于开发目的
• 自8月28日起，在两周内，所有现有容器镜像（包括旧版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至"Bitnami Legacy"仓库（docker.io/bitnamilegacy），且不再接收更新
• 对于生产工作负载和长期支持，建议用户采用Bitnami安全镜像，包括强化容器、更小攻击面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持

这些变更旨在通过推广软件供应链完整性最佳实践和最新部署，提升所有Bitnami用户的安全态势。更多详情请访问Bitnami安全镜像公告。

Bitnami安全镜像优势

• 构建Bitnami安全镜像和Helm图表的目标是提升开源软件的安全性和企业就绪性
• 通过行业标准漏洞可利用性交换（VEX）、KEV和EPSS评分，更快地分类安全漏洞并透明呈现CVE风险
• 强化镜像采用最小化操作系统（Photon Linux），减少攻击面的同时通过行业标准包格式保持可扩展性
• 持续构建的镜像在上游补丁发布后数小时内更新，确保安全性和合规性
• Bitnami容器、虚拟机和云镜像使用相同组件和配置方法，便于根据项目需求在不同格式间切换
• 强化镜像附带证明签名（Notation）、SBOM、病毒扫描报告和其他元数据，通过SLSA-3合规软件工厂生成

仅部分BSI应用可免费使用。如需访问完整应用目录及企业支持，请尝试Bitnami安全镜像商业版。

支持的标签及Dockerfile链接

了解Bitnami标签策略及滚动标签与不可变标签的区别，请参阅官方文档。

不同标签的对应关系可通过分支文件夹中的tags-info.yaml文件查看，例如bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml。

订阅项目更新请关注bitnami/containers GitHub仓库。

弃用说明

• 2022-01-21：prod标签已移除，仅发布常规容器镜像
• 2020-08-18：prod标签格式变更：
  • BRANCH-debian-10-prod 变更为 BRANCH-prod-debian-10
  • VERSION-debian-10-rX-prod 变更为 VERSION-prod-debian-10-rX
  • latest-prod 标签已弃用

获取镜像

推荐通过Docker Hub Registry拉取预构建镜像：

docker pull bitnami/ruby:latest

如需特定版本，可拉取带版本标签的镜像。查看可用版本列表。

docker pull bitnami/ruby:[TAG]

如需手动构建，克隆仓库后执行构建命令（替换APP、VERSION和OPERATING-SYSTEM占位符）：

git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

进入交互式解释器（REPL）

默认情况下，运行此镜像将启动Ruby交互式解释器（irb），可在此进行Ruby代码测试：

docker run -it --name ruby bitnami/ruby:latest

延伸阅读：Ruby IRB文档

配置说明

运行Ruby脚本

Ruby镜像的默认工作目录为/app。可将主机目录挂载至此，并通过ruby命令运行脚本：

docker run -it --name ruby -v /path/to/app:/app bitnami/ruby:latest \
  ruby script.rb

使用Gems运行Ruby应用

若应用通过Gemfile定义依赖，可先安装依赖再运行应用：

docker run -it --name ruby -v /path/to/app:/app bitnami/ruby:latest \
  sh -c "bundle install && ruby script.rb"

或通过docker-compose.yml配置（参考官方示例）：

ruby:
  image: bitnami/ruby:latest
  command: "sh -c 'bundle install && ruby script.rb'"
  volumes:
    - .:/app

延伸阅读：

• rubygems.org
• bundler.io

访问运行中的Ruby Web服务

镜像默认暴露容器内3000端口。需确保Web服务器绑定至0.0.0.0:3000以接受外部连接。

示例：使用Sinatra框架监听0.0.0.0:3000的应用：

require 'sinatra'

set :bind, '0.0.0.0'
set :port, 3000

get '/hi' do
  "Hello World!"
end

端口映射方式

• 随机端口映射：让Docker随机分配主机端口

docker run -it --name ruby -P bitnami/ruby:latest

通过docker port命令查看映射端口：

$ docker port ruby
3000/tcp -> 0.0.0.0:32769

• 指定端口映射：手动指定主机端口（如8080）映射至容器3000端口

docker run -it --name ruby -p 8080:3000 bitnami/ruby:latest

访问应用：http://localhost:8080

FIPS模式配置（Bitnami安全镜像）

Bitnami安全镜像提供FIPS模式配置，通过以下环境变量设置：

• OPENSSL_FIPS：是否启用OpenSSL FIPS模式。可选值：yes（默认）、no

与其他容器通信

通过Docker网络可实现Ruby服务与其他容器（如Nginx）的通信。以下以Nginx作为前端代理为例说明。

通过Nginx代理Ruby应用

将Ruby Web服务通过Nginx暴露，可实现静态资源服务、负载均衡等高级配置。

步骤1：创建网络

Docker命令：

docker network create app-tier --driver bridge

Docker Compose配置：

version: '2'

networks:
  app-tier:
    driver: bridge

步骤2：配置Nginx虚拟主机

创建Nginx配置文件（反向代理至Ruby容器）：

server {
    listen 0.0.0.0:80;
    server_name yourapp.com;

    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header HOST $http_host;
        proxy_set_header X-NginX-Proxy true;

        proxy_pass [***]  # 使用Ruby容器的网络别名
        proxy_redirect off;
    }
}

保存文件（如vhost.conf），后续将作为卷挂载至Nginx容器。

步骤3：运行Ruby容器（指定网络别名）

Docker命令：

docker run -it --name myapp \
  --network app-tier \
  -v /path/to/app:/app \
  bitnami/ruby:latest ruby script.rb

Docker Compose配置：

version: '2'
services:
  myapp:
    image: bitnami/ruby:latest
    command: ruby script.rb
    networks:
      - app-tier
    volumes:
      - .:/app

步骤4：运行Nginx容器

Docker命令：

docker run -it \
  -v /path/to/vhost.conf:/bitnami/nginx/conf/vhosts/yourapp.conf \
  --network app-tier \
  bitnami/nginx:latest

Docker Compose配置：

version: '2'
services:
  nginx:
    image: bitnami/nginx:latest
    networks:
      - app-tier
    volumes:
      - /path/to/vhost.conf:/bitnami/nginx/conf/vhosts/yourapp.conf

维护说明

升级镜像

Bitnami会及时更新Ruby镜像（包括安全补丁），建议按以下步骤升级：

步骤1：拉取更新镜像

docker pull bitnami/ruby:latest

（Docker Compose用户需更新image字段为bitnami/ruby:latest）

步骤2：删除旧容器

docker rm -v ruby

（Docker Compose用户执行：docker-compose rm -v ruby）

步骤3：运行新镜像

docker run --name ruby bitnami/ruby:latest

（Docker Compose用户执行：docker-compose up ruby）

重要变更记录

2.3.1-r0（2016-05-11）

• 命令默认以root用户执行。可通过--user参数切换用户，或使用sudo提权（Docker 1.10+支持用户命名空间，详见官方文档）。

2.2.3-0-r02（2015-09-30）

• 不再默认导出/app目录为卷。如需保留旧行为（以便在其他容器中挂载），启动容器时添加-v /app参数。

2.2.3-0-r01（2015-08-26）

• 修复权限问题，bitnami用户可无需sudo安装gems。

使用docker-compose.yaml

注意：此文件未经内部测试，建议仅用于开发或测试环境。如发现问题，可按贡献指南提交反馈或修复。

贡献指南

欢迎为此容器贡献代码。可通过提交issue提出新功能需求，或通过提交PR贡献代码。

问题反馈

如运行容器时遇到问题，请提交issue。为获得更好支持，请按模板填写详细信息。

许可协议

Copyright © 2025 Broadcom。"Broadcom"指Broadcom Inc.及其子公司。

本软件基于Apache License 2.0许可协议发布。详情请参阅许可协议。

除非法律要求或书面同意，软件按"原样"分发，不提供任何明示或暗示的担保或条件。