Bitnami Rust 镜像文档

1. 镜像概述与主要用途

1.1 什么是 Rust？

Rust 是一种现代系统编程语言，专注于安全性、速度和并发性。它旨在提供内存安全的同时，保持高性能，适用于从底层系统开发到高性能应用程序的多种场景。

1.2 镜像用途

Bitnami Rust 镜像是预配置的 Docker 镜像，用于快速部署 Rust 开发环境和运行时。该镜像基于 Bitnami 安全强化标准构建，提供开箱即用的 Rust 工具链（包括 cargo、rustc 等），适用于开发、测试及轻量级生产环境。

2. 核心功能与特性

2.1 Bitnami Secure Images 优势

• 安全强化：基于最小化操作系统（Photon Linux）构建，减少***面，符合供应链安全最佳实践。
• 漏洞透明：通过 VEX/KEV 标准提供 CVE 风险透明度，包含 SBOM（软件物料清单）和病毒扫描报告。
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全性和合规性。
• 一致性：与 Bitnami 虚拟机、云镜像使用相同的组件和配置逻辑，支持多环境无缝切换。
• SLSA-3 合规：通过 Notation 提供签名验证，构建流程符合 SLSA-3 安全标准。

2.2 非 root 容器

采用非 root 用户运行，增加额外安全层，降低特权操作风险，符合生产环境最佳实践。

3. 使用场景与适用范围

• 开发环境：快速搭建本地 Rust 开发环境，避免系统级依赖冲突。
• CI/CD 流程：作为 CI 流水线中的构建或测试环境，确保环境一致性。
• 轻量级生产：运行 Rust 编译的二进制应用（需注意：社区版仅提供 latest 标签，建议生产环境使用 Bitnami Secure Images 企业版）。
• 学*与演示**：快速启动 Rust 环境，用于教程、示例代码运行等场景。

4. 获取镜像

4.1 拉取预构建镜像

推荐从 Docker Hub 拉取***预构建镜像：

console
# 拉取最新版
docker pull bitnami/rust:latest

# 拉取特定版本（注意：2025年8月28日后，非latest标签将迁移至bitnamilegacy仓库）
docker pull bitnami/rust:[TAG]  # 例如：bitnami/rust:1.75.0

4.2 手动构建镜像

若需自定义构建，可克隆 Bitnami 容器仓库并构建：

console
git clone [***]
cd containers/bitnami/rust/[VERSION]/[OS]  # 替换为具体版本和操作系统
docker build -t bitnami/rust:latest .

5. 使用方法

5.1 快速启动

console
# 启动交互式 shell
docker run -it --rm --name rust bitnami/rust:latest sh

# 运行 Rust 命令（如查看版本）
docker run --rm bitnami/rust:latest rustc --version
docker run --rm bitnami/rust:latest cargo --version

5.2 挂载本地项目

开发时可挂载本地代码目录至容器，实现实时编译：

console
# 挂载当前目录到容器的 /app 目录，运行 cargo build
docker run --rm -v $(pwd):/app -w /app bitnami/rust:latest cargo build

5.3 Docker Compose 示例

创建 docker-compose.yml 配置文件，用于本地开发：

yaml
version: '3'
services:
  rust:
    image: bitnami/rust:latest
    volumes:
      - ./my-rust-project:/app  # 挂载本地项目目录
    working_dir: /app
    tty: true  # 保持容器运行，支持交互式操作

启动服务：

console
docker-compose up -d
# 进入容器
docker-compose exec rust sh

6. 配置说明

6.1 运行自定义命令

通过 docker run 直接执行 Rust 工具链命令：

console
# 初始化新项目
docker run --rm -v $(pwd):/app -w /app bitnami/rust:latest cargo new my-project

# 运行测试
docker run --rm -v $(pwd):/app -w /app bitnami/rust:latest cargo test

6.2 FIPS 模式配置（仅 Bitnami Secure Images）

企业版镜像支持 FIPS（联邦信息处理标准）模式，通过环境变量控制：

• OPENSSL_FIPS：启用/禁用 OpenSSL FIPS 模式
  取值：yes（默认，启用）、no（禁用）

示例：

console
docker run --rm -e OPENSSL_FIPS=no bitnami/rust:latest rustc --version

7. 重要通知：Bitnami 目录变更（2025年8月28日起）

7.1 变更概要

• 仓库迁移：所有现有镜像（含历史版本标签，如 1.75.0）将迁移至 docker.io/bitnamilegacy 仓库，不再接收更新。
• 标签调整：社区版仅保留 latest 标签，且基于安全强化镜像，用于开发目的。
• 非强化镜像 deprecation：Debian 基础的非强化镜像将逐步从免费 tier 中移除。

7.2 生产环境建议

生产环境需使用 Bitnami Secure Images 企业版，包含长期支持、全版本标签及专属技术支持。详情参见 Bitnami Secure Images 公告。

8. 贡献与支持

8.1 贡献方式

通过 GitHub 仓库提交 issue 或 PR：

• 提交 issue
• 提交 PR

8.2 问题反馈

如遇容器运行问题，请通过 GitHub Issues 提交，需包含环境信息、复现步骤及日志。

9. 许可证

Copyright © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。
本软件基于 Apache License 2.0 许可协议发布。详情参见 Apache License 2.0。