【微服务】之六:轻松搞定SpringCloud微服务-API网关zuul
通过前面几篇文章的介绍,我们可以轻松搭建起来微服务体系中比较重要的几个基础构建服务。那么,在本篇博文中,我们重点讲解一下,如何将所有微服务的API同意对外暴露,这个就设计API网关的概念。
本系列教程
【微服务】轻松搞定SpringCloud微服务目录
本系列为连载文章,阅读本文之前强烈建议您先阅读前面几篇。
网关名称解释
网关(Gateway)又称网间连接器、协议转换器。网关在网络层以上实现网络互连,是最复杂的网络互连设备,仅用于两个高层协议不同的网络互连。网关既可以用于广域网互连,也可以用于局域网互连。 网关是一种充当转换重任的计算机系统或设备。使用在不同的通信协议、数据格式或语言,甚至体系结构完全不同的两种系统之间,网关是一个翻译器。
API网关名词解释
API Gateway(API GW / API 网关),顾名思义,是出现在系统边界上的一个面向API的、串行集中式的强管控服务,这里的边界是企业IT系统的边界。
在微服务流行之前,API GW的实体就已经诞生了,这时的主要应用场景是OpenAPI,也就是开放平台,面向的是企业外部合作伙伴,对于这个应用场景,相信接触的人会比较多。当在微服务概念流行起来之后,API网关似乎成了在上层应用层集成的标配组件。
Spring Cloud Zuul 简介
Zuul 是Netflix 提供的一个开源组件,致力于在云平台上提供动态路由,监控,弹性,安全等边缘服务的框架。也有很多公司使用它来作为网关的重要组成部分。Spring Cloud 体系收录的该模块,主要用于提供动态路由、监控、安全控制、限流配额等,可以将内部微服务API同意暴露。
博文系统架构
根据我们微服务整体的一个架构设计,本系列博文也主要是对整个微服务架构进行落地示范。通过一组架构比较可以更加深入理解网关的概念。
传统互联网架构
在没有微服务的架构体系当中,我们一般使用Nginx作为负载分发、反向代理,形成一个API网关的一个构建。架构图如下图所示:
微服务下网关模式
在spring cloud 体系当中,我们将内部的服务全部进行隐藏,对外只有一个对外暴露的机制,这就是spring cloud zuul 网关。架构图如下所示:
如果我们在深入一些,去兼容一些以前公司旧的非微服务系统也可以是这样:
开始起飞
同样,起飞之前,建议阅读前面几篇文章,方便代码理解与使用。
创建网关子项目
我们在原来的父类项目下创建一个子项目。(可以参考我GitHub代码结构)
配置POM文件
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
创建配置文件application.yml
resources 文件夹下面创建文件application.yml,配置清单如下:
#服务注册中心配置
eureka:
client:
service-url:
defaultZone: http://localhost:8081/eureka/
instance:
appname: api-gateway
#设置网关端口号
server:
port: 8080
spring:
application:
name: api-getway
创建程序入口application.java
为了方便,命名为GatewayApplication
/**
* Created by Administrator on 2017/12/17.
* 网关启动入口
*/
@SpringBootApplication
@EnableZuulProxy
public class GatewayApplication {
public static void main(String[] args) {
SpringApplication.run(GatewayApplication.class, args);
}
}
@EnableZuulProxy 注解说明:@EnableZuulProxy简单理解为@EnableZuulServer的增强版,当Zuul与Eureka、Ribbon等组件配合使用时,我们使用@EnableZuulProxy。
启动并测试
从上面的配置中,我们已经完成了基本的网关配置,那么我们就来做一个简单的测试。
本次测试选择我微服务项目群中有三个服务:
分别是:
子项目名称 | 服务名称 | 端口号 | 源码 |
---|---|---|---|
cloud-hyh-service-1 | cloud-service | 8071 | github |
cloud-hyh-discovery-eureka | discovery-service | 8081 | github |
cloud-hyh-api-gateway-zuul | api-gateway | 8080 | github |
启动子服务
分别启动注册中心、测试服务、api网关三个服务。我们可以观察服务注册中心已经可以看到其他两个服务会被注册。
访问API测试
我们在cloud-service子项目中,之前已经做过一个测试的API,
子微服务 | 地址 | 路径 | 请求方式 |
---|---|---|---|
cloud-service | http://localhost:8071 | /ribbon/name | GET |
在没有网关之前,我们外部如果想要调用服务的花,就可以通过微服务自身的地址访问。但是有了API网关之后,我们可以将我们的服务地址对外暴露出去。
子微服务 | 地址 | 路径 | 请求方式 |
---|---|---|---|
cloud-service | http://localhost:8080 | /ribbon/name | GET |
访问地址: 网关地址/服务名/访问地址/
http://localhost:8080/cloud-service/ribbon/name
测试成功
浏览器中返回:
千万之路刚开始-www.hanyahong.com-beijing该服务器端口8071
说明:针对API网关还有很多参数需要配置,例如持久化、负载分发等。针对这一块我们后续还会进行专题细致深入。
源码
本文出处:http://www.hanyahong.com/
Github源码:https://github.com/hanyahong/spring-cloud-microservice
转发请注明出处!