FusionSphere北向接口SDK技術(shù)白皮書

1、華為華為 fusionspherefusionsphere北向接口北向接口 sdksdk 技術(shù)白皮書技術(shù)白皮書概述符號約定前言前言本文檔介紹 fusionsphere 產(chǎn)品北向開放接口 sdk 技術(shù)。在本文中可能出現(xiàn)下列標(biāo)志，它們所代表的含義如下。符號說明用于警示緊急的危險情形，若不避免，將會導(dǎo)致人員死亡或嚴重的人身傷害。用于警示潛在的危險情形，若不避免，可能會導(dǎo)致人員死亡或嚴重的人身傷害。用于警示潛在的危險情形，若不避免，可能會導(dǎo)致中度或輕微的人身傷害。用于傳遞設(shè)備或環(huán)境安全警示信息，若不避免，可能會導(dǎo)致設(shè)備損壞、數(shù)據(jù)丟失、設(shè)備性能降低或其它不可預(yù)知的結(jié)果?！白⒁狻辈簧婕叭松韨?。用于突出重

2、要/關(guān)鍵信息、最佳實踐和小竅門等?！罢f明”不是安全警示信息， 不涉及人身、設(shè)備及環(huán)境傷害信息。目錄目錄前言前言. . ii. ii1 1 開放能力總覽開放能力總覽. .4 41.1 文檔介紹. 41.2 整體結(jié)構(gòu). 51.3 配套版本. 52 2 開放集成場景開放集成場景. .6 62.1 被第三方云管理系統(tǒng)集成. 62.1.1 集成場景概述. 62.1.2 典型應(yīng)用場景. 72.2 被第三方備份軟件集成. 172.2.1 集成場景概述. 172.2.2 典型應(yīng)用場景. 182.3 被第三方防病毒軟件等安全產(chǎn)品集成 . 272.3.1 集成場景概述. 27典型應(yīng)用場景 . 282.4 被 cl

3、oudstack 集成 . 292.4.1 集成場景概述. 292.4.2 典型應(yīng)場景. 292.5 命令行運維. 323 3 開放能力清單開放能力清單. .3 33 33.1 fusionmanager 云管理北向接口 sdk. 333.1.1 開放接口清單. 333.2 fusioncompute 云操作系統(tǒng)北向接口 sdk. 383.2.1 開放接口清單. 383.3 fusioncompute 虛擬磁盤管理接口 sdk. 413.3.1 backup&restore 虛擬磁盤管理接口 . 423.3.2 fusioncompute 虛擬機備份相關(guān)接口 sdk . 423.4 f

4、usioncompute 云操作系統(tǒng) powershell 命令行 . 424 4 術(shù)語表術(shù)語表. .4 44 41 11.1 文檔介紹第三方應(yīng)用開放能力總覽開放能力總覽openstack apifusionsphere apifusionsphereopenstack3 資源池rdfusionsphere資源池fusionsphere 解決方案旨在向其用戶提供iaas 層服務(wù)，相應(yīng)的，fusionsphere 對外開放了 iaas 接口供用戶更為靈活的使用iaas 層服務(wù)。目前我們對外提供兩套接口：openstack api：此接口保持和開源openstack 租戶接口完全兼容，以幫助客戶避

5、免廠商鎖定問題。fusionsphere api： fusionsphere 解決方案提供了管理多資源池的能力， 云服務(wù)提供商可以方便的采用多資源池構(gòu)建其服務(wù)。與此同時，為了避免云服務(wù)提供商的（最終） 用戶直接面臨多資源池接口的復(fù)雜性， 我們也提供了 “統(tǒng)一” 的fusionsphere api。此接口對外削弱了資源池特有接口、 參數(shù)的影響， 提供了歸一的 “資源” 操作接口。目前 fusionsphere api按照業(yè)界主流的方式提供了rest 接口供第三方訪問，詳情可參閱版本接口文檔。用戶除了直接使用fusionsphere rest api之外，我們也提供了java/python/c#

