Instructure开源基础Docker镜像文档

镜像概述

Instructure开源基础Docker镜像是一套用于构建语言基础环境及对应Passenger Web服务器的镜像集合。该镜像通过模板系统实现配置统一管理，支持多版本镜像的批量生成与更新，适用于需要标准化语言运行环境的开发与运维场景。

核心功能与特性

• 模板驱动生成：采用模板系统统一管理镜像配置，通过模板文件定义基础环境参数，实现多版本镜像的一致性构建。
• 多版本支持：通过versions配置对象管理不同语言版本，每个版本对应独立的构建目录，支持多版本镜像并行维护。
• 配置自动合并：versions对象中的版本配置与默认配置（defaults对象）自动合并，支持版本个性化配置的同时保留全局默认设置。
• 便捷更新机制：修改模板目录文件后，运行rake命令即可将更改自动传播到所有版本构建目录，简化更新流程。
• 动态参数注入：自动为模板文件注入version（版本标识）和generation_message（生成信息）等动态参数，支持模板内容动态调整。

使用场景与适用范围

适用于需要构建、维护多版本语言基础镜像（如Ruby、Python等）及其Passenger Web服务器环境的场景，尤其适合对环境一致性、配置可追溯性有较高要求的团队或项目，可作为应用部署的基础镜像使用。

使用方法与配置说明

更新镜像流程

1. 修改模板文件
   在对应语言的template目录中编辑模板文件，定义基础环境配置、依赖项或启动脚本等内容。模板文件将作为生成各版本镜像的基础模板。

2. 运行rake命令传播更改
   执行rake命令，模板系统会自动将template目录的修改同步到所有版本的构建目录中，确保各版本镜像配置与模板保持一致。

构建参数配置

镜像构建参数由项目目录下的manifest文件统一管理，主要包含以下配置项：

• defaults对象
  定义所有版本共享的默认配置参数，如基础镜像版本、通用环境变量等。

• versions对象
  每个键值对对应一个语言版本，键为版本标识（如2.7、3.1），值为该版本的个性化配置。该配置会与defaults对象合并，优先级高于默认配置，用于覆盖或补充特定版本的参数。

• 动态注入参数
  合并后的配置会自动包含以下动态参数，传递给模板文件用于生成版本化内容：

  • version：当前版本标识（如2.7）
  • generation_message：镜像生成时的描述信息（如构建时间、模板版本）

配置合并逻辑

versions对象中的版本配置与defaults对象按以下规则合并：

1. 对于基础数据类型（字符串、数字等），版本配置覆盖默认配置；
2. 对于对象类型，递归合并子属性，版本配置的子属性覆盖默认配置的对应子属性；
3. 合并结果包含version和generation_message动态键，供模板文件引用。

示例配置（manifest文件片段）

{
  "defaults": {
    "base_image": "debian:bullseye",
    "install_packages": ["curl", "git"]
  },
  "versions": {
    "2.7": {
      "install_packages": ["curl", "git", "ruby2.7-dev"],
      "ruby_version": "2.7.8"
    },
    "3.1": {
      "base_image": "debian:bookworm",
      "ruby_version": "3.1.4"
    }
  }
}

上述示例中，versions对象定义了Ruby 2.7和3.1两个版本，分别覆盖了默认的install_packages和base_image配置，并添加了ruby_version参数，这些配置将与defaults合并后传递给模板文件。