SpringCloud 下

Swagger-UI 接口化工具

微服务是面向服务的架构, 在整个微服务项目中, 服务数量众多, 而每个服务又包含一系列 RESTFUL 风格API(controller), 开发/测试人员在调用API时, 都需要知道服务中有哪些功能, 以及如何获取服务中的 API. 此时，我们就可以通过当前流行的可视化工具 Swagger-UI 来完成这项工作.

Swagger-UI 可以让任何人在不实现任何逻辑的情况下, 以可视化的方式与后台服务端 API 接口方法进行交互.

Swagger-UI 的配置不会污染其他业务代码。我们通过引入 Swagger-UI 的配置即可自动生成相应的可视化接口文档，来对项目中的接口进行测试，极大简化了客户端与服务端的访问.

Swagger-UI 配置步骤

 

 

因为 swagger-ui 本身有前端展示, 所以在这个加入的 resource 里有一些 css, js, html 等.

 

 

 

 

使用 swagger-UI 测试

服务IP地址+端口 + /swagger-ui.html 进入测试页面.   (主要是针对 controller 的接口)

微服务与 Docker 整合 

 

 

 

 

   

 

 

 

 

 

 

 

 

实际上可以理解为, 每一个 SpringBoot 是一个微服务, 这个微服务可以提供多个接口(controller), 而每一个微服务(springboot) 是一个docker镜像文件.

环境搭建

搭建两个运行主机, 包含:

1. docker 引擎

2. jdk

3. Maven

4. 如果想镜像直接推送到构建仓库, 需要配置登录. 如果是用 mvn 推送的话, 需要配置 useMavenSettingsForAuth. (但我们一般用 Jenkins)

手动部署

单机部署

1. 登录私有仓库 docker login 192.168.197.143:5000

2. 部署服务 docker-compose up   (可以使用 docker ps 来查看部署的情况)

集群部署

docker network ls 查看集群搭建后的网络列表情况.

 

 

 

 

 

中间内容跟之前的文件一样.

 

手动集群部署步骤 

 

 

微服务测试 

 

 

 

 

Jenkins

安装 Maven 插件

1. 构建新任务 (Maven 项目) 

1) 配置源仓库地址

2) 构建触发器

 

 

 

 

 

 

 

查看构建过程中的信息