华为开源项目ServiceComb快速入门

在开始开发前，需先确保相关依赖工具已于本地安装，主要包括：git, oracle JDK 1.8, maven 3.x, docker 1.11.2,intelliJ idea。

此外，需先在本地安装 ServiceComb Java Chassis(SDK)，执行以下指令：

并运行 Service Center

在 ServiceComb 微服务框架中，Service Center 提供服务注册及服务发现功能。

体质指数应用主要包含两个微服务，一个是负责后台运算的体质指数计算器，另一个是提供用户界面及网关服务的体质指数界面。

其运行流程为：

其中，虚线表示服务注册及服务发现的过程。

现在从intelliJ创建一个全新的工程，并引入相关依赖项。

需要注意的是，此处java-chassis-dependencies这个依赖项是以pom的方式导入的，主要为了统一整个项目的依赖项的版本，避免出现版本冲突问题。

然后，需要新增一个模块用于实现运算服务。主要包括以下步骤：

1、引入依赖项：

2、运算结果数据结构定义：

具体运算实现。根据公式进行实现，代码如下：

4、实例信息接口及其实现。

5、服务端点定义。用于生成服务契约，使得服务间能无缝进行通信。

6、暴露运算服务的Restful端点：

这里用@RestSchema注释端点后， ServiceComb 微服务框架会自动生成对应的服务端点契约，并根据如下的resources/ microservice.yaml 文件中的定义来配置端点端口，将契约和服务一起注册到服务注册中心。

6、服务启动入口。只需添加 @EnableServiceComb 的注解即可启用 ServiceComb 微服务框架，代码如下：

经过以上简单几步即可完成运算服务的开发。接下来将进行体质指数界面的实现，此时再新建一个模块。

1、引入依赖项

2、服务启动入口。只需要声明启用ServiceComb和Zuul即可。

3、在 resources/application.yaml 文件中配置路由规则及服务端口信息：

4、在 resources/microservice.yaml 文件中配置网关服务的信息和服务注册中心的地址。

5、在resources目录下新建一个名为static的目录用于存放前端网页文件，具体的实现可在https://github.com/ServiceComb/ServiceComb-Java-Chassis/blob/master/samples/bmi/webapp/src/main/resources/static/index.html获取。

至此，体质指数应用已开发完毕。此时，分别在IDE中选中运算服务和网关服务的启动入口文件右键运行，待服务启动完毕，即可通过http://localhost:8889访问体质指数应用，届时将能看到如下界面，并可输入您的身高和体重信息验证服务是否正常运行。

当对体质指数计算器进行水平扩展时，需要将请求均衡地分发到多个体质指数计算器上。

开启：默认情况下会使用内置的一个简单的负载均衡的实现，不需要额外的配置。

验证：对体质指数计算器微服务进行水平扩展，使其运行实例数为2，即新增一个运行实例，此时需要修改运算服务模块中的microservice.yaml文件，将服务运行端口由7777改为7778，以避免出现端口冲突，然后再运行一个运算服务即可。

此时点击 Submit 按钮就可以看到如下两个界面中的实例ID交替出现。

流量控制机制通过控制数据传输速率来避免微服务过载运行。

开启：

1、在体质指数计算器的pom.xml文件中添加依赖项：

2、在体质指数计算器的microservice.yaml文件中指明使用流量控制的处理链及指定流控策略：

验证：

访问http://localhost:8889，在身高和体重的输入框中输入正数，尝试在1秒内多次点击 Submit 按钮，此时就能看到网页由左侧的正常的界面变成了右侧提示由于流控受限而请求被拒的界面。

服务治理主要用于解决或缓解服务雪崩的情况，即个别微服务表现异常时，系统能对其进行容错处理，从而避免资源的耗尽。

启用：

1、在体质指数计算器的pom.xml文件中添加依赖项：

2、在体质指数计算器的microservice.yaml文件中指明使用服务治理的处理链及指定熔断和容错策略：

验证：

1、使服务进入熔断状态。访问http://localhost:8889，在身高或体重的输入框中输入一个负数，连续点击三次或以上 Submit 按钮，此时在网页下方能看到类似左图的界面。

2、验证服务处于熔断状态。在身高和体重的输入框中输入正数，再次点击 Submit 按钮，此时看到的界面依然是类似左图的界面。同时在体质指数计算器运行日志也能看到调用不再抛出异常，而是出现类似 fallback called 的日志。

3、验证服务恢复正常。约15秒后，在身高和体重的输入框中输入正数，点击 Submit 按钮，此时界面显示正常。

分布式调用链追踪用于有效地监控微服务的网络延时并可视化微服务中的数据流转。

启用：

1、在体质指数计算器的pom.xml文件中添加依赖项：

2、在体质指数计算器的microservice.yaml文件中添加分布式追踪的处理链：

3、在体质指数界面的pom.xml文件中添加依赖项：

体质指数应用中已配置好了上述配置项，只需执行以下几步即可：

使用 Docker 运行 Zipkin 分布式追踪服务；

重启体质指数计算器微服务；

重启体质指数界面微服务。

验证：

1、访问http://localhost:8889，在身高和体重栏处输入正数，并点击 Submit 按钮。

2、访问http://localhost:9411，查看分布式调用追踪情况，可得下方界面。

通过使用docker-mavn-plugin可快速实现开发的微服务打包为docker镜像的功能。而基于ServiceComb开发的微服务也能实现无缝上云，只需以下简单几步：

1、在项目pom文件中添加华为ServiceStage的profile：

2、分别在运算服务和网关服务中修改服务中心地址，并新增配置中心地址和监控中心地址：

然后即可通过我们提供的一键发布脚本将应用从编译到最后部署到华为ServiceStage上的镜像仓库的流程自动化。随后即可通过我们提供的一键部署模板实现华为ServiceStage的微服务自动部署运行。

有不同的意见也欢迎来和我们进行讨论，参与到社区工作中：

ServiceComb官网：

http://servicecomb.io/cn/

ServiceCombGithub：

https://github.com/ServiceComb

微服务引擎交流论坛：

http://forum.huaweicloud.com/forum.php?mod=forumdisplay&fid=622。

最后，祝贺华为云发起的开源项目ServiceComb全票通过进入Apache孵化器。欢迎大家一起携手建设更活跃的ServiceComb社区，为Apache开源生态贡献力量。