Instructure开源基础Docker镜像文档

镜像概述和主要用途

本镜像为Instructure开源的基础Docker镜像，主要用于生成语言基础镜像及其对应的Passenger Web服务器镜像。通过模板化系统实现多版本镜像的统一管理、配置与更新，确保镜像构建过程的标准化和高效性。

核心功能和特性

• 模板化生成：基于模板目录生成各类语言基础镜像及Passenger Web服务器对应版本，支持多语言版本管理
• 版本化管理：通过manifest文件中的versions对象定义各语言版本，每个对象对应一个版本目录
• 配置合并机制：manifest文件中的defaults对象与version、generation_message键合并，为模板文件提供完整参数
• 便捷更新流程：修改模板目录文件后，运行rake命令即可自动将更改传播至各版本构建目录

使用场景和适用范围

• 需统一管理多版本语言基础镜像的开发环境
• 持续集成/部署（CI/CD）流程中的标准化镜像构建
• Instructure内部或其他需要高效管理多版本基础镜像的团队

详细使用方法和配置说明

修改模板文件

1. 定位至对应语言的template目录
2. 根据需求修改模板文件（如Dockerfile模板、配置文件等）

传播更改至版本目录

运行rake命令自动将模板更改应用到所有版本构建目录：

bash
rake

manifest文件配置

manifest文件位于项目目录，用于定义镜像构建参数，结构如下：

json
{
  "defaults": {
    "key1": "default_value1",
    "key2": "default_value2"
  },
  "versions": {
    "version_1": {
      "param1": "value1"
    },
    "version_2": {
      "param1": "value2"
    }
  }
}

参数说明

• defaults：提供默认配置参数，所有版本共享
• versions：包含多个版本对象，每个对象对应一个版本目录，定义该版本特有参数
• version：自动注入的版本号（从versions对象键名获取）
• generation_message：自动注入的生成信息，用于标识镜像构建来源

版本目录对应关系

versions对象中的每个键对应一个版本目录，例如versions中的"2.7"会生成./ruby/2.7目录，包含该版本的完整构建文件。

参数合并规则

模板文件可使用以下合并后的参数：

• defaults提供的默认配置
• version：当前版本号
• generation_message：镜像生成相关信息 各版本特有参数会覆盖defaults中的同名参数。