目  錄

1 Chef

1.1 Chef簡介

1.1.1 Chef網絡架構

1.1.2 Chef資源

1.1.3 Chef配置文件

1.2 Chef配置限製和指導

1.3 Chef配置準備

1.4 啟動Chef

1.4.1 配置Chef server

1.4.2 配置Workstation

1.4.3 配置Chef client

1.5 關閉Chef

1.6 Chef典型配置舉例

1.6.1 Chef基本組網配置舉例

2 Chef資源列表

2.1 netdev_device

2.2 netdev_interface

2.3 netdev_l2_interface

2.4 netdev_lagg

2.5 netdev_vlan

2.6 netdev_vsi

2.7 netdev_vte

2.8 netdev_vxlan

1 Chef

1.1  Chef簡介

Chef是開源的配置管理工具，用戶使用Ruby語言將需要對設備進行的配置寫成腳本，並保存到服務器中，再通過服務器把配置腳本下發到各網絡設備，實現對網絡設備的集中配置管理。

1.1.1  Chef網絡架構

圖1-1 Chef網絡架構

如圖1-1所示，Chef采用“服務器端/客戶端”網絡架構，由Chef server、Chef client和Workstation構成。

1. Chef server

Chef server用於對Chef client進行集中管理，其主要功能如下：

·     集中保存配置腳本（Cookbook），並根據用戶要求將配置腳本下發到Chef client。

·     為Chef client和Workstation分別創建後綴為.pem的密鑰文件。密鑰文件分為用戶密鑰文件和組織密鑰文件：

¡     用戶密鑰文件：該文件用來保存Chef client/Workstation的用戶認證信息，Chef client/Workstation與Chef server進行通信前，用戶需要將該文件分別下載到Chef client/Workstation上，Chef server使用該文件驗證Chef client/Workstation的合法性。

¡     組織密鑰文件：該文件用來保存用戶所在組織的認證信息。用戶需要將該文件分別下載到Chef client/Workstation中。為方便對不同的Chef client/Workstation設備進行區分管理，可以將具有同一類屬性的Chef client/Workstation劃分到同一個組織中。Chef client/Workstation與Chef server進行通信前，Chef server使用該文件驗證用戶所在組織的合法性。

關於Chef server的詳細安裝和配置，請參見Chef官方網站：https://www.chef.io。

2. Workstation

Workstation提供了用戶與Chef server交互的接口。用戶需要在Workstation上創建、編輯配置腳本，並將配置腳本上傳到Chef server。

Workstation可以與Chef server安裝在同一台服務器上。

關於Workstation的詳細安裝和配置，請參見Chef官方網站：https://www.chef.io。

3. Chef client

Chef client即為被Chef server管理的網絡設備。Chef client從Chef server獲取並運行配置腳本，配置腳本運行完成後，設備使用新下發的配置運行。

Chef以Chef client方式運行，版本為12.3.0。

1.1.2  Chef資源

Chef使用Ruby語言定義配置項，各配置項的集合即為一個配置腳本，在Chef中，配置項叫做資源。

Chef劃分了多個不同類型的資源，每個類型的資源都由名稱、屬性和動作構成，每個屬性對應功能的一個配置，屬性值即為該配置應達到的狀態。在對Chef資源進行配置時，通過為不同屬性賦值，從而指定設備應該達到的最終狀態，而不需要關心如何達到這些狀態。例如：用戶隻需要指定創建哪一個VLAN，而不需要關心如何創建該VLAN。如下以創建VLAN 2，並為該VLAN配置描述信息為例介紹Chef資源的構成：

netdev_vlan 'vlan2' do

 vlan_id 2

 description 'chef-vlan2'

 action :create

end

在該例中，各字段含義如下：

·     netdev_vlan表示資源類型。

·     do與end為Ruby語言中函數的固定語法，所有Chef資源配置都需要符合該語法要求。

·     vlan2為資源名稱，每個資源都有唯一的資源名稱，用於標識該資源。

·     vlan_id和description表示資源屬性。

¡     vlan_id 2表示創建VLAN ID為2的VLAN。

