一、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模塊有如下的布局:
submodule
submodule是部分模塊定義,用於對模塊提供支持。
submodule文件內容布局如下:
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基本數據類型如下。
更加詳細的描述請參看rfc6020協議,例如
派生類型
YANG采用typedef語句來定義派生類型。例如以下是定義一個派生類型percent,限制類型是內建類型uint8:
三、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
anyxml表示任何未知的數據定義。
augment
YANG提供augment語句,擴大一個模塊層次,將節點添加到一個已存在的模塊或子模塊當中。目標結點可以是一個container, list, choice, case, rpc, input, output, notification等。
augment可以是條件的,使用when,www.sangpi.com語句,當特定條件滿足時,新節點才會出現。
notification
notification語句用來定義Notification內容,內容數據的定義同YANG數據定義一樣。下面例子使用上文例子定義的connection。
rpc
rpc語句用來定義NETCONF協議的RPCs,input和output使用YANG數據定義語句。如下例子,建模一個激活軟件圖片的RPC: