Docker 镜像文档：已弃用 Ruby 环境镜像

一、镜像概述和主要用途

1.1 基本信息

该镜像基于 datadog/base:trusty 构建，通过 Dockerfile 定义了 Ruby 2.1 环境及相关工具的安装配置。重要提示：此镜像已被弃用（deprecated），其代码仓库不再维护，存在安全风险和功能过时问题，不建议在生产或开发环境中使用。

1.2 构建基础

镜像构建基于 Ubuntu Trusty（14.04）系统，主要通过以下步骤构建：

• 添加 Brightbox Ruby PPA 源
• 安装 Ruby 2.1 及开发依赖
• 配置 Ruby 和 Gem 的默认版本
• 安装 Foreman 和 Bundler 工具

二、核心功能和特性

2.1 预装组件

根据 Dockerfile 定义，镜像构建时包含以下组件：

• Ruby 环境：Ruby 2.1 及 Ruby 2.1 开发库（ruby2.1、ruby2.1-dev）
• 工具链：foreman（进程管理工具）和 bundler（Ruby 依赖管理工具）
• 系统配置：通过 update-alternatives 设置 ruby 和 gem 命令默认指向 Ruby 2.1 版本

2.2 局限性说明

由于镜像已被弃用，存在以下关键限制：

• 基础镜像 datadog/base:trusty 基于 Ubuntu 14.04，该系统已停止官方支持（EOL），存在未修复的安全漏洞
• Ruby 2.1 已不再维护（官方支持终止于 2017 年），无法获取安全更新
• 预装工具（Foreman、Bundler）版本可能过时，与现代依赖不兼容

三、使用场景和适用范围

3.1 不建议使用场景

• 新开发项目：严禁在新系统或项目中使用此镜像
• 生产环境：存在严重安全和兼容性风险，可能导致服务中断或数据安全问题
• 依赖更新：无法适配现代 Ruby Gems 或系统库，可能引发依赖冲突

3.2 现有用户注意事项

若当前项目仍在使用此镜像，建议立即迁移至以下替代方案：

• 官方 Ruby 镜像（如 ruby:3.2-slim 等受支持版本）
• 基于 Ubuntu 20.04+/Debian 11+ 的自定义 Ruby 环境镜像
• 容器化管理工具（如 Kubernetes）中的官方 Ruby 镜像部署

四、使用方法和配置说明

4.1 运行方式（不推荐）

尽管已弃用，若需临时测试（仅用于迁移评估），可通过以下命令运行容器：

docker run --rm [镜像名称或ID] ruby -v  # 查看 Ruby 版本（示例）

警告：此命令仅用于验证迁移前的环境信息，切勿用于业务负载。

4.2 配置说明

该镜像无特定环境变量或配置参数，所有功能均通过 Dockerfile 构建时固化。如需自定义配置（如 Ruby 版本、工具版本），需基于其他基础镜像重新构建。

五、迁移建议

5.1 替代方案推荐

5.2 迁移步骤概要

1. 评估现有项目依赖，确认与目标 Ruby 版本兼容性（如通过 bundle update 测试）

2. 基于推荐镜像（如 ruby:3.2-slim）编写新 Dockerfile，安装必要系统库

3. 迁移 Foreman 配置至容器编排工具（如 Docker Compose 的 command 或 entrypoint）

4. 测试新环境功能及性能，验证无误后逐步替换旧镜像部署

再次强调：此镜像已被弃用，继续使用可能导致不可预知的安全风险和功能故障，建议尽快完成迁移。