¡     description 'chef-vlan2'表示VLAN2的描述信息為“chef-vlan2”。

·     action表示資源動作，Chef僅支持create和delete兩種動作。

¡     create表示如果該Chef資源不存在，則創建這個資源；如果該Chef資源已存在，則按照最新資源配置要求修改該資源。create為Chef資源的缺省動作，如果配置Chef資源時，不指定action，則表示action取值為create。

¡     delete表示需要刪除該資源。

關於Chef支持的所有資源類型，請參見2 Chef資源列表。

1.1.3  Chef配置文件

Chef配置文件由用戶手工配置，該文件中包含了Chef client執行Chef時輸出日誌的屬性、Chef server和Chef client本地保存密鑰文件的路徑，以及Chef client本地保存資源文件的路徑等。

啟動Chef後，Chef client使用Chef配置文件中指定的本地密鑰文件信息向Chef server發起認證請求。Chef server使用本地密鑰文件與Chef client發送的密鑰信息對比，如果雙方密鑰信息完全一致，則表示Chef client通過認證。Chef client通過認證後將把資源文件下載到Chef配置文件指定的本地資源文件保存路徑中，並執行資源文件中的配置，同時輸出相應的日誌。

表1-1 Chef配置文件配置項描述表

1.2  Chef配置限製和指導

Chef server的Chef版本不能低於Chef client的Chef版本。

1.3  Chef配置準備

配置Chef功能前，用戶必須先配置如下功能：

·     開啟NETCONF over SSH功能：Chef server通過NETCONF over SSH方式向Chef client下發配置。關於NETCONF over SSH功能的詳細配置請參見“網絡管理和監控配置指導”中的“NETCONF”。

·     配置設備可以通過SSH登錄：Chef server與Chef client使用SSH進行通信。關於SSH登錄功能的詳細配置請參見“基礎配置指導”中的“登錄設備”。

1.4  啟動Chef

1.4.1  配置Chef server

(1)     為Workstation和Chef client分別創建密鑰文件。

(2)     創建並編輯Chef client的Chef配置文件。

關於Chef server的詳細配置方法，具體請參見Chef server的安裝和使用指導。

1.4.2  配置Workstation

(1)     創建Workstation的本地工作目錄。

(2)     創建保存Workstation Chef配置文件的目錄

(3)     創建Workstation的Chef配置文件。

(4)     將Workstation的密鑰文件從Chef server上下載到Workstation配置文件中指定的目錄。

(5)     創建並編輯Chef資源文件。

(6)     將資源文件上傳到Chef server。

關於Workstation的詳細配置方法，具體請參見Workstation的安裝和使用指導。

1.4.3  配置Chef client

(1)     將Chef client的密鑰文件從Chef server上下載到設備的本地目錄。

設備本地保存密鑰文件的目錄必須與Chef配置文件中配置的目錄相同。

(2)     將Chef配置文件從Chef server上下載到Chef client的本地目錄。

設備本地保存Chef配置文件的目錄必須與third-part-process start命令--config參數指定的目錄相同。

(3)     啟動Chef。

a.     進入係統視圖。

system-view

b.     啟動Chef。

third-part-process start name chef-client arg --config=filepath --runlist recipe[Directory]

缺省情況下，Chef處於關閉狀態。

關於third-part-process start命令的詳細介紹，請參見“網絡管理和監控”中的“進程監控和維護”。

1.5  關閉Chef

1. 配置準備

執行display process all命令查看所有進程信息，“THIRD”字段標識為“Y”的進程為第三方進程，“PID”字段即為進程pid。“COMMAND”字段為“chef-client /opt/ruby/b”的進程為Chef進程。

2. 配置步驟

(1)     進入係統視圖。

system-view

(2)     關閉Chef。

third-part-process stop pid pid-list

關於third-part-process stop命令的詳細介紹，請參見“網絡管理和監控”中的“進程監控和維護”。

1.6  Chef典型配置舉例

1.6.1  Chef基本組網配置舉例

1. 組網需求

Chef client與Chef server相連，設備的IP地址和掩碼如圖1-2所示。

