Cloud Foundry(CF)通过buildpack扩展运行不同语言应用的能力,通过service broker(SB)扩展支持应用所需的各种关系数据库、中间件、缓存、云存储、内存数据库等各种服务的能力。这篇博文将从头至尾介绍通用的SB开发和部署。
AD:
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
至此,我们就得到了程序包,下面就可以开始部署了。
通过上篇,我们得到service broker的程序包,之后我们将其部署到CF上,得到真正能使用的市场服务。
AD:
通过上篇,我们得到service broker的程序包,之后我们将其部署到CF上,得到真正能使用的市场服务。
发布应用程序
将源代码中的application.properties里的spring.jpa.hibernate.ddl-auto配置为create,编译打包发布到CF上:
- cf push samplebroker -p ./cf-sample-servicebroker.jar1
创建一个MySQL服务实例,并绑定到此应用上:
- cf cs p-mysql 100m-dev samplebrokerdb
- cf bs samplebroker samplebrokerdb
- cf restart samplebroker123
将源代码中的application.properties里的spring.jpa.hibernate.ddl-auto配置为validate,重新编译打包发布到CF上:
- cf push samplebroker -p ./cf-sample-servicebroker.jar1
初始化服务信息
用ssh登陆Ops Manager的ubuntu,获取服务ID,其中的adminpassword就是Ops Manager的Elastic Runtime的credential页里的UAA模块admin的密码,samplebroker.open.mydomain.com是上一步发布的应用的域名
- curl -i -H "Content-type: application/json" -b cookies.txt -X GET http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog1
为对应的服务ID添加3个服务计划,其中的GUID是上一步中获取的,具体计划的详细信息请根据实际的资源情况进行修改
- curl -i -H "Content-type: application/json" -b cookies.txt -X POST http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans -d '{"name" : "bronze","description" : "all apps share 1 RV node","metadata" : {"max_size" : "10240M","connections" : 100,"bullets" : ["Each app has its own credential","100 apps at most"],"displayName":"Bronze"}}'
- curl -i -H "Content-type: application/json" -b cookies.txt -X POST http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans -d '{"name" : "silver","description" : "10 apps share 1 RV node","metadata" : {"max_size" : "20480M","connections" : 10,"bullets" : ["Each app has its own credential","10 apps for 1 RV node at most"],"displayName":"Silver"}}'
- curl -i -H "Content-type: application/json" -b cookies.txt -X POST http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans -d '{"name" : "gold","description" : "Each apps has its own RV node","metadata" : {"max_size" : "30720M","connections" : 1,"bullets" : ["Each app has its own credential","1 app for 1 RV node at most"],"displayName":"Gold"}}'123
根据前三条命令的输出里的ID信息为每个服务计划添加单价
- curl -i -H "Content-type: application/json" -b cookies.txt -X PUT http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans/29cf4cb9-4d85-42a2-89b8-65db630357c5/costs -d '{"amount":{"usd":1.0},"unit":"day"}'
- curl -i -H "Content-type: application/json" -b cookies.txt -X PUT http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans/12dd3ed1-7076-409e-8a64-568c3edd82e4/costs -d '{"amount":{"usd":10.0},"unit":"day"}'
- curl -i -H "Content-type: application/json" -b cookies.txt -X PUT http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans/b4897b00-b6cc-4295-9dbb-bf4084fe4c97/costs -d '{"amount":{"usd":100.0},"unit":"day"}'123
对于每一个服务计划,添加资源池,其中的资源信息按照实际情况进行修改
- curl -i -H "Content-type: application/json" -b cookies.txt -X PUT http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans/29cf4cb9-4d85-42a2-89b8-65db630357c5/pool -d '{"kcxpaddr":"10.23.119.61","kcxpport":"21000","rvipaddr":"10.23.119.57","rvport":"7500","username":"sxiang","password":"888888"}'
- curl -i -H "Content-type: application/json" -b cookies.txt -X PUT http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans/12dd3ed1-7076-409e-8a64-568c3edd82e4/pool -d '{"kcxpaddr":"10.23.119.61","kcxpport":"21000","rvipaddr":"10.23.119.57","rvport":"7500","username":"sxiang","password":"888888"}'
- curl -i -H "Content-type: application/json" -b cookies.txt -X PUT http://admin:adminpassword@samplebroker.open.mydomain.com/v2/catalog/services/590017dc-1fd2-4cbc-99e6-ae668107cc7a/plans/b4897b00-b6cc-4295-9dbb-bf4084fe4c97/pool -d '{"kcxpaddr":"10.23.119.61","kcxpport":"21000","rvipaddr":"10.23.119.57","rvport":"7500","username":"sxiang","password":"888888"}'123
发布service
- cf create-service-broker p-sample admin adminpassword https://samplebroker.open.mydomain.com1
创建service broker
获取3个服务计划的GUID
- cf curl /v2/service_plans1
将3个服务计划设置为可见
- cf curl /v2/service_plans/54beb2e7-a5c5-40c4-9a9b-e12c8edef4be -X PUT -d '{"public":true}'1
扩容
扩容时,需要使用a步增加资源池的容量,然后修改MySQL中的数据,再重启service broker应用
到此为止,在CLI或者GUI的maketplace里,就能找到这个p-sample的服务了。声明,本文中的源代码来源于github的开源代码,笔者进行了修正和完善。