Bitnami Legacy 镜像文档

1. 镜像概述和主要用途

Bitnami Legacy 镜像是 Bitnami Legacy 仓库中存储的容器镜像集合，包含所有历史 Bitnami 容器镜像的备份。该系列镜像已停止更新和技术支持，仅作为临时迁移工具使用，不提供长期可用性保障。其核心用途是帮助依赖旧版 Bitnami 镜像的用户完成临时过渡，以便将工作负载迁移至自有容器 registry 或替代方案。

2. 核心功能和特性

2.1 核心功能

• 镜像备份：完整保留历史 Bitnami 容器镜像的原始版本，确保旧版工作负载可临时运行。
• 临时迁移支持：作为过渡工具，允许用户从旧版镜像平滑迁移至新环境或替代镜像。

2.2 关键特性

• 无更新维护：不再接收安全更新、功能迭代或 bug 修复。
• 无*支持**：Bitnami ***不提供技术支持、故障排查或文档更新。
• 生命周期限制：Legacy 仓库未来可能被永久移除，镜像可用性无长期保障。

3. 使用场景和适用范围

3.1 适用场景

• 临时迁移：需将依赖旧版 Bitnami 镜像的工作负载迁移至自有容器 registry 或新镜像时使用。
• 历史环境复现：临时复现基于旧版 Bitnami 镜像的历史运行环境（如数据迁移、配置验证）。

3.2 不适用场景

• 生产环境：禁止用于生产工作负载，缺乏安全更新和支持可能导致风险。
• 长期运行：不可作为长期依赖，仓库移除后将无法拉取镜像。
• 关键业务系统：不适合对稳定性、安全性有严格要求的业务场景。

4. 使用方法和配置说明

4.1 镜像拉取与存储

由于 Legacy 仓库未来可能移除，使用前需优先将镜像拉取并存储至自有容器 registry（如 Docker Hub 私有仓库、Harbor、AWS ECR 等）。

4.1.1 拉取 Legacy 镜像

通过 docker pull 命令拉取目标镜像（具体镜像名称需参考 Legacy 仓库索引）：

bash
docker pull bitnami/[legacy-image-name]:[tag]
# 示例：拉取旧版 nginx 镜像
docker pull bitnami/nginx:1.21.6-debian-10-r100

4.1.2 存储至自有 registry

拉取后需立即标记并推送至私有 registry，确保长期可用性：

bash
# 标记镜像为私有 registry 地址
docker tag bitnami/[legacy-image-name]:[tag] [your-registry-domain]/[project]/[legacy-image-name]:[tag]

# 推送至私有 registry
docker push [your-registry-domain]/[project]/[legacy-image-name]:[tag]

4.2 临时运行示例

若需临时启动 Legacy 镜像（仅用于迁移验证），可参考以下命令（以 nginx 为例）：

bash
docker run -d --name legacy-nginx \
  -p 80:8080 \
  bitnami/nginx:1.21.6-debian-10-r100

注意：运行前需确保已拉取镜像，且仅用于短期测试或数据迁移，不可用于生产流量承载。

4.3 配置参数与环境变量

Legacy 镜像的配置参数（如端口、挂载路径）和环境变量与对应历史版本的 Bitnami 镜像完全一致，具体可参考该镜像发布时的***文档（需通过历史文档或镜像元数据查询）。

• 无新增配置：Legacy 镜像未添加任何新参数或环境变量，所有配置逻辑与原版本保持一致。
• 无配置支持：Bitnami ***不提供配置相关的技术支持，配置问题需自行排查。

5. 迁移建议

5.1 长期替代方案

对于生产工作负载或长期需求，建议迁移至 Bitnami Secure Images（***链接），其优势包括：

• 强化容器安全（最小化***面、漏洞修复）；
• 提供 CVE 透明度（通过 VEX/KEV 标准）；
• 包含软件物料清单（SBOMs）；
• 企业级技术支持和长期维护。

5.2 迁移步骤概要

1. 评估当前 Legacy 镜像的功能依赖，确认 Secure Images 对应版本的兼容性；
2. 测试 Secure Images 在非生产环境中的功能适配性；
3. 逐步替换生产环境中的 Legacy 镜像为 Secure Images；
4. 停止使用 Legacy 镜像并清理相关依赖。

6. 注意事项

• 可用性风险：Legacy 仓库未来可能被移除，务必提前将依赖镜像迁移至自有 registry。
• 安全风险：无更新的镜像可能存在未修复漏洞，禁止用于暴露公网或处理敏感数据的场景。
• 支持限制：Bitnami ***不受理 Legacy 镜像相关的 issue 或支持请求。