通過Chef在設備上創建ID為3的VLAN。

2. 組網圖

圖1-2 Chef配置組網圖

3. 配置步驟

(1)     配置Chef server

# 創建Workstation的用戶密鑰文件admin.pem，具體參數如下：

¡     Workstation的用戶名為Herbert George Wells。

¡     Email為[email protected]。

¡     密碼為123456。

$ chef-server-ctl user-create Herbert George Wells [email protected] 123456 –filename=/etc/chef/admin.pem

# 創建Workstation的組織密鑰文件admin_org.pem，具體參數如下：

¡     組織的簡稱為ABC，組織全稱為ABC Technologies Co., Limited。

¡     該組織與用戶Herbert相關聯。

$ chef-server-ctl org-create ABC_org "ABC Technologies Co., Limited" –association_user Herbert –filename =/etc/chef/admin_org.pem

# 創建Chef client的用戶密鑰文件client.pem，具體參數如下：

¡     Chef client用戶名為Herbert George Wells。

¡     Email為[email protected]。

¡     密碼為123456。

$ chef-server-ctl user-create Herbert George Wells [email protected] 123456 –filename=/etc/chef/client.pem

# 創建Chef client的組織密鑰文件validator.pem，具體參數如下：

¡     組織的簡稱為ABC，組織全稱為ABC Technologies Co., Limited。

¡     該組織與用戶Herbert相關聯。

$ chef-server-ctl org-create ABC "ABC Technologies Co., Limited" –association_user Herbert –filename =/etc/chef/validator.pem

# 創建並編輯Chef client的Chef配置文件chefclient.rb。

log_level :info

log_location STDOUT

node_name 'Herbert'

chef_server_url 'https://1.1.1.2:443/organizations/abc'

validation_key 'flash:/chef/validator.pem'

client_key 'flash:/chef/client.pem'

cookbook_path [ 'flash:/chef-repo/cookbooks' ]

(2)     配置Workstation

# 創建Workstation的本地工作目錄chef-repo。

$ mkdir /chef-repo

# 創建保存Workstation Chef配置文件的目錄.chef。

$ mkdir –p /chef-repo/.chef

# 在/chef-repo/.chef目錄下創建Workstation的Chef配置文件knife.rb，內容如下：

log_level                :info

log_location             STDOUT

node_name                'admin'

client_key               '/root/chef-repo/.chef/admin.pem'

validation_key           '/root/chef-repo/.chef/admin_org.pem'

chef_server_url          'https://chef-server:443/organizations/abc'

使用TFTP或FTP將Workstation的密鑰文件從Chef server下載到Workstation配置文件中的/chef-repo/.chef目錄。

# 執行如下命令，創建名為“netdev”的資源目錄。

$ knife cookbook create netdev

該命令執行成功後，將在當前目錄下創建netdev資源目錄，並在netdev資源目錄下生成多個與該資源目錄相關的文件和目錄，其中，recipes目錄即為保存資源文件的目錄。

編輯recipes目錄下名稱為default.rb的資源文件，內容如下：

netdev_vlan 'vlan3' do

 vlan_id 3

 action :create

end

# 執行如下命令，將資源文件上傳到Chef server。

$ knife cookbook upload –all

(3)     配置Chef client

在Chef client上配置設備通過SSH登錄，並開啟NETCONF over SSH功能。

使用TFTP或FTP將Chef配置文件chefclient.rb從Chef server上下載到Chef client的Flash根目錄（該文件的保存目錄必須與third-part-process start命令--config參數指定的目錄相同）。

使用TFTP或FTP將密鑰文件validator.pem和client.pem從Chef server上下載到設備的指定目錄。本例中，目錄為flash:/chef/。

# 在設備上啟動Chef，指定設備中Chef配置文件的路徑為Flash的根目錄，文件名稱為chefclient.rb。資源名稱為netdev。

<ChefClient> system-view

[ChefClient] third-part-process start name chef-client arg --config=flash:/chefclient.rb --runlist recipe[netdev]

