Bitnami Legacy 镜像技术文档

1. 镜像概述和主要用途

1.1 镜像概述

Bitnami Legacy 镜像是 Bitnami Legacy 仓库中存储的历史容器镜像备份集合。该仓库已停止维护，所有镜像不再接收更新或技术支持，且未来可能被永久移除。

1.2 主要用途

仅用于临时迁移场景，即依赖旧版 Bitnami 镜像的用户需将工作负载从该 Legacy 仓库迁移至自有容器 registry 或更新至 Bitnami Secure Images 时，可临时使用这些备份镜像。

2. 核心功能和特性

2.1 核心功能

• 包含 Bitnami 历史容器镜像的完整备份，覆盖旧版 Bitnami 镜像的历史版本。

2.2 特性

• 无更新支持：镜像不再接收安全更新、功能优化或 bug 修复。
• 临时可用性：Legacy 仓库未来可能被移除，镜像长期可用性无法保障。
• 迁移过渡：仅作为旧版 Bitnami 镜像的临时过渡载体，不具备生产环境可靠性。

3. 使用场景和适用范围

3.1 使用场景

• 临时迁移：需将依赖旧版 Bitnami 镜像的工作负载迁移至自有容器 registry 或升级至 Bitnami Secure Images 的过渡阶段。

3.2 适用范围

• 仅限非生产环境：严禁用于生产工作负载，生产环境必须使用 Bitnami Secure Images。
• 迁移过渡期用户：仅适用于需要临时保留或迁移旧版 Bitnami 镜像的用户。

4. 使用方法和配置说明

4.1 拉取 Legacy 镜像

通过 docker pull 命令从 Legacy 仓库拉取所需镜像，命令格式如下：

docker pull bitnami/[镜像名称]:[标签]

示例：拉取旧版 Nginx 镜像

docker pull bitnami/nginx:1.21.6-debian-10-r100

4.2 存储至自有容器 registry

为确保长期可用性，需将拉取的 Legacy 镜像存储至用户自有容器 registry（如私有 Docker Registry、AWS ECR、Google GCR 等），步骤如下：

1. 为镜像添加私有 registry 标签：

   docker tag bitnami/[镜像名称]:[标签] [私有registry地址]/[项目路径]/[镜像名称]:[标签]
   

   示例：

   docker tag bitnami/nginx:1.21.6-debian-10-r100 my-private-registry.example.com/legacy-images/nginx:1.21.6-debian-10-r100
   

2. 推送至私有 registry：

   docker push [私有registry地址]/[项目路径]/[镜像名称]:[标签]
   

   示例：

   docker push my-private-registry.example.com/legacy-images/nginx:1.21.6-debian-10-r100
   

4.3 注意事项

• 无技术支持：使用过程中出现的问题（如兼容性、安全漏洞）Bitnami 不提供支持。
• 配置沿用：Legacy 镜像的配置方式与原 Bitnami 镜像一致，具体可参考对应镜像的历史文档（需用户自行保留或查找）。
• 迁移后替换：完成迁移后，应尽快将工作负载更新至 Bitnami Secure Images，避免长期依赖 Legacy 镜像。

5. 生产环境建议

对于生产工作负载，严禁使用 Legacy 镜像，应采用 Bitnami Secure Images，其具备以下优势：

• 容器安全加固，降低攻击面；
• 提供 CVE 透明度（通过 VEX/KEV）；
• 包含软件物料清单（SBOMs）；
• 企业级技术支持。
  详情可参考 Bitnami Secure Images 官方文档。