nafeez/versioner

多版本Docker镜像文档

镜像概述和主要用途

本镜像为包含多个版本的Docker镜像，旨在通过统一的镜像包提供多个稳定版本，方便用户根据实际需求快速选择和切换版本，无需单独管理和维护多个独立镜像。主要用途包括开发、测试及生产环境中需要在不同版本间灵活切换的场景，简化版本管理流程，降低环境配置复杂度。

核心功能和特性

核心功能

• 多版本集成：内置多个稳定版本，覆盖主流需求版本范围
• 版本指定灵活：支持通过镜像标签或环境变量两种方式指定运行版本
• 统一管理接口：所有版本共用统一的启动命令和基础配置，降低使用门槛

特性

• 版本兼容性：各版本间保持核心接口一致性，切换版本时无需修改应用配置
• 轻量级设计：基于共享基础层构建，多版本共存时镜像整体体积增量小
• 版本可扩展：支持通过构建参数自定义添加或移除特定版本

使用场景和适用范围

使用场景

• 开发环境：开发过程中测试不同版本兼容性，验证功能在多版本下的表现
• 测试环境：并行测试多个版本的性能、稳定性及功能差异
• 生产环境：根据业务需求快速切换版本，应对紧急版本回滚或升级需求
• 教学/演示：展示同一应用在不同版本中的功能演进或差异对比

适用范围

• 需要多版本支持的应用开发团队
• 追求简化镜像管理的DevOps流程
• 需频繁进行版本切换的测试或运维场景
• 对版本兼容性有严格要求的企业级应用

使用方法和配置说明

镜像拉取

通过指定版本标签拉取特定版本：

bash
docker pull docker.xuanyuan.run/[镜像名称]:[版本标签]
# 示例：拉取v2.1版本
docker pull docker.xuanyuan.run/multi-version-image:v2.1

拉取默认版本（通常为最新稳定版）：

bash
docker pull docker.xuanyuan.run/[镜像名称]:latest

容器运行

基础运行命令（指定标签版本）

bash
docker run -d --name multi-version-container [镜像名称]:[版本标签]
# 示例：运行v1.5版本
docker run -d --name app-v1.5 docker.xuanyuan.run/multi-version-image:v1.5

通过环境变量指定版本（适用于latest标签）

bash
docker run -d --name multi-version-container \
  -e VERSION=[指定版本号] \
  [镜像名称]:latest
# 示例：使用latest镜像运行v3.0版本
docker run -d --name app-v3.0 \
  -e VERSION=v3.0 \
  docker.xuanyuan.run/multi-version-image:latest

环境变量说明

标签说明

镜像标签遵循[主版本].[次版本]格式，部分版本提供补丁版本标签，主要标签说明：

Docker Compose配置示例

yaml
version: '3'
services:
  multi-version-app:
    image: docker.xuanyuan.run/multi-version-image:latest  # 使用latest标签，通过环境变量指定版本
    environment:
      - VERSION=v2.0  # 指定运行v2.0版本
      - LOG_LEVEL=debug  # 设置日志级别为debug
    volumes:
      - ./data:/app/data  # 挂载数据卷
    ports:
      - "8080:8080"  # 端口映射

注意事项

1. 使用latest标签时必须通过VERSION环境变量指定具体版本，否则可能无法正常启动
2. 不同版本可能存在配置文件差异，建议通过数据卷挂载外部配置文件以确保兼容性
3. 升级版本前建议备份数据，部分跨版本升级可能需要数据迁移操作