bitnamicharts/multus-cni

Multus CNI 镜像文档（Bitnami 封装）

镜像概述和主要用途

Multus CNI 是一款用于 Kubernetes 集群的容器网络接口（CNI）插件，采用 Go 语言开发，核心功能是为 Pod 提供多个网络接口的能力。通过 Multus，Kubernetes 集群可实现复杂网络拓扑，满足多网络平面、网络隔离、多租户等场景需求。

Bitnami 封装的 Multus CNI 镜像提供了预配置的部署模板和优化的容器配置，简化了在生产环境中的集成流程，支持通过 Helm 包管理器快速部署和管理。

核心功能和特性

• 多网络接口支持：允许单个 Pod 同时连接多个独立网络，满足复杂网络需求（如数据平面与控制平面分离、多租户网络隔离）。
• CNI 规范兼容：遵循 CNI 1.0+ 规范，可与主流 CNI 插件（如 Calico、Flannel、Weave Net）配合使用，作为主 CNI 的补充。
• 动态网络配置：通过 Kubernetes CRD（NetworkAttachmentDefinition）定义网络，支持动态为 Pod 分配网络接口。
• Bitnami 优化：包含安全加固配置（最小权限原则、非 root 用户运行选项）、资源使用优化及标准化部署流程。
• Kubernetes 原生集成：通过 DaemonSet 实现节点级部署，自动适配集群网络环境。

使用场景和适用范围

Multus CNI 适用于需要复杂网络能力的 Kubernetes 集群场景，包括但不限于：

• 多网络平面隔离：如将 Pod 的业务流量与管理流量分离到不同网络接口。
• 多租户网络隔离：为不同租户或团队分配独立网络，实现数据隔离。
• 边缘计算场景：边缘节点需同时接入本地网络和云网络时，通过多接口实现双向通信。
• 网络功能虚拟化（NFV）：如容器化防火墙、负载均衡器等网络功能需要多网络接口处理流量。
• 混合云/多云网络：Pod 需同时连接私有云和公有云网络时，通过多接口实现跨云网络访问。

前提条件

部署 Multus CNI 需满足以下环境要求：

• Kubernetes 集群版本：1.23+
• Helm 版本：3.8.0+
• 集群支持 PV 动态供应（Persistent Volume Provisioner）
• 支持 ReadWriteMany（RWX）访问模式的存储卷（用于部署扩展）

详细使用方法和配置说明

快速部署（TL;DR）

通过 Bitnami Helm 仓库一键部署：

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/multus-cni

安装步骤

1. 添加 Helm 仓库（如需自定义仓库）

console
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

2. 部署 Multus CNI

使用自定义配置文件（values.yaml）部署：

console
helm install my-multus bitnami/multus-cni -f values.yaml

说明：替换 my-multus 为自定义发布名称，values.yaml 为本地配置文件路径。

部署配置详情

主机路径配置

Multus 需要挂载主机节点的 CNI 二进制目录和配置目录，确保以下参数正确设置（默认值适用于大多数集群）：

• hostCNIBinDir：主机 CNI 二进制文件目录，默认 /opt/cni/bin
• hostCNINetDir：主机 CNI 配置文件目录，默认 /etc/cni/net.d

如需修改，可在 values.yaml 中配置：

yaml
hostCNIBinDir: /custom/cni/bin
hostCNINetDir: /custom/cni/net.d

资源配置

根据集群规模调整资源请求和限制，避免节点资源竞争：

yaml
resources:
  requests:
    cpu: 100m
    memory: 64Mi
  limits:
    cpu: 500m
    memory: 256Mi

建议：生产环境中根据节点数量和网络负载调整，小型集群（<50 节点）可使用默认值，大型集群建议提高内存限制至 512Mi。

网络策略配置

默认启用 NetworkPolicy 以限制 Pod 网络访问，可通过以下参数调整：

yaml
networkPolicy:
  enabled: true  # 启用网络策略
  allowExternal: false  # 仅允许带标签的 Pod 访问
  ingressNSMatchLabels:  # 允许指定命名空间的流量
    kubernetes.io/metadata.name: kube-system
  extraIngress:  # 额外入站规则
    - from:
        - podSelector:
            matchLabels:
              app: monitoring

私有镜像仓库配置

如需从私有仓库拉取镜像，需配置镜像拉取密钥：

1. 创建包含私有仓库凭证的 Secret：

   yaml
   apiVersion: v1
   kind: Secret
   metadata:
     name: private-registry-secret
   type: kubernetes.io/dockerconfigjson
   data:
     .dockerconfigjson: <base64-encoded-docker-config>
   

2. 在 values.yaml 中引用该 Secret：

   yaml
   imagePullSecrets:
     - name: private-registry-secret
   image:
     registry: my-private-registry.com
     repository: my-repo/multus-cni
     tag: 4.0.2  # 指定镜像标签
   

参数详解

全局参数

通用参数

Multus CNI 核心参数

重要注意事项：Bitnami 镜像仓库变更通知

自 2025 年 8 月 28 日起，Bitnami 将调整公共镜像仓库策略，推进 Bitnami Secure Images 计划：

• 旧镜像迁移：所有现有镜像（含历史版本标签，如 4.0.0、3.9.1）将在两周内迁移至 docker.io/bitnamilegacy 仓库，且不再接收更新。
• 免费版镜像调整：免费用户仅可访问精简的安全加固镜像（仅 latest 标签），适用于开发环境；非加固的 Debian 基础镜像将逐步淘汰。
• 生产环境建议：生产 workload 需迁移至 Bitnami Secure Images，包含安全加固、CVE 透明度（VEX/KEV）、SBOM 清单及企业级支持。

详情参见 https://github.com/bitnami/containers/issues/83267%E3%80%82

备份与恢复

Multus CNI 本身无持久化状态数据，其配置通过 Kubernetes API 对象（如 DaemonSet、ConfigMap）管理。如需备份集群网络配置，建议：

1. 备份 Multus 相关 CRD（NetworkAttachmentDefinition）：

   bash
   kubectl get network-attachment-definitions -o yaml > multus-networks-backup.yaml
   

2. 备份 Helm 发布配置：

   bash
   helm get values my-multus-release -o yaml > multus-values-backup.yaml
   

3. 集群级灾难恢复建议使用 Velero，具体操作参见 Bitnami 备份与恢复指南。