Bitnami .NET SDK 镜像文档

镜像概述和主要用途

.NET SDK 是 ASP.NET Core 框架的软件开发工具包，提供了构建、测试和运行 ASP.NET Core 应用程序所需的工具和库。Bitnami .NET SDK 镜像封装了 .NET SDK，旨在为开发人员提供便捷、安全的开发环境，简化 ASP.NET Core 应用的开发与构建流程。

商标说明：本软件列表由 Bitnami 打包。所提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

核心功能和特性

Bitnami .NET SDK 镜像（属于 Bitnami 安全镜像系列）具备以下核心功能和特性：

• 安全加固：遵循软件供应链完整性最佳实践，提供经过安全加固的容器环境，减少***面。
• 最小化操作系统：基于 Photon Linux 构建，采用最小化操作系统设计，在保持可扩展性的同时降低安全风险。
• 漏洞透明度：通过 VEX（漏洞可利用性交换）、KEV（已知被利用漏洞）和 EPSS 评分，提供 CVE 风险透明度，加速漏洞响应。
• 持续更新：上游补丁发布后数小时内更新镜像，确保安全合规。
• 跨格式一致性：Bitnami 容器、虚拟机和云镜像使用相同的组件和配置方式，便于根据项目需求切换部署格式。
• 供应链安全：提供符合 SLSA-3 标准的软件工厂生成的证明签名（Notation）、SBOM（软件物料清单）、病毒扫描报告等元数据。

使用场景和适用范围

• ASP.NET Core 应用开发：适用于开发人员在本地或开发环境中构建、测试 ASP.NET Core 应用程序。
• CI/CD 构建流程：可集成到持续集成/持续部署（CI/CD） pipeline 中，作为应用构建阶段的环境。
• 开发环境标准化：为团队提供统一的 .NET SDK 运行环境，避免因版本差异导致的开发问题。
• 学*与原型开发**：适合 ASP.NET Core 初学者快速搭建开发环境，进行技术验证或原型开发。

重要注意事项：Bitnami 镜像仓库即将变更

自 2025 年 8 月 28 日起，Bitnami 将调整其公共镜像仓库，推出名为“Bitnami Secure Images”的安全镜像计划，具体变更如下：

• 首次向社区用户开放热门容器镜像的安全优化版本。
• Bitnami 将逐步弃用免费层中非加固的 Debian 基础镜像，并从公共仓库中移除非最新标签。社区用户将只能访问数量减少的加固镜像，这些镜像仅以“latest”标签发布，仅供开发使用。
• 自 8 月 28 日起，两周内所有现有容器镜像（包括旧版本标签，如 2.50.0、10.6）将从公共仓库（docker.io/bitnami）迁移至“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议采用 Bitnami Secure Images，其包含加固容器、更小***面、CVE 透明度（通过 VEX/KEV）、SBOM 和企业支持。

这些变更旨在通过推广软件供应链完整性最佳实践和最新部署，提升所有 Bitnami 用户的安全态势。更多详情请访问 Bitnami Secure Images 公告。

使用方法

快速启动

通过以下命令快速启动 .NET SDK 容器：

console
docker run --name dotnet-sdk bitnami/dotnet-sdk:latest

获取镜像

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

console
docker pull bitnami/dotnet-sdk:latest

如需使用特定版本，可指定标签（查看 Docker Hub 标签列表 获取可用版本）：

console
docker pull bitnami/dotnet-sdk:[TAG]

也可手动构建镜像：

console
git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM  # 替换 APP、VERSION 和 OPERATING-SYSTEM 为实际值
docker build -t bitnami/APP:latest .

持久化应用数据

默认情况下，容器内数据在容器删除后会丢失。为持久化数据，需挂载 /bitnami 目录：

console
docker run \
    -v /path/to/dotnet-persistence:/bitnami \
    bitnami/dotnet-sdk:latest

若使用 docker-compose.yml，可添加 volumes 配置：

yaml
dotnet-sdk:
  ...
  volumes:
    - /path/to/dotnet-persistence:/bitnami
  ...

网络配置

通过 Docker 网络实现容器间通信，同一网络中的容器可通过容器名作为主机名相互访问。

步骤 1：创建网络

console
docker network create dotnet-network --driver bridge

步骤 2：启动 .NET SDK 容器并加入网络

console
docker run --name dotnet-node1 --network dotnet-network bitnami/dotnet-sdk:latest

步骤 3：启动其他容器

使用相同 --network 参数启动其他容器，指定容器名后即可通过该名称作为主机名访问：

console
docker run --name other-container --network dotnet-network [其他镜像]

日志查看

容器日志输出至 stdout，可通过以下命令查看：

console
docker logs dotnet-sdk

可通过 --log-driver 选项配置日志驱动（默认使用 json-file 驱动）：

console
docker run --log-driver [驱动名称] --name dotnet-sdk bitnami/dotnet-sdk:latest

维护与升级

步骤 1：拉取更新镜像

console
docker pull bitnami/dotnet-sdk:latest

步骤 2：停止当前容器

console
docker stop dotnet-sdk

步骤 3：删除当前容器

console
docker rm -v dotnet-sdk

步骤 4：使用新镜像启动容器

console
docker run --name dotnet-sdk bitnami/dotnet-sdk:latest

使用 docker-compose

注意：docker-compose.yaml 文件未经内部测试，建议仅用于开发或测试环境。如需报告问题或修复，可参考 贡献指南。

基础 docker-compose.yaml 配置示例：

yaml
version: '3'
services:
  dotnet-sdk:
    image: bitnami/dotnet-sdk:latest
    volumes:
      - /path/to/dotnet-persistence:/bitnami
    # 可添加其他配置（如网络、环境变量等）

配置说明

FIPS 配置（Bitnami 安全镜像）

Bitnami 安全镜像系列中的 .NET SDK 镜像支持 FIPS 配置，可通过以下环境变量设置：

• OPENSSL_FIPS：控制 OpenSSL 是否启用 FIPS 模式。可选值：yes（默认）、no。

示例：

console
docker run -e OPENSSL_FIPS=no --name dotnet-sdk bitnami/dotnet-sdk:latest

贡献和问题反馈

贡献

欢迎通过提交 Pull Request 贡献代码或修复，贡献前请参考 贡献指南。

问题反馈

如在使用中遇到问题，可通过 GitHub Issues 提交 issue，并按模板填写相关信息以获得更好支持。

许可信息

版权所有 © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。

本软件根据 Apache License 2.0 许可协议授权；除非遵守许可协议，否则不得使用本文件。

可在以下地址获取许可协议副本：<[***]>

除非适用***要求或书面同意，否则软件按"原样"分发，不提供任何明示或暗示的保证或条件。详见许可协议以获取具体权限和限制。