onosproject/onos-config

onos-config

ONOS配置子系统，基于µONOS架构构建，提供网络设备配置管理的核心功能。

镜像概述和主要用途

onos-config是ONOS（开放网络操作系统）的配置子系统，旨在提供网络设备的集中式配置管理能力。其核心目标是基于gNMI协议扩展单设备事务性配置能力，支持多设备批量配置的原子性操作，并提供配置变更跟踪与回滚机制，适用于中小规模网络环境的设备配置管理。

核心功能和特性

主要设计目标

• 多设备事务性配置：支持通过北向gNMI API发起针对多个设备的批量配置操作，确保所有变更要么全部应用，要么全部不应用，实现事务原子性。
• 配置变更跟踪与回滚：记录应用于设备集的配置变更事务历史，支持通过北向管理API回滚到之前的配置检查点。

次要设计目标

• 高可用性与分布式操作：支持高可用部署和分布式运行，包括滚动升级能力。
• 规模支持：可管理约50台设备、5000个端口，支持每天约10K增量配置事务。

附加功能（待集成）

• 预加载未发现/未部署设备的初始配置。
• 配置预验证（Dry run）：基于模型和业务策略验证配置合法性。
• 导入现有设备配置。
• 配置意图：将高层（全网级）配置需求转换为底层（设备级）操作。

核心原则

• 北向API：以gNMI和gNOI为主要北向接口，利用其标准化事务语义；增强型北向管理API为gRPC服务，支持变更日志导航和回滚操作。
• 南向API：采用gNMI和gNOI，可直接与Stratum兼容交换机对接；对不支持gNMI/gNOI的设备，可通过代理代理或设备端适配器适配。
• 诊断服务：提供gRPC诊断服务，支持通过远程工具检查内部状态（无向后兼容性约束）。
• 架构独立性：设计为独立实体，可与现有ONOS 2.0架构及新一代ONOS架构集成。

高层设计

系统采用分布式架构设计，支持高可用性和滚动升级，具体架构可参考项目设计文档中的图示。

使用场景和适用范围

• 中小规模网络配置管理：适用于管理约50台网络设备、5000个端口的场景。
• 配置事务需求高的环境：需要确保多设备配置变更原子性的网络环境。
• 需配置审计与回滚能力的场景：要求跟踪配置变更历史并支持故障回滚的网络运维场景。

使用方法和配置说明

构建与运行

具体构建、运行和部署方法可参考项目文档：

• 构建指南：构建onos-config服务、相关命令及Docker镜像。
• 运行指南：运行onos-config服务及相关命令。
• 部署指南：在Kubernetes集群中部署onos-config。

设备接入

通过模型插件（Model Plugins）扩展设备支持，详见设备接入指南。

测试与开发

• 测试指南：使用onit进行集成测试。
• 开发工作流：onos-config项目的开发者工作流程。

附加文档

• 贡献指南：如何为onos-config项目贡献代码。
• 社区信息：项目联系人和会议信息。