Bitnami 遗留镜像 (Legacy Images) 技术文档

1. 镜像概述与主要用途

Bitnami 遗留镜像仓库（Legacy Repository）是 Bitnami 官方提供的历史容器镜像备份集合，该仓库已停止维护且不再接收任何更新或技术支持。其核心用途是作为临时迁移媒介，供依赖旧版 Bitnami 镜像的用户在过渡期间拉取和使用历史镜像版本，确保迁移过程中的连续性。

2. 核心功能与特性

• 历史镜像备份：包含 Bitnami 过往发布的所有容器镜像完整备份，保留历史版本快照
• 停止更新维护：不再提供功能迭代、安全补丁或漏洞修复
• 无官方技术支持：Bitnami 官方不对该仓库镜像提供问题排查、故障处理等支持服务
• 临时可用性：仅作为过渡阶段的临时资源，不具备长期存储保障

3. 使用场景与适用范围

3.1 适用场景

• 依赖旧版 Bitnami 镜像的系统进行临时迁移或版本过渡
• 需要短期保留历史镜像以完成环境迁移、配置适配的场景

3.2 不适用场景

• 生产环境部署：缺乏持续安全更新，存在未修复漏洞风险
• 长期业务依赖：无官方维护，无法保障稳定性和兼容性
• 合规性要求场景：不满足安全合规、漏洞修复的持续性需求

4. 使用方法与配置说明

4.1 拉取镜像

通过 docker pull 命令从遗留仓库拉取目标镜像，格式如下：

docker pull bitnami/[镜像名称]:[标签]
# 示例：拉取旧版 nginx 镜像
docker pull bitnami/nginx:1.21.6-debian-10-r100

4.2 存储至私有仓库

由于遗留仓库未来可能被移除，必须将拉取的镜像存储到用户自有容器注册表（如 Docker Hub 私有仓库、AWS ECR、Harbor 等），确保长期可用性：

# 1. 为镜像标记私有仓库地址
docker tag bitnami/[镜像名称]:[标签] [私有仓库地址]/[项目路径]/[镜像名称]:[标签]

# 2. 推送到私有仓库
docker push [私有仓库地址]/[项目路径]/[镜像名称]:[标签]

# 示例：推送到私有仓库
docker tag bitnami/nginx:1.21.6-debian-10-r100 my-registry.example.com/legacy-images/nginx:1.21.6-debian-10-r100
docker push my-registry.example.com/legacy-images/nginx:1.21.6-debian-10-r100

4.3 关键注意事项

• 仓库移除风险：Bitnami 可能在未来终止该遗留仓库服务，建议尽快完成迁移
• 本地备份优先：拉取后立即存储至自有仓库或本地镜像仓库，避免仓库下线导致镜像不可用
• 安全风险自担：使用前需自行评估镜像漏洞风险，建议通过第三方工具（如 Trivy、Clair）进行扫描

5. 迁移建议

对于生产环境及长期部署需求，强烈建议迁移至 Bitnami Secure Images。该系列镜像具备以下核心优势：

• 强化安全：最小化攻击面、定期安全加固及漏洞扫描
• CVE 透明度：提供 VEX/KEV 报告，明确漏洞状态及修复进度
• 供应链可追溯：包含软件物料清单（SBOM），确保组件来源可追溯
• 企业级支持：提供官方技术支持及长期维护服务