Modulor Base Docker镜像文档

1. 镜像概述

Modulor Base是一个基于Ruby 2.3的基础Docker镜像，专为Modulor应用设计。该镜像预安装了一系列开发和运行时所需的依赖库，旨在提供统一、开箱即用的基础环境，简化Modulor应用的部署流程并减少依赖配置工作量。

2. 核心功能与特性

2.1 基础环境

• Ruby版本：Ruby 2.3运行时环境，满足基于该版本开发的Modulor应用需求。

2.2 预安装依赖库

3. 使用场景与适用范围

3.1 适用场景

• Modulor应用开发：作为本地开发环境，统一团队依赖配置，避免"在我机器上能运行"问题。
• 测试环境部署：提供与生产环境一致的基础依赖，确保测试结果准确性。
• 生产环境基础镜像：作为Modulor应用生产部署的基础层，减少镜像构建时间与体积。

3.2 适用范围

• 基于Ruby 2.3开发的Modulor应用。
• 需要集成字体处理、图像处理、Web服务、Node.js脚本等功能的Ruby应用。

4. 使用方法与配置说明

4.1 镜像拉取

通过Docker Hub拉取镜像：

docker pull tomasce/modulor-base

4.2 基本运行示例

启动一个交互式容器，验证Ruby版本及依赖：

docker run -it --rm tomasce/modulor-base /bin/bash

# 容器内验证Ruby版本
ruby -v  # 输出应为 Ruby 2.3.x

# 验证依赖库（以nginx为例）
nginx -v  # 输出nginx版本信息

4.3 Web应用部署示例

若基于该镜像部署需nginx提供Web服务的Modulor应用，可通过端口映射暴露服务：

# 假设应用代码挂载至容器/app目录，nginx配置文件挂载至/etc/nginx/conf.d/
docker run -d \
  --name modulor-app \
  -p 80:80 \
  -v /local/app/code:/app \
  -v /local/nginx/conf:/etc/nginx/conf.d \
  tomasce/modulor-base \
  /bin/bash -c "cd /app && bundle install && nginx -g 'daemon off;'"

4.4 Docker Compose配置示例

适用于多服务协同场景（如Modulor应用+数据库）：

version: '3'
services:
  modulor-app:
    image: tomasce/modulor-base
    container_name: modulor-app
    ports:
      - "80:80"
    volumes:
      - ./app:/app           # 挂载本地应用代码
      - ./nginx/conf.d:/etc/nginx/conf.d  # 自定义nginx配置
    command: /bin/bash -c "cd /app && bundle install && nginx -g 'daemon off;'"
    depends_on:
      - db
  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: password
      MYSQL_DATABASE: modulor_db

4.5 自定义配置说明

• 依赖扩展：如需添加额外依赖，可基于此镜像构建新镜像（通过Dockerfile FROM tomasce/modulor-base 扩展）。
• 服务配置：通过挂载卷（如-v ./nginx.conf:/etc/nginx/nginx.conf）覆盖默认服务配置（如nginx、Ruby环境变量等）。
• 端口映射：默认未暴露端口，需根据应用需求通过-p参数映射（如80端口对应nginx服务）。

5. 镜像信息

• 镜像名称：tomasce/modulor-base
• 基础镜像：Ruby 2.3***镜像（具体版本以Docker Hub标签为准）
• 版本标签：可通过Docker Hub查看最新版本（[***]