Multus CNI安装与配置指南

1. 项目目录结构及介绍

Multus CNI 是一个增强Kubernetes网络能力的开源项目，特别是在支持Pod拥有多个网络接口上。以下是该项目的基本目录结构及其简介：

.
├── docs                   # 文档目录，包含快速入门、设计文档等。
├── examples               # 示例目录，展示如何配置和使用Multus的各种应用场景。
├── pkg                    # 核心包，包含CNI插件的主要逻辑代码。
│   ├── cni                 # CNI插件相关的代码，包括主程序main.go、配置解析等。
│   ├── config              # 配置处理相关代码，涉及JSON/YAML配置文件解析。
│   └── resources          # 网络资源管理代码，与Kubernetes API交互，管理NetworkAttachmentDefinition等。
├── scripts                # 辅助脚本，如部署、测试等工具。
├── vendor                 # 第三方依赖库。
└── ...

• docs: 包含用户手册、快速入门指南和开发者文档。
• examples: 提供实际的应用示例，帮助理解如何配置Multus。
• pkg: 项目的核心逻辑所在，重要的网络功能实现区域。
  • cni: 实现CNI插件的具体逻辑，包括初始化、CNI配置处理、IP地址管理等。
  • config: 负责解析Multus和网络附件定义的配置。
  • resources: 与Kubernetes API交互，用于处理Pod及网络资源的管理。

2. 项目的启动文件介绍

在部署Multus时，并没有直接的“启动文件”这一概念，而是通过一系列配置步骤集成到Kubernetes集群中。关键过程涉及到配置CNI插件链路、NetworkAttachmentDefinitions(NADs)以及确保Multus的CNI插件放置在所有节点上的正确位置。

• 部署准备：通常通过YAML文件来部署Multus，利用Kubernetes的DaemonSet或Deployment资源，确保每节点都运行Multus代理。
• CNI配置整合：系统会在每个节点的 /etc/cni/net.d 目录下自动或手动添加Multus的配置，例如生成 00-multus.conf，指向Multus CNI插件的路径。
• Kubernetes API访问：Multus需要访问Kubernetes API以获取NAD等资源，这通常需要配置API凭据，放置于 /etc/cni/net.d/multus.d 目录下的凭证文件。

3. 项目的配置文件介绍

主CNI配置 (00-multus.conf)

这个配置文件位于每个节点的 /etc/cni/net.d 目录下，定义了Multus的接入方式。例如：

{
    "name": "multus-cni-network",
    "type": "multus",
    "delegate": {
        "name": "cbr0",
        "type": "bridge"
    }
}

此配置示例说明Multus将委托给名为cbr0的桥接网络插件（这是一个简化的例子，实际配置可能更复杂，包括对额外网络的定义）。

NetworkAttachmentDefinition (NADs)

NADs是yaml文件，定义了一个网络接口的配置，它们存储在网络命名空间中，由Multus读取并应用于Pod。例如：

apiVersion: networking.k8s.io/v1
kind: NetworkAttachmentDefinition
metadata:
  name: example-nad
spec:
  config: |
    { 
      "cniVersion": "0.3.1",
      "type": "macvlan",
      "master": "eth0",
      "mode": "bridge",
      "ipam": {
        "type": "host-local"
      }
    }

这段配置指示Multus在Pod上创建一个基于Macvlan的接口，连接到主机的eth0，并使用本地IP地址管理。

综上所述，Multus CNI的部署和配置涉及多个层面，从基本的CNI配置到复杂的网络附件定义，都是确保Pod能够拥有并管理多个网络接口的关键步骤。