Cloud Foundry service broker开发部署实例解析（上），foundrybroker


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即可：

clean
build
assemble

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

相关内容