YANG：简介——我理解的YANG

已于 2023-06-20 16:47:38 修改
阅读量1.4k 收藏 5
点赞数 1
分类专栏： NETCONF/YANG 文章标签： 网络 服务器 网络协议
于 2023-06-16 17:05:59 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/bobzone/article/details/131240210
版权

专注NETCONF/YANG技术科普，接受任何问题，包括我答不上来的问题。欢迎光临！欢迎提问：链接

引子

之前在【侃大山】为啥要有NETCONF？为啥要有YANG？的时候说过，IETF的NETMOD工作组在对历史网管协议一通批判后，花大力气基于XML设计了一套新的网络配置管理协议，也就是NETCONF（Network Configuration Protocol）协议。这时光有管理协议，但是并没有统一定义各个设备厂商的API接口描述语言。
在这里插入图片描述
NETCONF协议分为安全传输层、消息层、操作层、内容层，即上图的(1)(2)(3)(4)层。其中，
(3)操作层支持的基础操作有：查询配置或者状态；查询配置；配置下发；复制一份配置并下发；删除配置；配置加锁、解锁；关闭会话；强制关闭会话。——至此各种操作定义都很清晰明确。
(4)内容层则只有一个模糊的举例（上图红色框中）。——configuration data怎么定义？YANG标准的出现就是为了解决这个问题。

YANG是NETCONF协议的一种面向管理对象的数据建模语言

YANG是NETCONF协议的一种面向管理对象的数据建模语言。YANG模型定义了数据的层次化结构，可用于基于NETCONF的操作，包括配置、状态数据、远程过程调用和通知。从NETCONF的视角而言，YANG可以对NETCONF客户端和服务器端之间发送的所有数据进行一个完整的描述。从设备管理对象数据建模的视角而言，YANG是对本设备上业务对象的一种层次化数据建模。
我们来看一个具体的NETCONF报文1，找到报文的内容层。
在这里插入图片描述
观察内容层，这是一个ISIS协议模型。顶层isiscomm是YANG模块的名称，这个YANG模块的YANG文件名叫做huawei-isiscomm.yang2。虽然还不知道这个YANG模块的详细内容，但是我们根据XML的基础知识能大致知道ISIS特性下有ISIS的实例，每个实例下有ISIS实例ID、实例描述信息，以及实例所属的VPN。当然NETCONF报文只能体现模型的片段，实际的YANG模型文件内容一定比这个多。

学习一个具体的YANG文件

huawei-system.yang3是一个短小精练的YANG模型文件。个人比较喜欢。你可以从github上下载此YANG文件，下载方法见YANG模型的开源：各国际标准的YANG模型和各厂商开源的YANG模型。一起来学习：

/*
Copyright (C) 2020 Huawei Technologies Co., Ltd. All rights reserved.
*/
module huawei-system {
  namespace "urn:huawei:yang:huawei-system";
  prefix system;
  import huawei-pub-type {
    prefix pub-type;
  }
  import huawei-extension {
    prefix ext;
  }
  
  organization
    "Huawei Technologies Co., Ltd.";
  contact
    "....";
  description
    "System.";
  revision 2020-03-02 {
    description
      "Initial revision.";
    reference
      "Huawei private.";
  }
  ext:task-name "system";
  
  typedef risk-level-type {
    type enumeration {
      enum "high" {
        value 0;
        description
          "High level.";
      }
      ...
      enum "low" {
        value 2;
        description
          "Low level.";
      }
    }
    description
      "Security risk level.";
    }
  }
  ...
  // add grouping here
  container system {
    description
      "System.";
    container system-info {
      description
        "Configure system information.";
      leaf sys-name {
        type string {
          length "1..246";
        }
        default "HUAWEI";
        description
          "System name.";
      }
      leaf sys-contact {
        type string {
          length "1..255";
        }
        default "R&D Beijing, Huawei Technologies co.,Ltd.";
        description
          "System contact information.";
      }
      leaf sys-location {
        type string {
          length "1..255";
        }
        default "Beijing China";
        description
          "System location information.";
      }
      ...
      leaf sys-uptime {
        type pub-type:time-tick;
        config false;
        description
          "Time elapses since the system is running.";
      }
      ...
      }
    }
    container security-risks {
      config false;
      description
        "List of security risk information.";
      list security-risk {
        key "level feature-name type content";
        description
          "Statistics of security risk.";
        leaf level {
          type risk-level-type;
          description
            "Security risk Level.";
        }
        leaf feature-name {
          type string {
            length "1..31";
          }
          description
            "Feature name.";
        }
        leaf type {
          type security-risk-type;
          description
            "Security risk type.";
        }
        leaf content {
          type string {
            length "1..511";
          }
          description
            "Risk information.";
        }
        leaf repair-action {
          type string {
            length "1..511";
          }
          description
            "Repair action.";
        }
      }
    }
  }
  // add augment here
  // add rpc here
}

