摘自:https://blog.csdn.net/CSND_PAN/article/details/79542917
一、Yang的來源
早在2003年,IETF成立了一個NETCONF工作組,提出一種基於XML的網絡配置管理協議,也就是NETCONF(Network Configuration Protocol),因為該協議的配置功能非常強大,同時兼顧監控和故障管理,安全驗證和訪問控制,所以得到業界的一致認可,所以廣泛采用netconfig來配置網絡。
NETCONF協議分為傳輸層、RPC層、操作層和內容層。其中,內容層是唯一沒有標准化的層,於是一種新的建模語言YANG產生了,它的目標是對NETCONF數據模型、操作進行建模,覆蓋NETCONF協議的操作層和內容層
二、Yang的基本元素
module
module是YANG的基本單元,是寫yang文件的基本框架,包括以下幾種類型語句:
1、head語句(yang-version/namespace/prefix)
2、連接語句(import/include)、
3、元信息(organization/contract)、
4、revision語句、
5、定義語句(container/leaf/leaf-list/grouping等等)。
YANG模塊有如下的布局:
module <module-name> { //header information yang-version statement namespace statement prefix statement // linkage statements import statements include statements // meta information organization statement contact statement description statement reference statement // revision history revision statements // module definitions other statements }
submodule
submodule是部分模塊定義,用於對模塊提供支持。
submodule文件內容布局如下:
submodule <module-name> { yang-version statement // module identification belongs-to statement // linkage statements import statements include statements // meta information organization statement contact statement description statement reference statement // revision history revision statements // module definitions other statements }
submodule示例如下:
注意:
submodule必須通過belongs-to語句使用, submodule只能由belong-to指定的module或這個指定module的其它submodule進行include,其它module(包括submodule)都不能include。同時子模塊不可以import它的父模塊
namespace
module中必須定義所有節點都屬於一個特定的XML命名空間,由一個URI指定命名空間。例如
Import revision
import或include語句包含一個revision-date的子句,所有引入的YANG定義來自要導入或引入的指定revision模塊。通過引入特定的模塊修訂,我們可以獨立發布演變中的模塊。YANG提供了指定的規則,如何發布進化中的模塊並且保持向后的兼容性。比如:
YANG的數據類型
基本數據類型
YANG基本數據類型如下。
類別 |
類型 |
限制 |
Integral |
Integral {u,}int{8,16,32,64} |
range |
Decimals |
decimal64 |
range, fraction-digits |
String |
string |
length,pattern |
Enumeration |
enumeration |
enum |
Bool and Bits |
boolean, bits |
|
Binary |
binary |
length |
References |
leafref |
path |
References |
identityref |
base |
References |
instance-identifier |
|
Other |
union |
|
Other |
empty |
派生類型
YANG采用typedef語句來定義派生類型。例如以下是定義一個派生類型percent,限制類型是內建類型uint8:
1
2
3
4
5
6
7
8
9
10
11
12
|
typedef percent {
type uint8 {
range “0 .. 100” ;
}
}
再如定義一個
ip - address類型,它包含了兩個派生類型的聯合:
typedef ip - address {
type union {
type ipv4 - address ;
type ipv6 - address ;
}
}
|
三、YANG數據節點
leaf
leaf定義的節點只有一個值,是一個葉子節點,只能有一個實例。
例如:
leaf-list
leaf-list定義一組相同類型的葉節節點,類似數組。與leaf區別在於leaf只有一個實例,而leaf-list可以有多個實例。例如:
container
container主要定義一個schema樹的內部節點,它本身沒有任何值和意義,只是作為一系列子節點的父親存在,只有一個實例。例如
list
list描述了一組節點的集合,它像一張數據庫表一樣,表的每一行用key來標識其主鍵,有多個實例。例如
grouping
一個grouping定義一個可以重復使用的節點集合,使用時通過use語句,並可通過refine語句進行改進。例如
使用grouping時,通過use語句,它會將grouping定義的節點復制到當前的schema樹(如果有refine,並進行更新)。
choice
一個choice節點定義了一個可供選擇項的集合,每一個選擇項都會在某種情況下存在。一個choice由許多分枝,通過case子語句定義。比如
anyxml
augment
YANG提供augment語句,擴大一個模塊層次,將節點添加到一個已存在的模塊或子模塊當中。目標結點可以是一個container, list, choice, case, rpc, input, output, notification等。
augment可以是條件的,使用when語句,當特定條件滿足時,新節點才會出現。
notification
notification語句用來定義Notification內容,內容數據的定義同YANG數據定義一樣。下面例子使用上文例子定義的connection。
rpc
rpc語句用來定義NETCONF協議的RPCs,input和output使用YANG數據定義語句。如下例子,建模一個激活軟件圖片的RPC:
作者簡介:鴻哥,碩士研究生,國內某通信設備公司軟件研發工程師,主要從事雲計算、SDN技術開發