4. YANG模型与OpenConfig在Ciena中的应用

在Ciena的光网络自动化体系中，YANG模型是设备可编程能力的“数据契约”。无论是通过NETCONF、gNMI还是RESTCONF下发配置，控制器与网元之间交换的并不是随意拼写的命令行，而是严格遵循YANG模型定义的结构化数据。理解YANG模型结构、OpenConfig标准模型与Ciena专有模型之间的关系，是构建稳定自动化脚本和性能遥测管道的前提。

YANG模型的基本结构

YANG是一种用于描述网络配置与状态数据的建模语言，其核心思想是把设备数据组织成一棵层次化的树。树的每个节点称为数据节点，节点可以是容器（container）、列表（list）、叶子（leaf）或叶子列表（leaf-list）。容器用于分组，列表用于表示可重复的条目，叶子承载具体值。每个叶子都带有类型（type），例如string、uint32、boolean、enumeration，类型决定了该节点允许的取值范围和编码方式。

YANG模型还通过config与state区分可写配置和只读状态。在Ciena设备上，一个光通道的配置可能包含admin-state、frequency、target-output-power等可写叶子，而operational-state、measured-output-power、laser-bias-current等则属于状态数据。自动化系统必须清楚哪些节点可写、哪些只读，否则会出现配置被拒绝或遥测数据无法订阅的问题。

YANG的另一个关键机制是augment和deviation。标准模型不可能覆盖所有厂商特性，Ciena通过augment在标准路径上扩展专有节点，通过deviation声明对标准节点的支持差异。例如，标准模型可能定义了某个可选叶子，但Ciena设备不支持，deviation会明确标注“not-supported”，使客户端在生成代码或校验配置时能够提前规避。

OpenConfig模型与Ciena专有模型的关系

OpenConfig是一套由运营商主导、厂商中立的YANG模型集合，目标是让多厂商设备通过统一路径暴露配置和状态。在光传输领域，OpenConfig定义了openconfig-optical-transport、openconfig-terminal-device等模型，覆盖光通道、光放大器、终端设备等对象。Ciena设备在实现OpenConfig模型时，会将其映射到内部数据模型，并在标准路径上通过augment补充专有参数。

以光通道为例，OpenConfig标准路径可能只定义了/optical-channel/config/frequency和/optical-channel/state/output-power，而Ciena的专有模型会在同一路径下扩展ciena-optical-channel:pre-fec-ber、ciena-optical-channel:q-margin等性能参数。这种“标准路径 + 专有扩展”的方式，使得自动化脚本可以先用标准路径完成通用操作，再按需读取Ciena专有节点获取更精细的遥测数据。

需要注意的是，不同Ciena产品线（如Waveserver、6500、WaveLogic系列）对OpenConfig的支持程度和扩展节点可能不同。在实际工程中，应先通过get-schema或gNMI Capabilities获取设备实际加载的YANG模块列表和版本，再决定使用哪些路径。直接假设某路径存在，往往会导致invalid-path或unknown-element错误。

模型驱动管理的实际工作方式

模型驱动管理意味着客户端不再依赖命令行文本解析，而是基于YANG Schema生成请求。以gNMI为例，一个典型的配置下发流程如下：客户端先通过Capabilities获取设备支持的模型和编码格式，然后构造SetRequest，其中包含path和val。路径必须严格符合YANG树结构，值必须符合叶子类型。设备收到请求后，会进行Schema校验、事务提交，并返回UpdateResult。

# gNMI SetRequest 示例（伪代码结构）
path: /openconfig-optical-transport:optical-channel/config/frequency
val:  193100000  # 单位 MHz，对应 193.1 THz

# Ciena 专有扩展路径示例
path: /openconfig-optical-transport:optical-channel/state/
      ciena-optical-channel:pre-fec-ber
val:  1.2e-4

在遥测场景中，模型驱动管理同样关键。gNMI Subscribe请求需要指定路径、采样模式和采样间隔。例如，订阅光通道的pre-fec-ber和q-margin，采样间隔设为10秒，设备会按YANG模型定义的类型和单位推送数据。如果路径拼写错误或节点不存在，Subscribe会立即返回错误，而不是静默失败。因此，在编写遥测采集器时，建议先用gNMI Get验证路径可读，再启动订阅。

常见问题与判断依据

在实际操作中，最常见的三类问题都与模型理解偏差有关。第一类是路径错误：把config和state混用，例如试图向state下的只读节点写入数据，设备会返回access-denied。第二类是类型不匹配：YANG叶子定义了uint32，但脚本传入了字符串或超出范围的数值，校验会失败。第三类是模型版本差异：同一路径在不同软件版本中可能被重命名或废弃，升级后脚本需要同步调整。

判断模型是否被正确使用，可以观察三个信号：配置提交后返回ok且无error信息；状态读取返回的数据类型与YANG定义一致；遥测订阅持续收到数据且时间戳递增。如果出现unknown-element，应优先检查模块是否已加载、命名空间是否正确；如果出现invalid-value，应检查叶子类型和取值范围。把这些判断依据固化到自动化脚本的异常处理中，可以显著减少排障时间。

YANG模型与OpenConfig在Ciena中的应用，本质上是在标准与专有之间建立可编程的映射关系。掌握模型结构、理解扩展机制、验证路径可用性，是构建可靠光网络自动化和性能遥测系统的基础能力。