6、等多語言 sdk 以供 isv 快速開發(fā)之用。1.2 整體結(jié)構(gòu)1、 fusionspherefusionsphere 開放點全景圖開放點全景圖2 2、開放點：、開放點：1.application software2.virtual appliance3.server4.storage(包含災(zāi)備)5.management6.networking & security1.3 配套版本fusionsphere v100r005c102 22.1 被第三方云管理系統(tǒng)集成2.1.1 集成場景概述開放集成場景開放集成場景隨著企業(yè)信息化建設(shè)的不斷深入進行，信息系統(tǒng)已成為企業(yè)業(yè)務(wù)的重要支撐，信息設(shè)備數(shù)

7、量隨之高速增長，各 it 基礎(chǔ)實施供應(yīng)商提供的資源和服務(wù)也各異。在資源利用和管控方面出現(xiàn)了服務(wù)器資源整體利用效率不高、缺乏資源使用統(tǒng)一管控、硬件資源投資缺乏量化決策依據(jù)等問題。利用云計算技術(shù)實現(xiàn)數(shù)據(jù)中心資源集約化管理、統(tǒng)一使用和動態(tài)調(diào)配，降低運行成本，提高資源利用率，有必要建設(shè)信息系統(tǒng)統(tǒng)一資源池，從而實現(xiàn)信息系統(tǒng)硬件資源統(tǒng)一管理、精確量化、共享利用、按需分配、動態(tài)調(diào)度能力，充分發(fā)揮設(shè)備效率、降低運營成本和能耗。fusioncompute 是云操作系統(tǒng)軟件，主要由虛擬化基礎(chǔ)平臺和云基礎(chǔ)服務(wù)平臺組成，主要負責(zé)硬件資源的虛擬化，以及對虛擬資源、業(yè)務(wù)資源、用戶資源的集中管理。它采用虛擬計算、 虛擬存儲

8、、 虛擬網(wǎng)絡(luò)等技術(shù)， 完成計算資源、 存儲資源、 網(wǎng)絡(luò)資源的虛擬化。同時通過統(tǒng)一的接口， 對這些虛擬資源進行集中調(diào)度和管理， 從而降低業(yè)務(wù)的運行成本，保證系統(tǒng)的安全性和可靠性，協(xié)助運營商和企業(yè)構(gòu)筑安全、綠色、節(jié)能的云數(shù)據(jù)中心能力。sdk 向第三方業(yè)務(wù)系統(tǒng)開放華為云操作系統(tǒng)的部分功能， 降低業(yè)務(wù)定制開發(fā)難度， 提高產(chǎn)品快速被集成能力。目前提供java/python/c#多語言 sdk 包，主要提供虛擬機管理、虛擬存儲管理、虛擬網(wǎng)絡(luò)管理、虛擬資源監(jiān)控等管理接口。2.1.2 典型應(yīng)用場景虛擬機管理場景虛擬機管理業(yè)務(wù)場景是基于項目實施過程中，已在fusioncompute 的管理 portal 完成了

9、初始化的操作。創(chuàng)建虛擬機虛擬機管理頂層包:管理員模板管理虛擬機管理包括創(chuàng)建虛擬機、虛擬機管理、模板管理三個主要的應(yīng)用場景。其中創(chuàng)建虛擬機又分為直接創(chuàng)建虛擬機和根據(jù)模板創(chuàng)建虛擬機； 虛擬機管理包括重啟、 暫停、 恢復(fù)、遷移、 掛載卷、 添加網(wǎng)關(guān)等場景； 模板管理包括了導(dǎo)入導(dǎo)出模板、 自定義虛擬機配置等。如下主要說明虛擬機創(chuàng)建。1、創(chuàng)建虛擬機場景查詢站點下集群在集群或主機上創(chuàng)建虛擬機查詢集群下主機查看創(chuàng)建虛擬機進度判斷是基于卷還是基于數(shù)據(jù)存儲創(chuàng)建基于數(shù)據(jù)存儲虛擬機基于卷掛載光驅(qū)查詢主機下數(shù)據(jù)存儲創(chuàng)建卷（見卷創(chuàng)建場景）安裝操作系統(tǒng)查詢主機下虛擬交換機重啟虛擬機查詢虛擬交換機下端口組掛載tools流程

