madwire/ruby-passenger

Ruby Passenger Standalone Docker镜像文档

1. 镜像概述和主要用途

该Docker镜像基于Passenger Standalone构建，专为Ruby Web应用提供容器化运行环境。通过集成Passenger应用服务器，简化Ruby Web应用（如Rails、Sinatra）的部署流程，实现快速、可配置的容器化运行。

2. 核心功能和特性

• Ruby Web应用支持：兼容主流Ruby Web框架（如Rails、Sinatra），提供完整的运行时环境
• Passenger集成：内置Passenger Standalone作为应用服务器，负责请求处理、进程管理及资源调度
• 灵活配置：通过环境变量自定义服务端口、应用实例数量等关键参数，适配不同负载需求

3. 使用场景和适用范围

• 开发环境：快速部署Ruby Web应用进行本地测试，确保环境一致性
• 生产环境：容器化部署Ruby Web应用，简化运维流程，支持水平扩展
• 适用项目：中小型Ruby Web项目，需简单配置即可运行的场景

4. 使用方法和配置说明

4.1 环境变量配置

通过以下环境变量可调整镜像运行参数：

4.2 部署示例

4.2.1 使用docker run命令部署

将本地Ruby应用代码挂载至容器，配置环境变量启动服务：

bash
docker run -d \
  -p 8080:3000 \  # 主机端口8080映射到容器内PORT（示例为3000）
  -e PORT=3000 \   # 设置容器内服务端口
  -e MIN_INSTANCES=2 \  # 最小实例数2
  -e MAX_POOL_SIZE=4 \  # 最大实例池大小4
  -v $(pwd):/app \  # 挂载本地Ruby应用代码至容器内/app目录（需根据镜像工作目录调整）
  --name ruby-web-app \  # 容器名称
  [镜像名称]  # 替换为实际Docker镜像名称（如ruby-passenger-standalone）

4.2.2 使用docker-compose部署

创建docker-compose.yml配置文件，定义服务及环境：

yaml
version: '3'
services:
  ruby-web-app:
    image: [镜像名称]  # 替换为实际Docker镜像名称
    ports:
      - "8080:3000"  # 主机端口:容器内PORT
    environment:
      - PORT=3000
      - MIN_INSTANCES=2
      - MAX_POOL_SIZE=4
    volumes:
      - ./:/app  # 挂载本地应用代码至容器工作目录
    restart: always  # 可选：设置服务自动重启

启动服务：

bash
docker-compose up -d

4.3 注意事项

• 应用代码挂载：需确保本地Ruby应用代码（含Gemfile、Gemfile.lock等依赖文件）正确挂载至容器内Passenger预期的工作目录（通常为/app，具体以镜像实际配置为准）。
• 依赖安装：若应用有额外依赖，建议在构建应用镜像时预安装，或通过容器启动命令临时安装（如docker exec -it [容器ID] bundle install）。

5. 许可证信息

本镜像遵循MIT许可证：

MIT许可证（MIT）

版权所有（c）2020 Richard Adams

特此授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人免费许可，不受限制地处理本软件，包括但不限于使用、复制、修改、合并、出版、分发、再许可和/或销售软件副本的权利，并允许向其提供软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何明示或暗示的担保，包括但不限于对适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他方式。