Bitnami DeepSpeed 软件包

DeepSpeed 是一套深度学软件套件，用于支持类模型的训练。具备密集或稀疏模型推理、高吞吐量和高压缩等特性。

DeepSpeed 概述

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

快速入门

helm install my-release oci://registry-1.docker.io/bitnamicharts/deepspeed

希望在生产环境中使用 DeepSpeed？请尝试 VMware Tanzu Application Catalog，即 Bitnami 目录的商业版本。

⚠️ 重要通知：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 公告。

简介

此 Chart 使用 Helm 包管理器在 Kubernetes 集群上引导部署 DeepSpeed。

Python 已构建为可完全集成到 Python 环境中，使您能够将其与其库和主要包一起使用。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持 PV 供应器

安装图表

要使用发布名称 my-release 安装图表：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/deepspeed

注意：您需要将占位符 REGISTRY_NAME 和 REPOSITORY_NAME 替换为 Helm 图表仓库和存储库的引用。例如，对于 Bitnami，需使用 REGISTRY_NAME=registry-1.docker.io 和 REPOSITORY_NAME=bitnamicharts。

这些命令使用默认配置在 Kubernetes 集群上部署 DeepSpeed。参数 部分列出了可配置的参数。

提示：使用 helm list 列出所有发布版本

卸载图表

要卸载/删除 my-release 部署：

helm delete my-release

该命令将删除与图表关联的所有 Kubernetes 组件并删除发布版本。

配置和安装详情

资源请求和限制

Bitnami 图表允许为图表部署内的所有容器设置资源请求和限制。这些配置位于 resources 值中（参见参数表）。设置请求对于生产工作负载至关重要，应根据您的具体用例进行调整。

为简化此过程，图表包含 resourcesPreset 值，可根据不同预设自动设置 resources 部分。在 bitnami/common 图表 中查看这些预设。但在生产工作负载中，不建议使用 resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参阅 Kubernetes 官方文档。

滚动标签与不可变标签

强烈建议在生产环境中使用不可变标签。这可确保如果相同标签更新为不同镜像时，您的部署不会自动更改。

如果主容器有新版本、重大变更或严重漏洞，Bitnami 将发布更新容器的新图表。

以 Job 部署

默认情况下，图表将客户端容器（连接到 DeepSpeed 工作节点的容器）部署为 Deployment。这允许您通过 kubectl exec 进入容器并执行操作。如果希望将其部署为 Kubernetes Job，设置 client.useJob=true 值。

加载文件

DeepSpeed 图表支持三种加载文件的方式，按优先级排序如下：

1. 现有配置映射（config map）
2. 在 values.yaml 中添加文件
3. 克隆 Git 仓库

这意味着如果您指定了包含文件的配置映射，图表将不会检查 values.yaml 目录中定义的文件或 Git 仓库。

要使用现有配置映射，设置 source.existingConfigMap=my-config-map 参数。

要在 values.yaml 文件中添加文件，设置 source.configmap 对象包含文件。

最后，如果要克隆 Git 仓库，可使用以下参数：

source.type=git
source.git.repository=[***]
source.git.revision=master

设置 Pod 亲和性

此图表允许使用 affinity 参数设置自定义亲和性。有关 Pod 亲和性的更多信息，请参阅 Kubernetes 文档。

作为替代方案，您可以使用 bitnami/common 图表中提供的 Pod 亲和性、Pod 反亲和性和节点亲和性预设配置。为此，设置 podAffinityPreset、podAntiAffinityPreset 或 nodeAffinityPreset 参数。

额外环境变量

如果需要添加额外环境变量（用于高级操作，如自定义初始化脚本），可在 client、worker 等子部分中使用 extraEnvVars 属性。

client:
  extraEnvVars:
    - name: LOG_LEVEL
      value: error

worker:
  extraEnvVars:
    - name: LOG_LEVEL
      value: error

或者，您可以使用包含环境变量的 ConfigMap 或 Secret。为此，使用 extraEnvVarsCM 或 extraEnvVarsSecret 值。

边车容器（Sidecars）

如果在 Milvus 所在的同一 Pod 中需要额外容器（如额外指标或日志导出器），可使用 sidecars 参数定义。

sidecars:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

如果这些边车容器导出额外端口，可使用 service.extraPorts 参数（如可用）添加额外端口定义，如下例所示：

service:
  extraPorts:
  - name: extraPort
    port: 11311
    targetPort: 11311

注意：此 Helm 图表已包含 Prometheus 导出器的边车容器（如适用）。可在部署时添加 --enable-metrics=true 参数激活这些容器。因此，sidecars 参数应仅用于额外的边车容器。

如果同一 Pod 中需要额外的初始化容器，可使用 initContainers 参数定义。示例如下：

initContainers:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于 边车容器 和 初始化容器 的信息。

备份和恢复

要在 Kubernetes 上备份和恢复 Helm 图表部署，需要使用 Kubernetes 备份/恢复工具 Velero 备份源部署的持久卷，并将其附加到新部署。有关使用 Velero 的说明，请参阅 本指南。

持久化

Bitnami DeepSpeed 镜像可持久化数据。如果启用，默认持久化路径为 /bitnami/deepspeed/data。

图表在此位置挂载 持久卷，卷通过动态卷供应创建。

调整持久卷挂载点权限

由于镜像默认以非 root 用户运行，需要调整持久卷的所有权，使容器能够写入数据。

默认情况下，图表配置为使用 Kubernetes 安全上下文自动更改卷的所有权。但此功能并非在所有 Kubernetes 发行版中都有效。

作为替代方案，此图表支持使用 initContainer 在将卷挂载到最终目标之前更改卷的所有权。

可通过设置 volumePermissions.enabled 为 true 启用此 initContainer。

参数

全局参数

通用参数

源代码参数

客户端部署参数

注：此 Helm Chart 的 README 超出了 DockerHub 25000 字符的长度限制，因此已被截断。完整 README 可在 [***] 查看。