Contiv Netplugin 安装与使用指南

1. 项目目录结构及介绍

Contiv Netplugin 是一个设计用于处理集群多主机系统中的网络场景的通用网络插件。其核心功能覆盖了从多租户环境到容器网络策略等多个方面。以下是其基本的目录结构以及关键部分的简介：

.
├── bin                    # 编译后的可执行文件存放地
├── contivmodel            # 容器网络模型相关代码
├── core                   # 核心逻辑实现
├── docs                   # 文档资料
├── drivers                # 各种驱动程序，包括网络和状态驱动
├── install                # 安装脚本或说明
├── mgmtfn                 # 管理功能相关的代码
├── netctl                 # netctl命令行工具的相关代码
├── netmaster              # 网络主控逻辑
├── netplugin              # 主网络插件代码
├── objdb                  # 对象数据库相关
├── scripts                # 辅助脚本
├── state                  # 状态管理相关代码
├── test                   # 测试相关代码
├── utils                  # 工具函数库
├── vagrant                # Vagrant文件，用于快速搭建开发测试环境
├── vendor                 # 第三方依赖包
└── ...

• bin: 存储编译后的二进制执行文件。
• contivmodel: 定义网络模型和对象的结构。
• core: 实现网络插件的核心逻辑。
• drivers: 包含StateDriver和NetworkDriver等，是网路操作的关键组件。
• netctl: 用户与网插交互的命令行工具的源码。
• scripts: 启动、配置、测试等辅助脚本。
• state: 状态存储逻辑。
• test: 包括单元测试和系统测试脚本。

2. 项目的启动文件介绍

Contiv Netplugin 的启动通常不是直接通过一个单一的“启动文件”来执行的，而是通过Makefile中的目标来管理。其中，“make demo”是最常用的启动方式之一，它负责设置一个演示环境，包括启动Vagrant虚拟机来运行Contiv服务。主要入口点位于项目根目录下的main.go文件，该文件负责解析命令行参数，并创建一个Agent实例来处理后续的网络管理和控制流程。

启动过程简要概括为：

• 解析命令行参数配置。
• 新建一个Agent实例。
• 初始化，如连接到网络状态存储服务（如ETCD）。
• 监听并处理网络事件。

3. 项目的配置文件介绍

Contiv Netplugin 使用命令行参数来配置启动选项，而不是依赖于传统意义上的独立配置文件。配置信息主要通过Makefile变量传递给启动脚本，例如使用CONTIV_MEMORY和CONTIV_CPUS来调整Vagrant虚拟机的内存和CPU数量。

尽管没有明确的“配置文件”，但可以通过以下几种方式进行配置：

• 命令行参数：在启动时通过命令行指定各种配置选项。
• 环境变量：如上所述，利用特定的环境变量设置配置。
• ETCD/Consul键值对：作为分布式存储，用来存放网络状态和配置信息，间接影响Netplugin的行为。

为了自定义配置，用户可以修改Makefile中的默认值，或是在调用make demo等命令时，通过环境变量的形式提供定制化配置。例如：

CONTIV_MEMORY=4096 CONTIV_CPUS=2 make demo

这样就指定了启动虚拟机时的内存为4GB且CPU为核心数2。

---

以上是对Contiv Netplugin项目的基本结构、启动方法及配置方式的概览，通过遵循这些指导，开发者可以快速搭建和配置Contiv环境，以适应不同的容器网络需求。