10、說明流程說明步驟 1：查詢站點下的集群信息，調(diào)用clustermanager 類的 queryclusters 方法步驟 2：根據(jù)步驟 1 返回的集群標(biāo)識查詢集群下的主機，調(diào)用hostmanager 的queryhostlist 方法步驟 3：判斷基于數(shù)據(jù)存儲還是基于卷創(chuàng)建虛擬機。如果是基于數(shù)據(jù)存儲，根據(jù)步驟2返回的主機標(biāo)識查詢主機下的數(shù)據(jù)存儲，調(diào)用datastoragemanager的 querydatastores方法；否則要先創(chuàng)建卷，創(chuàng)建卷的流程見3.3 章節(jié)。步驟 4：根據(jù)步驟 2 返回的主機標(biāo)識查詢主機下的虛擬交換機，調(diào)用dvswitchmanager的 queryalldvswit

11、chs 方法步驟 5：根據(jù)步驟 4 返回的虛擬交換機標(biāo)識查詢端口組，調(diào)用portgroupmanager 的queryalldvsportgroups方法步驟 5：在集群或主機創(chuàng)建虛擬機，調(diào)用vmmanager 類的 createvm 方法。步驟 6：根據(jù)步驟 5 返回的任務(wù)標(biāo)識查看虛擬機創(chuàng)建的進度，調(diào)用taskmanager 類的querytask 方法步驟 7：在步驟 5 中，如果參數(shù)中選擇了自動啟動虛擬機，則創(chuàng)建完成后虛擬機會自動啟動，無需調(diào)用接口，否則調(diào)用vmmanager 類的 startvm 方法步驟 8：虛擬機創(chuàng)建完成后， 掛載虛擬機光驅(qū)， 用于遠程掛載 iso 文件，安裝操作系

12、統(tǒng)，調(diào)用 vmmanager 類的 attachcdrom 方法。步驟 9：虛擬機創(chuàng)建完成后， 掛載虛擬機光驅(qū)， 用于遠程掛載 iso 文件，安裝操作系統(tǒng)，調(diào)用 vmmanager 類的 attachcdrom 方法。步驟 10：掛載虛擬機光驅(qū)后，調(diào)用vmmanager 類的 rebootvm 方法重啟虛擬機。步驟 11：重啟后按操作系統(tǒng)的指示安裝操作系統(tǒng)，安裝完成后調(diào)用vmmanager 類的installtools 方法掛載 tools。至此虛擬機的創(chuàng)建步驟完成。2、模板創(chuàng)建虛擬機場景導(dǎo)入模板判斷是要創(chuàng)建和模板一樣的虛擬機n自定義虛擬機配置y判斷是否需要虛擬機的指定集群或主機y查詢主機或集

13、群nn根據(jù)模板創(chuàng)建虛擬機流程說明流程說明步驟 1： 導(dǎo)入文件模板， 用于創(chuàng)建虛擬機， 調(diào)用 vmmanager 類的 importtemplate 方法。步驟 2：判斷是否要創(chuàng)建和模板一樣的虛擬機還是需要自定義一些虛擬機參數(shù)，如果需要自定義虛擬機參數(shù)，則創(chuàng)建自定義的虛擬機配置，調(diào)用vmmanager 類的createvmcustomization方法，否則跳過本步驟。步驟 3：根據(jù)模板創(chuàng)建虛擬機時默認同原模板的集群或主機。若要指定集群或主機，則需要查詢主機或集群。 查詢站點下的集群信息， 調(diào)用 clustermanager 類的 queryclusters方法；根據(jù)返回的集群標(biāo)識查詢集群下的主

