Instructure开源基础Docker镜像文档

镜像概述

Instructure开源基础Docker镜像是一套用于构建语言环境及对应Passenger Web服务器版本的基础镜像集合，采用模板化系统实现自动化生成与维护，旨在简化多版本镜像的开发与配置管理流程。

核心功能与特性

• 模板化生成：语言基础镜像及其Web服务器（Passenger）版本通过模板系统统一生成，确保配置一致性与可维护性。
• 多版本支持：支持管理多个语言版本，每个版本对应独立目录，通过配置文件定义版本参数。
• 配置自动合并：构建参数由manifest文件管理，默认配置（defaults）与版本配置（versions）自动合并，支持自定义版本信息与生成说明。

使用场景

适用于需要统一管理多语言版本、标准化Web服务器配置的Instructure相关Docker镜像开发或维护场景，尤其适合开发者或运维人员高效更新镜像配置。

使用方法与配置说明

更新镜像流程

1. 修改模板文件
   进入目标语言的template目录，编辑需更新的模板文件（如Dockerfile模板、配置脚本等）。

2. 运行rake命令同步更改
   执行rake命令将模板修改传播至所有版本目录：

   bash
   rake
   

   该命令会依据manifest配置，自动将模板更新应用到指定版本。

manifest文件配置

manifest文件位于项目根目录，定义构建参数，主要包含：

• defaults：全局默认配置，适用于所有版本。
• versions：版本列表，每个条目对应具体版本目录，包含version（版本号）、generation_message（生成说明）等自定义参数。
• 模板文件路径：指定需注入配置的模板文件（如Dockerfile.template）。

示例manifest结构（示意）：

json
{
  "defaults": {
    "package_manager": "apt-get"
  },
  "versions": [
    {
      "version": "3.10",
      "generation_message": "Updated dependencies"
    }
  ],
  "templates": ["Dockerfile.template"]
}

配置注入规则

versions中的版本配置会与defaults合并（版本配置优先覆盖默认配置），并自动将version和generation_message注入模板文件，供模板引用（如{{ version }}变量）。