instructure/ruby-passenger

Insturcture开源基础Docker镜像

镜像概述和主要用途

Insturcture开源基础Docker镜像是一套开源的基础镜像，主要提供Ruby环境及Passenger Web服务器支持，作为Instructure相关应用的基础镜像，用于简化应用的构建、部署与版本管理流程。

核心功能和特性

• 模板化生成：语言基础镜像及其Passenger Web服务器对应版本均通过模板系统生成，确保镜像构建的标准化和一致性。
• 版本化管理：支持多版本语言基础镜像维护，通过清单文件中的versions对象管理不同版本目录，实现版本隔离与并行维护。
• 便捷更新机制：通过修改模板文件并执行rake命令，可自动将更改传播至所有版本的构建目录，简化镜像更新流程。
• 参数化配置：构建参数由项目目录中的清单文件提供，versions对象与defaults对象合并，并自动注入version和generation_message键至模板文件，支持灵活配置。

使用场景和适用范围

使用场景

• 构建Instructure生态系统中基于Ruby和Passenger的应用Docker镜像。
• 维护多版本Ruby环境及Passenger Web服务器的标准化基础镜像。

适用范围

• Instructure应用开发者。
• 需要基于Ruby和Passenger构建Docker镜像的开发与运维人员。
• 追求镜像构建流程标准化、可维护性的技术团队。

详细使用方法和配置说明

更新镜像步骤

1. 修改模板文件
   定位至目标语言的template目录，修改其中的模板文件（如环境配置、依赖定义等）以实现所需变更。

2. 执行 rake 命令传播更改
   运行rake命令，将模板文件的修改自动同步至所有版本的构建目录：

   bash
   rake
   

3. 清单文件配置说明
   构建参数由项目目录中的清单文件（manifest file）定义，其核心结构如下：

   • defaults：默认配置参数，适用于所有版本（如基础镜像版本、通用环境变量等）。
   • versions：版本配置集合，每个对象对应一个语言版本的目录，包含特定版本的配置（会与defaults合并）。
   • 自动注入键：version（版本号）和generation_message（生成消息），供清单中指定的模板文件使用。

清单文件示例

json
{
  "defaults": {
    "base_image": "ruby:alpine",
    "passenger_version": "6.0.15"
  },
  "versions": {
    "2.7": {
      "ruby_version": "2.7.8",
      "generation_message": "Generated from template v1.2"
    },
    "3.0": {
      "ruby_version": "3.0.6",
      "generation_message": "Generated from template v1.2"
    }
  }
}

上述示例中，versions对象定义了Ruby 2.7和3.0两个版本的配置，每个版本继承defaults中的base_image和passenger_version，并补充特定的ruby_version和generation_message。