instructure/python

Instructure 基础 Docker 镜像

镜像概述和主要用途

Instructure 基础 Docker 镜像是开源的基础镜像，主要用于构建标准化的 Python 应用运行环境。该镜像通过模板系统生成，包含语言基础镜像及其对应的 Web 服务器（passenger）版本，便于统一管理和维护不同版本的基础环境。

核心功能和特性

• 模板化生成：所有语言基础镜像及 Web 服务器对应版本均通过模板系统生成，确保环境一致性
• 版本化管理：支持多版本构建目录，每个版本对应 manifest 文件中 versions 对象的配置
• 便捷更新机制：通过修改模板文件并运行 rake 命令，可快速将变更 propagate 到各版本构建目录
• 配置合并：构建参数由 manifest 文件提供，versions 对象与 defaults 对象合并，并自动注入 version 和 generation_message 键到模板文件

使用场景和适用范围

适用于需要构建、维护和更新 Instructure 相关 Python 应用基础环境的开发和运维场景，尤其适合需要管理多版本基础镜像的团队，确保不同版本环境的一致性和可维护性。

使用方法和配置说明

更新镜像步骤

1. 修改模板文件
   进入相应语言的 template 目录，修改需要更新的模板文件。

2. 运行 rake 命令
   执行 rake 命令，将模板文件的变更 propagate 到各版本的构建目录：

   bash
   rake
   

3. manifest 文件配置
   项目目录中的 manifest 文件提供构建各模板目录的参数，结构说明：

   • versions 对象：每个子对象对应相应语言的版本目录，定义特定版本的配置
   • defaults 对象：提供默认配置，与 versions 对象合并
   • 自动注入键：模板文件可使用 version（版本号）和 generation_message（生成信息）键

配置参数说明

manifest 文件中可配置的核心参数：

• versions：版本列表，每个版本包含特定构建参数
• defaults：默认构建参数，将与各版本配置合并
• 模板文件中可引用 version 和 generation_message 变量获取版本信息和生成说明

示例

假设需更新 Python 3.9 版本的基础镜像：

1. 修改 python/template 目录下的模板文件
2. 确保 manifest 文件中 versions 对象包含 3.9 版本配置
3. 运行 rake 命令，自动更新 python/3.9 构建目录
4. 构建更新后的镜像：

   bash
   docker build -t instructure/python:3.9 python/3.9