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的服务端就行了，这些接口中有几个是博主为实现本文的开发和部署过程自行添加的。

METHOD URL 用途 GET /v2/catalog 获取此SB管理的全部服务 POST /v2/catalog/services 创建新服务 DELETE /v2/catalog/services/{sid} 删除服务 POST /v2/catalog/services/{sid}/plans 创建新服务计划 PUT /v2/catalog/services/{sid}/plans/{planId}/costs 为计划增加单价 PUT /v2/catalog/services/{sid}/plans/{planId}/pool 为计划的资源池添加资源 DELETE /v2/catalog/services/{sid}/plans/{planId} 删除计划 DELETE /v2/catalog/services/{sid}/plans/{planId}/costs/{costId} 删除计划的单价 DELETE /v2/catalog/services/{sid}/plans/{planId}/pool/{resId} 删除计划的资源 PUT /v2/service_instances/{instanceId} 创建服务实例，用户创建服务时执行 DELETE /v2/service_instances/{instanceId} 删除服务实例，用户删除服务时执行 GET /v2/service_instances 获取服务实例信息 PUT /v2/service_instances/{instanceId}/service_bindings/{bindingId} 绑定服务到应用，用户绑定服务时执行 DELETE /v2/service_instances/{instanceId}/service_bindings/{bindingId} 将服务从应用解绑定，用户解绑服务时执行

开发

本文给出的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;

• 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;

• 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());

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());

编译打包

在STS的package explorer中，右键单击项目，run as-》gradle build，如果是初次运行，输入下面的编译打包gradle命令，run即可：

cleanbuildassemble

至此，我们就得到了程序包，下面就可以开始部署了。