Cloud Foundry Service Broker開發部署實例解析(上)
Cloud Foundry(CF)通過buildpack擴展運行不同語言應用的能力,通過service broker(SB)擴展支持應用所需的各種關系數據庫、中間件、緩存、云存儲、內存數據庫等各種服務的能力。這篇博文將從頭至尾介紹通用的SB開發和部署。
什么是service broker
SB就是實現了CF規定的一組rest api的服務端程序,它作用于CF與服務的資源池中間,CF通過調用SB上這些規定的rest api對服務資源池進行管理,而SB實際執行這些資源池管理操作。比如,對于oracle而言,管理意味著管理服務計劃(即create/drop profile)、創建/綁定/解綁/刪除服務實例(即create tablespace、create user、drop user、drop tablespace)。下面給出SB需要實現rest api列表,理論上有了這張表,隨便用什么語言寫個web service的服務端就行了,這些接口中有幾個是博主為實現本文的開發和部署過程自行添加的。
METHODURL用途
開發
本文給出的SB使用java(spring)開發的,使用了hibernate,基本思路是下載源代碼,按照下面的描述修改必要的實現,然后打包就可以開始部署了。這一SB的基本思路是將已有的資源池的授權信息存儲到SB中,不自動化的做任何部署和管理工作,所以理論上,這個SB是用于任何服務的管理。
準備
首先下載源代碼,這代碼是個gradle工程,首先得準備好開發環境,不管用原生eclipse還是sts,都得先安裝gradle support,以STS為例,下載解壓后,打開集成開發環境,在dashborad-》IDE EXTENSIONS中,搜索gradle support并安裝。將源代碼解壓,在STS的package explorer中import gradle project,選擇到解壓的目錄,build model,然后點擊finish。
修改源代碼
- src/main/resources/ServiceDescription.json
這個文件是json格式服務的描述信息,程序***運行時,會將此json作為創建新服務的輸入
- name:服務的唯一標識
- description:顯示在UI里的描述信息
- bindable:true
- tags:關鍵字
- longDescription:顯示在UI里的詳細描述信息
- imageUrl:顯示在GUI里的圖片地址
- displayName:顯示在GUI里的服務名稱
- providerDisplayName:顯示在GUI里的服務供應商名稱
- documentationUrl:顯示在GUI里的服務文檔地址
- supportUrl:顯示在GUI里的服務支持網站
- src/main/java/com/pivotal/cf/broker/config/AppConfig.java和RelationalCloudDataSourceConfig.java
將這兩個文件中的mdsbrokerdb修改為下一步部署在CF上時綁定的MySQL服務實例名稱,比如samplebrokerdb
- src/main/java/com/pivotal/cf/broker/model/PlanMetadataRes.java
將下面的屬性替換為管理的資源所需的授權信息,當然也要修改屬性對應的setter和getter
- @JsonProperty("kcxpaddr")
- private String kcxpaddr;
- @JsonProperty("kcxpport")
- private String kcxpport;
- @JsonProperty("rvipaddr")
- private String rvipaddr;
- @JsonProperty("rvport")
- private String rvport;
- @JsonProperty("username")
- private String username;
- @JsonProperty("password")
- private String password;1234567891011121314151617
- src/main/java/com/pivotal/cf/broker/model/ServiceInstance.java
將下面的屬性替換為管理的資源所需的授權信息,當然也要修改對應的構造函數
- @JsonSerialize
- @JsonProperty("kcxpaddr")
- @Column(name="kcxpaddr")
- private String kcxpaddr;
- @JsonSerialize
- @JsonProperty("kcxpport")
- @Column(name="kcxpport")
- private String kcxpport;
- @JsonSerialize
- @JsonProperty("rvipaddr")
- @Column(name="rvipaddr")
- private String rvipaddr;
- @JsonSerialize
- @JsonProperty("rvport")
- @Column(name="rvport")
- private String rvport;
- @JsonSerialize
- @JsonProperty("username")
- @Column(name="username")
- private String username;
- @JsonSerialize
- @JsonProperty("password")
- @Column(name="password")
- private String password;1234567891011121314151617181920212223242526272829
- src/main/java/com/pivotal/cf/broker/model/ServiceManagementImpl.java
createInstance()中,修改ServiceInstance instance = new ServiceInstance的參數,輸入正確的授權信息
removeServiceInstance()中,將下面代碼修改為正確的授權信息
- res.setKCXPAddr(instance.getKCXPAddr());
- res.setKCXPPort(instance.getKCXPPort());
- res.setRVIPAddr(instance.getRVIPAddr());
- res.setRVPort(instance.getRVPort());
- res.setUserName(instance.getUserName());
- res.setPassword(instance.getPassword());123456
createInstanceBinding(),將下面代碼修改為正確的授權信息
- credentials.put("KCXPAddr0", instance.getKCXPAddr());
- credentials.put("KCXPPort0", instance.getKCXPPort());
- credentials.put("RVIPAddr", instance.getRVIPAddr());
- credentials.put("RVPort", instance.getRVPort());
- credentials.put("UserName",instance.getUserName());
- credentials.put("Password",instance.getPassword());123456
編譯打包
在STS的package explorer中,右鍵單擊項目,run as-》gradle build,如果是初次運行,輸入下面的編譯打包gradle命令,run即可:
- clean
- build
- assemble123
至此,我們就得到了程序包,下面就可以開始部署了。