14、機，調(diào)用hostmanager 的 queryhostlist 方法。步驟 4： 根據(jù)模板 （配置、 集群或主機） 創(chuàng)建虛擬機， 調(diào)用 vmmanager 類的 vmclonetemp方法備注：1.以上三個步驟是完整的根據(jù)模板生成虛擬機的流程，其中步驟2 是可選步驟，不執(zhí)行步驟 2，則在部署虛擬機時采用模板默認的配置。還可以直接執(zhí)行步驟3，虛擬機克隆為虛擬機。虛擬存儲管理場景查詢存儲設(shè)備數(shù)據(jù)存儲創(chuàng)建數(shù)據(jù)存儲查詢數(shù)據(jù)存儲頂層包:管理員創(chuàng)建/修改卷卷管理刪除卷查詢卷掛載卷存儲設(shè)備：表示存儲資源中的管理單元，類似lun、 advanced san 存儲池、nas 共享目錄等。數(shù)據(jù)存儲：表示系統(tǒng)中可管

15、理、操作的存儲邏輯單元，一個數(shù)據(jù)存儲和一個存儲設(shè)備對應(yīng)；數(shù)據(jù)存儲承載了具體的虛擬機業(yè)務(wù)，例如創(chuàng)建磁盤等。卷：虛擬機上的邏輯磁盤分區(qū)。運營人員在存儲管理中，可以查看指定主機的存儲設(shè)備；基于存儲設(shè)備創(chuàng)建數(shù)據(jù)存儲，查詢已創(chuàng)建的數(shù)據(jù)存儲；基于數(shù)據(jù)存儲可以創(chuàng)建卷、查詢、修改、刪除已創(chuàng)建的卷，并掛載卷至已創(chuàng)建的虛擬機下。下面是虛擬存儲管理的完整流程說明。1、虛擬存儲管理應(yīng)用場景查詢站點下集群信息查詢集群下主機信息n數(shù)據(jù)存儲是否已創(chuàng)建y查詢主機下存儲設(shè)備查詢主機下數(shù)據(jù)存儲在存儲設(shè)備上創(chuàng)建數(shù)據(jù)存儲在數(shù)據(jù)存儲上創(chuàng)建卷根據(jù)主機或集群查詢虛擬機掛載卷至虛擬機場景說明場景說明步驟 1：查詢站點下的集群信息，調(diào)用clu

16、stermanager 類的 queryclusters 方法。步驟 2：根據(jù)步驟 1 返回的集群標(biāo)識查詢集群下的主機，調(diào)用hostmanager 的queryhostlist 方法。步驟 3：判斷是否已經(jīng)創(chuàng)建數(shù)據(jù)存儲，如果沒有，則根據(jù)主機標(biāo)識查詢和主機關(guān)聯(lián)的存儲設(shè)備，調(diào)用 storageunitmanager 類的 querystorageunit方法；如果已經(jīng)創(chuàng)建， 則查詢主機下的數(shù)據(jù)存儲，調(diào)用storageunitmanager 類的 querydatastores 方法，并跳過步驟4。步驟 4：在步驟 3 查詢得到存儲設(shè)備上創(chuàng)建數(shù)據(jù)存儲，調(diào)用datastoragemanager 類的c

17、reatedatastore 方法。步驟 5：在步驟 4 創(chuàng)建的數(shù)據(jù)存儲上創(chuàng)建卷，調(diào)用volumemanager 類的 createvolume的方法。步驟 6：根據(jù)主機標(biāo)識查詢虛擬機，調(diào)用vmmanager 類的 queryvm 的方法。步驟 7：掛載卷至虛擬機，調(diào)用vmmanager 類的 attachvolume 的方法。虛擬網(wǎng)絡(luò)管理場景u uc use case modelc use case model物理網(wǎng)絡(luò)平面管理物理網(wǎng)絡(luò)平面管理創(chuàng)建創(chuàng)建 dvswitchdvswitch添加上行鏈路添加上行鏈路增加網(wǎng)絡(luò)增加網(wǎng)絡(luò) vlanvlandvswitchdvswitch 管理管理增加網(wǎng)絡(luò)增