module是YANG模块的基本单元，YANG模型是由一个个module以及module之间的连接关系组成的。module是写YANG文件的基本框架，包括以下几种类型的语句：

  • module框架：这个module名称是huawei-system。
  • head语句：namespace、prefix是必须要有的；module中定义的所有节点都属于这个唯一的特定XML名字空间；prefix是用来定义和module、namespace相关联的标识符的前缀，用于netconf报文，或者其他YANG文件import自己。yang-version这里没写，是默认yang1.0。
  • 连接语句：import、include。module引用module用import；一个module下包含多个子模块用include。huawei-system.yang引用了huawei-pub-type和huawei-extension。几乎每个设备厂商都会有一两个公共基础YANG模块供各业务模块调用，思科、juniper也是这样。huawei-pub-type和huawei-extension是华为的两个公共基础YANG模块，huawei-pub-type定义了网络协议中的一些公共数据类型；huawei-extension定义了厂商的一些扩展语法。
  • 元信息：organization、contract；
  • 版本信息：revision语句根据日期区分相同YANG模块的不同版本。
  • 定义语句：container、list、leaf、leaf-list、grouping等等
    涉及内容较多，后面讲。

最后汇总一个YANG module组成元素简单介绍表

元素描述
moduleYANG将数据模型构建为模块，模块名与YANG文件名一致。 一个模块可以从其他模块中导入数据，也可以从子模块中引用数据。 外部模块的引入（import & include）：“include”声明允许模块或者子模块引用子模块中的材料，“import”声明允许引用其他模块中定义的材料。
namespace模块的名字空间，是全球唯一的URI。在对数据的XML编码过程中会使用到名字空间。
prefixnamespace的简写，简写唯一。
organizationYANG归属组织名。
contactYANG模块的联系信息。
descriptionYANG模块的功能描述。
revisionYANG模块的版本信息，提供了模块的编辑版本历史。
container容器节点，用来描述若干相关节点的集合。
list列表节点，定义了列表条目序列，每个条目就像一个结构体或者一个记录实例，由其关键叶节点的值（key值）唯一识别。
leaf叶节点。一个叶节点包含简单的数据，如整形数据或字符串。

使用PYANG工具可以把YANG模型转换成YANG tree格式，用一棵树的形式能直观的看出层次化模型结构，感兴趣的同学可以阅读YANG工具的开源：PYANG安装方法的最后一小节“YANG tree可视化”。

  1. 报文来自：https://support.huawei.com/enterprise/zh/doc/EDOC1100138323/d602da5e ↩︎

  2. 公网已经搜不到huawei-isiscomm.yang这个文件了。据我所知，这个文件是华为多年前YANG重构之前的YANG文件，那个时候的命名格式还是小驼峰。 ↩︎

  3. https://github.com/Huawei/yang/blob/master/network-router/8.20.0/ne40e-x8x16/huawei-system.yang ↩︎

