netdata/legacy

旧平台兼容性支持镜像

一、镜像概述和主要用途

本镜像专为需要持续支持历史版本发布的旧平台环境设计，提供稳定的运行时基础，用于部署、运行或维护依赖旧系统环境的应用程序。其核心目标是解决旧平台兼容性问题，确保历史版本软件在现代容器化环境中仍可正常工作。

二、核心功能与特性

2.1 兼容性保障

• 内置对主流旧操作系统版本（如CentOS 6/7、Ubuntu 14.04/16.04等）的运行时环境模拟
• 预安装旧版核心依赖库（如glibc 2.12+、OpenSSL 1.0.x等），减少应用迁移适配成本
• 支持x86 32位/64位等传统架构，兼容 legacy 硬件平台

2.2 版本稳定性

• 基于长期支持（LTS）版本构建，镜像生命周期与对应旧平台官方维护周期同步
• 固定基础组件版本，避免依赖库自动更新导致的兼容性问题
• 提供多版本标签（如v1.0-centos6、v2.1-ubuntu14），支持精准版本控制

2.3 轻量级设计

• 采用精简基础镜像，去除非必要组件，镜像体积较原生旧系统减少40%以上
• 支持多阶段构建，可按需裁剪运行时依赖，降低资源占用

三、使用场景与适用范围

3.1 旧应用维护场景

• 需长期维护的历史版本业务系统（如基于Java 6/7、Python 2.7开发的遗留应用）
• 依赖旧版系统库（如libpng 1.2、OpenSSL 0.9.8）的软件

3.2 兼容性测试场景

• 验证新版软件在旧平台环境下的运行表现
• 模拟旧生产环境进行回归测试

3.3 旧平台过渡场景

• 作为旧物理机/虚拟机向容器化迁移的过渡方案
• 为旧系统升级改造提供临时运行环境支持

四、使用方法与配置说明

4.1 获取镜像

通过Docker Hub或私有仓库拉取镜像（假设镜像标签格式为<镜像仓库>/old-platform-support:<平台版本>-<镜像版本>）：

bash
docker pull example/old-platform-support:centos6-v1.2.0

4.2 基本运行命令

4.2.1 交互式运行（调试/测试）

bash
docker run -it --rm \
  --platform linux/amd64 \  # 若需指定旧平台架构
  example/old-platform-support:centos6-v1.2.0 \
  /bin/bash

4.2.2 后台运行应用

bash
docker run -d \
  --name legacy-app \
  -p 8080:8080 \  # 映射应用端口
  -v /host/app/config:/app/config \  # 挂载配置文件
  -e APP_ENV=production \  # 设置环境变量
  example/old-platform-support:centos6-v1.2.0 \
  /app/start.sh  # 应用启动命令

4.3 环境变量配置

4.4 卷挂载说明

4.5 Docker Compose 配置示例

yaml
version: '3'
services:
  legacy-service:
    image: example/old-platform-support:ubuntu14-v2.0.1
    container_name: legacy-service
    restart: always
    ports:
      - "9000:9000"
    environment:
      - PLATFORM_VERSION=ubuntu14
      - ENABLE_DEBUG=false
      - MAX_OPEN_FILES=2048
    volumes:
      - ./app/config:/app/config:ro
      - ./app/logs:/app/logs:rw
    command: ["/app/legacy-app", "--config", "/app/config/app.ini"]

五、注意事项

1. 安全更新：旧平台环境可能存在未修复的安全漏洞，建议仅在隔离网络或非生产环境中使用；生产环境需结合安全扫描工具定期检查漏洞。
2. 性能影响：部分旧平台模拟可能引入轻微性能损耗，建议在高负载场景下进行压力测试。
3. 版本管理：镜像标签中的平台版本（如centos6）需与应用实际依赖的环境严格匹配，避免版本不一致导致运行异常。
4. 资源限制：运行时建议通过--memory、--cpus参数限制容器资源，防止旧应用异常占用过多主机资源。