18、加網(wǎng)絡(luò) vxlanvxlan更新更新 vxlanvxlanvtepvtep系統(tǒng)管理員系統(tǒng)管理員查詢查詢 portgroupportgroupportgroupportgroup管理管理創(chuàng)建創(chuàng)建 portgroupportgroup刪除刪除 portgroupportgroup查詢查詢 vspvspvspvsp 管理管理配置配置 ipip和和macmac1 1、物理網(wǎng)絡(luò)平面管理、物理網(wǎng)絡(luò)平面管理物理網(wǎng)絡(luò)平面承載業(yè)務(wù)相關(guān)的虛擬網(wǎng)絡(luò)，不同的虛擬網(wǎng)絡(luò)需要選擇創(chuàng)建在不同的物理網(wǎng)絡(luò)平面。物理網(wǎng)絡(luò)平面的管理主要指計算/網(wǎng)絡(luò)節(jié)點物理網(wǎng)絡(luò)接口的管理 （對應(yīng)到虛擬交換機或分布式虛擬交換機的端口管理） 。物理網(wǎng)絡(luò)接

19、口管理，需要解決“依據(jù)業(yè)務(wù)的物理網(wǎng)絡(luò)拓撲連接”與“租戶邏輯網(wǎng)絡(luò)”的承載關(guān)系映射，即 i 層物理網(wǎng)絡(luò)管理需要理解物理網(wǎng)絡(luò)連接平面拓撲，來建立物理網(wǎng)絡(luò)到業(yè)務(wù)承載網(wǎng)絡(luò)的映射管理。物理網(wǎng)絡(luò)配置管理主要由系統(tǒng)管理員在開局時在fusionsphere 平臺上進行配置，暫不對外開放創(chuàng)建物理網(wǎng)絡(luò)等接口。物理網(wǎng)絡(luò)接口管理主要場景描述：1）業(yè)務(wù)管理員根據(jù)云平臺層的部署和業(yè)務(wù)規(guī)劃，通過fusionsphere 平臺創(chuàng)建物理網(wǎng)絡(luò)（physicalnetwork） 。業(yè)務(wù)管理員根據(jù)業(yè)務(wù)需求所創(chuàng)建的虛擬網(wǎng)絡(luò)，需要指定具體的物理網(wǎng)絡(luò)來承載；2）業(yè)務(wù)管理員添加物理網(wǎng)絡(luò)接口（uplink 口）到指定的物理網(wǎng)絡(luò)（physical

20、 network）中，主機完成物理網(wǎng)絡(luò)與外部物理網(wǎng)絡(luò)的互聯(lián)。至此，虛擬網(wǎng)絡(luò)創(chuàng)建以后，可直接打通與其他主機或物理網(wǎng)絡(luò)設(shè)備虛擬網(wǎng)絡(luò)的連接。2 2、分布式虛擬交換機（、分布式虛擬交換機（dvswitchdvswitch）管理）管理dvs 服務(wù)向系統(tǒng)管理員提供分布式虛擬交換管理， 實現(xiàn)網(wǎng)絡(luò)資源的規(guī)劃和維護。 系統(tǒng)管理員通過創(chuàng)建dvs，規(guī)劃主機節(jié)點的物理端口（uplinkport）或物理端口聚合組（uplinkportaggr）在不同的分布式虛擬交換平面，實現(xiàn)跨物理主機的物理網(wǎng)絡(luò)通信平面的管理。同時，dvs 需要實現(xiàn)對系統(tǒng)接口（systemintf）的管理，包含接口的 ip 地址、路由信息、vlan 等