bobzone
关注
专栏目录
黎曼几何引论：Yang Mills场简介
AI天才研究院
09-23 799
黎曼几何引论：Yang -Mills场简介 关键词： 黎曼几何 Yang-Mills场 自然对称群 能量泛函 虚拟类
大语言模型应用指南：神经网络的三要素——网络结构、激活函数和损失函数
AI天才研究院
07-13 882
大规模预训练：利用海量的文本数据进行无监督学习，让模型学习语言的统计规律。自回归语言建模：模型通过预测下一个单词来学习语言结构。注意力机制：使用自注意力机制来捕捉序列中的长距离依赖关系。迁移学习：预训练的模型可以通过微调适应各种下游任务。模型规模和性能的显著提升：从BERT到GPT-3，模型参数从数亿增长到数千亿。预训练方法的创新：从单向语言模型到双向模型，再到生成式预训练。迁移学习能力的增强：预训练模型可以快速适应各种下游任务。
yang学习
forget_1111的博客
06-17 2541
yang模型入门总结
yang模型理解
热门推荐
dolphin98629的专栏
02-07 4万+
前言 继之前分享的几篇文章之后，这篇文章分享自己对于YANG模型的理解。 关于其他如何搭建环境以及编写app等等请阅读下前几篇文章。 一、Yang的来源 早在2003年，IETF成立了一个NETCONF工作组，提出一种基于XML的网络配置管理协议，也就是NETCONF(Network Configuration Protocol)，因为该协议的配置功能非常强大，同时兼顾监控和故
对YANG的解读
~~ LINUX ~~
06-19 3005
1 为什么要有YANG netconf需要对设备的配置(configuration)和状态(state)做操作，例如编辑配置，获取状态，因此需要一种语言来对configuration和state进行建模，甚至连“操作”也可以通过YANG来建模。建好的模型，最后以XML的形式进行实例化。打个比方，我需要向领导请假，领导说你写个请假单，包含请假人的姓名，请假的起止时间，请假事由和代理人。于是我做了一个...
【侃大山】为啥要有NETCONF？为啥要有YANG？
bobzone的博客
06-05 820
NETCONF YANG
YANG语言、YANG数据模型、YANG数据
1003
05-07 1万+
YANG语言 描述数据类型的语言，最初是为网络数据模型设计的。 结构化语言。 每个数据模型都是一个module独立的顶级节点层次结构。 数据类型可以imported来自另一个YANG模块，也可以在模块中定义。 用containers对相关节点分组。 用lists表示按顺序存储的节点。 用leaf表示节点的每个单独属性。 每个叶子必须有一个相关的type。 module ietf-inte...
yang建模语言处理资料
01-05
这里面包括了一些厂商的YANG文件，以及YANG的处理工具
YANG工具的开源：PYANG安装方法
bobzone的博客
06-08 1800
PYANG是个github上的开源项目。作者是Martin Bjorklund。NETCONF、YANG的RFC都是这哥么写的，还是唯一作者，其他人只是“有贡献”。有多牛叉不用说了吧。他的名字就是权威。项目链接：https://github.com/mbj4668/pyang这哥们的github账号有点山寨。大家忽略。
columbia-yang-he.github.io:我的博客，分享技术和一些好东西
03-22
【描述】"columbia-yang-he.github.io:我的博客，分享技术和一些好东西"进一步确认了博客的主要目的——技术分享和趣味内容传播。这可能包括编程技巧、软件开发经验、开源项目介绍或者是个人的学习心得。 【标签】...
Yang语言规范描述
04-12
YANG是一种数据建模语言，被用来为NETCONF，NETCONF远程过程调用，NETCONF Notification操作的配置和状态数据进行建模。
libyang：YANG数据建模语言库
01-30
利阳 libyang是用C编写（并提供API）的YANG数据建模语言解析器和工具包。该库用于 ， ， 和项目中。 提供的功能 以YANG格式解析（和验证）模式。 以YIN格式解析（和验证）模式。 解析，验证和打印XML格式的实例数据。 解析，验证和打印JSON格式的实例数据（ ）。 使用实例数据进行操作。 支持实例数据中的默认值（ ）。 支持YANG扩展。 支持YANG元数据（ ）。 功能丰富的YANG工具。 当前的实现包括YANG 1.0（ ）和YANG 1.1（ ）。 分行 该项目使用2个主要分支master和devel 。 其他分支不应被克隆。 在master有最后一个正式发行版的文件。 在devel可以找到至少经过简短测试的任何最新改进和更改。 在每个新发行版中， devel都将合并为master 。 这意味着仅在使用稳定的正式发行版时，既可以使用master版，也可以下载特定发行版。 如果应该应用所有最新的错误修正，则使用devel分支。 请注意，无论何时创建新问题并将其发生在master分支上，第一个响应都可能是在进一步提供任何支持之前使用
YANG数据模型RFC
07-30
YANG数据模型的详细介绍，内容详细，不过是英文版的哦
netconf yang模型-ietf和cisco
03-16
netconf yang模型-ietf和cisco
yang
03-27
yang
四、高并发系统限流机制——限流算法：令牌桶算法
流楚丶格念的博客
08-06 890
请求处理时间指系统从接收到请求到处理完成的时间，包括令牌的生成和消耗过程。此指标衡量系统响应速度。系统吞吐量指单位时间内系统能够处理的请求数量。高吞吐量表明系统能在高负载下维持良好性能。延迟指请求从提交到开始处理的时间，包括等待令牌的时间。延迟高时会影响用户体验。
四、高并发系统限流大法——限流算法：漏桶算法
最新发布
流楚丶格念的博客
08-20 879
漏桶算法是一种用于流量控制的算法，通过一个“漏桶”来处理请求。请求被放入桶中，桶以固定速率“漏出”请求。如果桶满了，新请求将被丢弃或延迟。漏桶算法适用于需要平稳输出请求速率的场景，能够有效控制流量和负载。
python anytree_如何对一棵树进行可视化（python anytree 简易实现）
weixin_36128925的博客
01-28 3437
Python 中有个很酷的第三方包叫做anytree，全名 Any Python Tree Data，i.e. 期望用来表示任何树的数据结构。而其中的可视化功能，每次都令人印象深刻。这篇文章简单分享，个人解决问题的思考路径 & 简易实现～>> ...>> r = RenderTree(root)>> print(r)Node('/A')├── Node(...
Python读写文件
YANG_Gang2017的博客
10-25 670
转载:http://www.cnblogs.com/allenblogs/archive/ 2010/09/13/1824842.html Python读写文件 1.open 使用open打开文件后一定要记得调用文件对象的close()方法。比如可以用try/finally语句来确保最后能关闭文件。 file_object = open('thefile.txt')
一句句解释分析细致讲解一下这段代码<get> <filter type="subtree"> <acc-devm:ptps xmlns:acc-otn="urn:ccsa:yang:acc-otn" xmlns:acc-eth="urn:ccsa:yang:acc-eth" xmlns:acc-gmetro="urn:ccsa:yang:acc-gmetro" xmlns:acc-devm="urn:ccsa:yang:acc-devm" xmlns:acc-eos="urn:ccsa:yang:acc-eos" xmlns:acc-sdh="urn:ccsa:yang:acc-sdh"> <acc-devm:ptp> <acc-devm:name/> </acc-devm:ptp> </acc-devm:ptps> </filter> </get>
06-09
这段代码是用于获取设备管理（acc-devm）中的 PTP（精密时钟协议）信息。我们可以一句句来解释这个代码： 1. `<get>`：这个标签是用于发送一个读取请求，用于获取指定节点的数据。 2. `<filter type="subtree">`：这个标签是用于指定筛选条件，type="subtree" 表示筛选子树，即只获取指定节点以及它的子节点的信息。 3. `<acc-devm:ptps xmlns:acc-otn="urn:ccsa:yang:acc-otn" xmlns:acc-eth="urn:ccsa:yang:acc-eth" xmlns:acc-gmetro="urn:ccsa:yang:acc-gmetro" xmlns:acc-devm="urn:ccsa:yang:acc-devm" xmlns:acc-eos="urn:ccsa:yang:acc-eos" xmlns:acc-sdh="urn:ccsa:yang:acc-sdh">`：这个标签表示要获取的节点，它定义了一个命名空间 `acc-devm`，并指定了多个其他命名空间，用于指定该节点所属的模块和模块中包含的其他节点。 4. `<acc-devm:ptp>`：这个标签表示 PTP 节点。 5. `<acc-devm:name/>`：这个标签表示 PTP 节点下的 name 节点，它是一个空节点，表示我们只需要获取 PTP 节点的名称。 6. `</acc-devm:ptp>`：表示 PTP 节点结束。 7. `</acc-devm:ptps>`：表示 PTPS 节点结束，它是 PTP 的父节点。 最终，这段代码将会返回指定设备管理模块中所有 PTP 节点的名称信息。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值