Bitnami Legacy 镜像文档

1. 镜像概述和主要用途

1.1 概述

Bitnami Legacy 镜像是 Bitnami Legacy 仓库中归档的历史容器镜像集合，该仓库已停止维护，不再提供任何形式的更新、安全补丁或技术支持。镜像仅作为历史版本备份存在，用于临时迁移场景。

1.2 主要用途

核心用途为临时迁移过渡：当用户需从旧版 Bitnami 镜像迁移至其他受支持镜像（如 Bitnami Secure Images）时，可临时使用 Legacy 镜像维持业务连续性，确保迁移过程平滑过渡。

2. 核心功能和特性

2.1 核心功能

• 历史版本保留：完整归档原 Bitnami 镜像的历史版本，确保与旧环境的兼容性。
• 兼容性继承：与原 Bitnami 镜像在运行逻辑、配置接口等方面完全一致，可直接替代原镜像运行。

2.2 关键特性

• 无更新维护：不提供后续功能迭代、漏洞修复或安全补丁。
• 无官方支持：Bitnami 不对镜像使用问题提供技术支持或故障响应。
• 临时可用性：Legacy 仓库未来可能被永久移除，镜像长期可用性无法保障。

3. 使用场景和适用范围

3.1 适用场景

仅限临时迁移场景：用于从旧版 Bitnami 镜像向新版镜像（如 Bitnami Secure Images）迁移过程中的过渡阶段，不可用于长期运行。

3.2 适用范围

• 禁止场景：严禁用于生产环境、关键业务系统或长期部署。
• 推荐替代：生产环境必须使用 Bitnami Secure Images，其提供强化安全特性（如最小攻击面、CVE 透明度）、持续更新及企业级支持。

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker 环境（版本需与目标镜像兼容，具体参考原 Bitnami 镜像文档）。
• 具备访问 Bitnami Legacy 仓库的网络权限（镜像路径通常为 docker.io/bitnami/<镜像名>:<旧版本标签>）。
• 拥有私有容器 registry（如 Docker Hub 私有仓库、Harbor 等），用于存储拉取的 Legacy 镜像（避免仓库移除后无法访问）。

4.2 镜像拉取与存储

4.2.1 拉取 Legacy 镜像

使用 docker pull 命令从 Legacy 仓库拉取目标镜像（以下以 nginx 为例，实际镜像名和标签需根据迁移需求替换）：

# 示例：拉取旧版 nginx 镜像（标签需替换为实际旧版本，如 1.21.6-debian-10-r100）
docker pull bitnami/nginx:1.21.6-debian-10-r100

4.2.2 存储至私有 Registry

为确保长期可用，需将拉取的镜像推送到私有容器 registry：

# 1. 标记镜像为私有 registry 路径
docker tag bitnami/nginx:1.21.6-debian-10-r100 your-private-registry.example.com/bitnami/nginx:legacy-backup

# 2. 推送至私有 registry
docker push your-private-registry.example.com/bitnami/nginx:legacy-backup

4.3 临时运行示例

仅在迁移过渡阶段运行 Legacy 镜像，示例（以 nginx 为例）：

docker run -d \
  --name legacy-nginx \
  -p 80:80 \
  -v $(pwd)/nginx.conf:/opt/bitnami/nginx/conf/nginx.conf \  # 如需挂载配置，沿用原镜像路径
  your-private-registry.example.com/bitnami/nginx:legacy-backup

4.4 配置参数与环境变量

Legacy 镜像的配置逻辑与原 Bitnami 镜像完全一致，具体参数（如端口、环境变量、挂载路径）需参考对应镜像的历史文档（可通过原 Bitnami 镜像文档或镜像内置 --help 命令获取）。
注意：不建议对 Legacy 镜像进行复杂配置修改，仅推荐最小化运行以完成迁移。

5. 注意事项

5.1 安全与风险提示

• 安全漏洞风险：镜像可能包含未修复的安全漏洞（CVE），运行时需严格隔离网络访问，避免暴露至公网。
• 无故障支持：使用过程中出现的功能异常、兼容性问题需用户自行排查，Bitnami 不提供技术支持。

5.2 长期可用性

Legacy 仓库未来可能被移除，必须在迁移完成后立即停止使用 Legacy 镜像，并彻底切换至 Bitnami Secure Images。

5.3 生产环境禁用

Legacy 镜像严禁用于生产环境。生产环境需采用 Bitnami Secure Images，其提供：

• 强化容器（最小化攻击面、非 root 用户运行）；
• CVE 透明度（通过 VEX/KEV 披露漏洞状态）；
• 软件物料清单（SBOM）；
• 企业级技术支持与持续更新。