該命令執行成功後，Chef client將獲取Chef server中的資源到本地，並運行該資源，實現對設備各功能的配置。

2 Chef資源列表

2.1  netdev_device

該資源用來配置設備的名稱，並指定設備與Chef server建立連接時使用的SSH用戶名和密碼。

1. 資源屬性

表2-1 netdev_device資源屬性描述表

2. 腳本示例

配置設備名稱為ChefClient，並指定設備與Chef server建立連接時使用的SSH用戶名為user，SSH用戶密碼為123456。

netdev_device 'device' do

 hostname "ChefClient"

 user "user"

 passwd "123456"

end

2.2  netdev_interface

該資源用來配置接口的屬性。

1. 資源屬性

表2-2 netdev_interfac資源屬性描述表

2. 腳本示例

配置索引為2的以太網接口的如下屬性：

·     接口的描述信息為ifindex2。

·     管理狀態為開啟。

·     接口速率為自動協商。

·     接口與對端接口的雙工模式為自動協商。

·     端口的鏈路類型為Hybrid類型。

·     以太網接口工作在二層模式。

·     配置三層以太網接口允許通過的MTU的大小為1500。

netdev_interface 'ifindex2' do

 ifindex 2

 description 'ifindex2'

 admin 'up'

 speed 'auto'

 duplex 'auto'

 linktype 'hybrid'

 portlayer 'bridge'

 mtu 1500

end

2.3  netdev_l2_interface

該資源用來配置二層以太網接口的VLAN屬性。

1. 資源屬性

表2-3 netdev_l2_interface資源屬性描述表

2. 腳本示例

修改索引為5的接口的缺省VLAN為2，允許ID為2～6的VLAN通過，ID為2、4、5、6的VLAN需要保留tag，ID為3的VLAN不帶tag。

netdev_l2_interface 'ifindex5' do

 ifindex 5

 pvid 2

 permit_vlan_list '2-6'

 tagged_vlan_list '2,4-6'

 untagged_vlan_list '3'

end

2.4  netdev_lagg

該資源用來創建、修改或刪除聚合組。

1. 資源屬性

表2-4 netdev_lagg資源屬性描述表

2. 腳本示例

創建ID為16386的聚合組，設置聚合組的模式為static，並將接口1、2、3加入聚合組，從聚合組中刪除索引為8的接口。

netdev_lag 'lagg16386' do

 group_id 16386

 linkmode 'static'

 addports '1-3'

 deleteports '8'

end

2.5  netdev_vlan

該資源用來創建、修改或刪除VLAN，並配置VLAN的名稱和描述信息。

1. 資源屬性

表2-5 netdev_vlan資源屬性描述表

2. 腳本示例

創建VLAN2，並配置VLAN描述和VLAN名稱為“vlan2”。

netdev_vlan 'vlan2' do

 vlan_id 2

 description 'vlan2'

 vlan_name ‘vlan2’

end

2.6  netdev_vsi

該資源用來創建、修改或刪除VSI。

1. 資源屬性

表2-6 netdev_vsi資源屬性描述表

2. 腳本示例

在設備上創建名為vsia的VSI，並設置為開啟狀態。

netdev_vsi 'vsia' do

 vsiname 'vsia'

 admin 'up'

end

2.7  netdev_vte

該資源用來創建或刪除隧道。

1. 資源屬性

表2-7 netdev_vte資源屬性描述表

2. 腳本示例

創建ID為2、基於UDP passenger協議和IPv4傳輸協議的VXLAN隧道。

netdev_vte 'vte2' do

 vte_id 2

 mode 24

end

2.8  netdev_vxlan

該資源用來創建、修改或刪除VXLAN。

1. 資源屬性

表2-8 netdev_vxlan資源屬性描述表

2. 腳本示例

創建ID為10的VXLAN，加入名為vsia的VSI，並將隧道接口2、4加入VXLAN，從VXLAN中刪除1、3隧道接口。

netdev_vxlan 'vxlan10' do

 vxlan_id 10

 visname 'vsia'

 add_tunnels '2,4'

 delete_tunnels '1,3'

end