21、相關(guān)配置。3 3、分布式虛擬交換端口組（、分布式虛擬交換端口組（portgroupportgroup）管理）管理分布式虛擬端口組是分布式虛擬交換機虛擬端口的集合。連接在同一端口組的虛擬機網(wǎng)卡，具有相同的網(wǎng)絡(luò)屬性（如：帶寬限速、vlan/subnet、dhcp 隔離、ip 和 mac 綁定等） 。管理員可以通過對端口組的集中管理和配置，簡化對虛擬機端口屬性的設(shè)置。4 4、虛擬交換端口（、虛擬交換端口（vspvsp）管理）管理虛擬交換機提供基本的虛擬機交換機能力，為fusioncompute 的網(wǎng)絡(luò)模塊提供新的虛擬交換模式，具備 vlan、dhcp 隔離、帶寬限速及優(yōu)先級設(shè)置的基本功能，同時，有良

22、好的功能擴展性。虛擬交換機作為主機上的虛擬交換，部署在主機上。主機節(jié)點的系統(tǒng)接口（hnic）及虛擬機的虛擬網(wǎng)卡（vnic）分別于虛擬交換機的虛擬端口連接，通過虛擬交換機實現(xiàn)與外部網(wǎng)絡(luò)的數(shù)據(jù)傳輸。虛擬交換機使用主機節(jié)點的物理網(wǎng)卡作為虛擬網(wǎng)絡(luò)總的出口。每個虛擬交換機具有多個虛擬端口， 每個虛擬端口具有各自的屬性 （帶寬 qos、 2 層安全屬性、 vlan等） ?？筛鶕?jù)端口查詢網(wǎng)絡(luò)中有多少虛擬機，配置vm 網(wǎng)卡 ip 和 mac 地址綁定。虛擬網(wǎng)絡(luò)管理業(yè)務(wù)場景：虛擬網(wǎng)絡(luò)管理業(yè)務(wù)場景：虛擬網(wǎng)絡(luò)管理提供創(chuàng)建分布式交換機和端口組等網(wǎng)絡(luò)資源的功能，支持對網(wǎng)絡(luò)資源進行調(diào)整和配置。物理網(wǎng)絡(luò)管理是否已有可用分布

23、式虛擬交換機否是創(chuàng)建分布式虛擬交換機添加上行鏈路添加vlan池（可選）添加子網(wǎng)（可選）配置vtep（可選）創(chuàng)建端口組流程說明流程說明步驟步驟 1 1、創(chuàng)建分布式虛擬交換機、創(chuàng)建分布式虛擬交換機：分布式交換機的功能類似于普通的物理交換機，每臺主機都連接到分布式交換機中。分布式交換機的一端是與虛擬機相連的虛擬端口，另一端是與虛擬機所在主機上的物理以太網(wǎng)適配器相連的上行鏈路。 通過它可以連接主機和虛擬機，實現(xiàn)系統(tǒng)網(wǎng)絡(luò)互通。調(diào)用“創(chuàng)建 dvswitch”接口。步驟步驟 2 2、添加上行鏈路、添加上行鏈路：在已創(chuàng)建的分布式交換機中添加上行鏈路，為虛擬機提供網(wǎng)絡(luò)資源。上行鏈路為服務(wù)器的物理網(wǎng)口，可在添加之前對其進行端口綁定（主備或負荷分擔(dān)） 。上行鏈路的添加需要根據(jù)所在節(jié)點上vm 的需要靈活配置。一般的，上行鏈路可分為管理，存儲和業(yè)務(wù)三個平面。調(diào)用“增加 dvswitch 服務(wù)器”接口。步驟步驟 3 3、配置、配置 vlanvlan 池池：按照規(guī)劃添加 vlan 池，為創(chuàng)建端口組提供vlan 資源。當(dāng)端口組選擇連接方式為vlan 池，需要用戶手動配置vm 的 ip 地址。調(diào)用“增加dvswitch 的 vlans”接口。步驟步驟 4 4、配置子網(wǎng)配置子網(wǎng)