袁芳的学习笔记（3）基于Predix的微服务

作者：袁芳，北京华瑞特信息技术有限公司

如果您还没有Predix试用帐号，请访问https://supportcentral.ge.com/esurvey/GE_survey/takeSurvey.html?form_id=18446744073709715720申请。请务必准确提供您的信息，我们会以邮件方式通知您注册结果。

GE Predix支持微服务，本次通过微服务示例工程，了解如何构建、部署、扩展微服务。官网有两个github工程，一个使用Apache CXF执行JAX-RS 2.0标准Java申明@GET,@PUT, @POST, @DELETE, 等，另一个使用Spring RestTemplate，他仍然使用原生的Spring声明，例如@RequestMapping(method = RequestMethod.DELETE)。

两个工程都利用了Spring的其他特性，包括在REST实现中运用了Spring安全过滤器，在之后的教程中，将会展示安全和授权的有用之处。

上图为微服务模板，通过三步即可获取一个Cloud Foundry的微服务：

（1）Git clone <project>

通过git clone命令从github中下载工程源码

（2）mvn clean package

通过该maven命令将源码进行打包

（3）cf push

通过Cloud Foundry的该命令将完成的打包推送到Predix云端，以此实现云端发布。

通过上面的微服务模板，可以对其进行扩展以创建个性化的微服务云端应用。

步骤：

（1） 下载工程源码

1)确保Maven库中的settings.xml文件信息正确

2)使用git下载工程源码

git clone  https://github.com/PredixDev/predix-microservice-cf-jsr.git 

cd predix-microservice-cf-jsr

或者

git clone  https://github.com/PredixDev/predix-microservice-cf-spring.git

cd predix-microservice-cf-spring

3)通过Maven构建并打包

mvn clean package

注意：“mvn clean install”可能会运行整合对微服务的测试，而这有可能并不启动这个测试。

（2）推送微服务到云端

CloudFoundry的推送命令从manifest.yml文件中获取一些属性信息用于推送微服务，“manifest.yml”文件是CloudFoundry的特性文件，不是Predix新增的概念。详细的“manifest.yml”文件信息参考：

https://docs.cloudfoundry.org/devguide/deploy-apps/manifest.html

简言之，“manifest.yml”告诉“cf push”对应用要做什么，包括：要创建多少个实例，需要为所需的应用开辟多少内存。也可以说，“manifest.yml”帮忙用户自动化云部署，尤其是一次性推送多应用的场景下。

编辑“manifest.yml”文件，将“name”更换为自定义应用名称，并且该应用名称必须是唯一的（在Predix云环境中），通过管理员权限打开CMD.exe，输入cf push命令：

$ cf push<your-name>-predix-microservice-cf-jsr

系统反馈该微服务的URL，将其添加https://头部，粘贴到浏览器即可。

（3）访问云端应用

（4）通过Eclipse打开工程

通过Eclipse或者EclipseSTS修改REST微服务或者将其在本地运行。

1）选择File/Import菜单

2）选择Maven/ExistingMaven Projects并点击Next

3）选择predix-microservice-cf-jsr路径并点击Finish

（5）REST API

接口类：

https://github.com/PredixDev/predix-microservice-cf-jsr/blob/master/src/main/java/com/ge/predix/solsvc/boot/service/cxf/DynamicService.java

接口实现类：

https://github.com/PredixDev/predix-microservice-cf-jsr/blob/master/src/main/java/com/ge/predix/solsvc/boot/service/cxf/DynamicServiceImpl.java

DefaultService注册到 spring文件：

https://github.com/PredixDev/predix-microservice-cf-jsr/blob/master/src/main/resources/META-INF/spring/predix-microservice-cf-jsr-cxf-context.xml

（6）本地测试

1）使用Eclipse发布应用，通过http://localhost:9092访问。

2）右键点击predix-microservice-cf

3）选择Run As / JavaApplication

4）如果是原型，选择Application.java点击OK

或者：

5）在Eclise STS右键点击predix-microservice-cf工程选择Run As / SpringBoot Application

 

（7）浏览结果

1）通过浏览器能够看到"Greetingsfrom Predix Spring Boot CXF!"

2）点击“API explorer”查看Swagge文档，微服务能够通过/api url查看自定义文档

3）通过/health url查看微服务的Health

4）在/docs url查看docs，使用Github，提供动态的index.html其能够下载README.md

5）查看Java Docs

6）确保停止在Eclipse的微服务以便为后续教程释放端口。

参考资料：

https://predix-io.run.aws-jp01-pr.ice.predix.io/resources/tutorials/tutorial-details.html?tutorial_id=1523

在使用中您有任何问题，请访问我们的论坛http://bbs.csdn.net/forums/GEPredix

GE数字集团的技术专家们会在线回答您的问题。

也请访问我们在CSDN的Predix专区http://predix.csdn.net 了解更多Predix的内容和相关活动。