崔志伟博客

本地服务调用K8S环境中的SpringCloud微服务实战

下图是典型的微服务在Kubernetes环境的部署情况(简化版):
在这里插入图片描述
在开发阶段,如果服务B还在开发中,部署情况如下图所示:
在这里插入图片描述
此时的服务B如何才能访问到注册中心和服务A呢?

常规手段:通过service访问对应的pod

通常情况下,从外部访问kubernetes内部pod服务的方法是创建service,再通过访问service的方式来访问对应的Pod,但是这样做会变更kubernetes环境现有配置,例如原本注册中心对应的service type是ClusterIP,这里只有改成NodePort或者LoadBalancer才能让外部访问到,又例如服务A原本没有service,这里为了外部访问只能为其创建service。

如果这个Kubernetes环境是生产环境,上述改动都是不允许的,如果是开发环境,又会造成开发和生产环境有大量不一样的配置,因此,创建service虽然可行但并不是好方案。

更适合本地开发的方案:kubefwd服务

比service更适合本地开发的方案是使用kubectl port-forward命令在本地电脑创建kubefwd服务,例如将对当前电脑8081端口的请求,可以kubefwd转发到kubernetes上的注册中心Pod的8080端口;

有了kubefwd,我们在开发服务B的时候,只要把发往注册中心和服务A的请求都kubefwd服务转发到kubernetes上去就可以了,如下图:
在这里插入图片描述

理论分析就到此吧,接下来一起实战本地服务调用K8S环境中的微服务。

实战环境

以下是本次实战所需的环境,请确保您的kubernetes是正常可用的:

  1. kubernetes:
  2. kubectl:1.7.0
  3. kubernetes所在Linux服务器:CentOS7.4
  4. 本地环境:win10专业版64位
  5. SpringCloud:Edgware.SR1

如果您还没有搭建kubernetes环境,请参考此文快速搭建一个:《极速安装和体验k8s(Minikube)》
windows环境配置kubectl远程操作kubernetes的方法请参考《在windows电脑上配置kubectl远程操作kubernetes》

实战所需的注册中心和服务A对应的是两个maven工程(eureka-server和service-provider,后面会给出源码链接),我已经将其做成镜像并且上传到 hub.docker.com,可以直接使用,简介如下:

镜像名 角色 镜像对应的源码
bolingcavalry/eureka-server:0.0.1-SNAPSHOT 注册中心 eureka-server工程
bolingcavalry/service-provider:0.0.1-SNAPSHOT 服务A,提供http服务 service-provider工程

源码下载

本次实战的注册中心(eureka-server)、服务A(service-provider)、服务B(service-consumer)都在GitHub提供了对应的源码,地址和链接信息如下表所示:

名称 链接 备注
项目主页 https://github.com/zq2599/blog_demos 该项目在GitHub上的主页
git仓库地址(https) https://github.com/zq2599/blog_demos.git 该项目源码的仓库地址,https协议
git仓库地址(ssh) git@github.com:zq2599/blog_demos.git 该项目源码的仓库地址,ssh协议

这个git项目中有多个文件夹,本章源码在springcloudscaledemo这个文件夹下,如下图红框所示:
在这里插入图片描述

实战

本次实战的步骤是将注册中心和服务A部署到kubernetes环境,然后在本地运行服务B,看服务B能否正常注册和调用服务A。

注册中心、服务A、服务B与源码工程的对应关系如下:

角色 源码工程 备注
注册中心 eureka-server eureka注册中心服务,部署在kubernetes
服务A service-provider springboot工程,部署在kubernetes,在eureka注册,提供http接口getuserinfo
服务B service-consumer springboot工程,部署在本地windows电脑上,提供http接口user

注意:以下的操作都在本地的windows电脑上完成

  1. 创建注册中心的deployment,执行以下命令:
kubectl run my-eureka --image=bolingcavalry/eureka-server:0.0.1-SNAPSHOT --replicas=1
  1. 创建名为eurekahost的服务,对应的pod是刚刚创建的my-eureka:
kubectl expose deployment my-eureka --name=eurekahost --port=8080
  1. 创建服务A的deployment:
kubectl run my-provider --image=bolingcavalry/service-provider:0.0.1-SNAPSHOT --replicas=1
  1. 查看pod的名字:
c:\software\kubectl>kubectl get pods
NAME                           READY     STATUS    RESTARTS   AGE
my-eureka-7f958f96b7-drgt6     1/1       Running   0          25m
my-provider-78dcc87bcc-s7cvq   1/1       Running   0          19m

我这里注册中心pod名字是my-eureka-7f958f96b7-drgt6,服务A的pod名字是my-provider-78dcc87bcc-s7cvq
5. 通过kubefwd服务将本地8081端口的请求转发到my-eureka-7f958f96b7-drgt6的8080端口:

kubectl port-forward my-eureka-7f958f96b7-drgt6 8081:8080
  1. 此时用浏览器访问本机的8081端口,就能访问到注册中心了,如下图:
    在这里插入图片描述
  2. 通过kubefwd服务将本地8082端口的请求转发到my-provider-78dcc87bcc-s7cvq的8080端口:
kubectl port-forward my-provider-78dcc87bcc-s7cvq 8082:8080
  1. 此时用浏览器访问本机的8082端口,就能调用服务A的http接口了,地址是:http://localhost:8082/getuserinfo?id=101&name=Tom
    在这里插入图片描述
  2. 此时注册中心和服务A都可以在本地访问了,可以在本地开发服务B的代码了,详细源码请按照前面给出的地址下载,这里只贴出关键代码,首先是配置信息application.yml,这是个普通的SpringCloud工程的配置,要注意的是eureka的地址和端口要改成localhost:8081,这样请求才会被kubefwd服务转发到kubernetes上去:
server:
  port: 8080
spring:
  application:
    name: service-consumer
eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8081/eureka/
  instance:
    prefer-ip-address: true
  1. 服务B调用服务A用的是FeignClient的方式,在FeignClient的注解中,要用url参数指明服务A的地址是http://localhost:8082,这样对服务A的请求才会被转发到kubernetes上去:
@FeignClient(name = "microservice-provider-user", url = "http://localhost:8082")
public interface UserFeignClient {

    @RequestMapping(value = "/getuserinfo", method = RequestMethod.GET)
    String getUserInfoWithRequestParam(@RequestParam("id") String id, @RequestParam("name") String name);
}
  1. 做一个controller类,接收到web请求后,就会调用服务A的getuserinfo接口,然后将服务A返回的内容加个前缀返回:
@RestController
public class UserFacadeController {

    @Autowired
    private UserFeignClient userFeignClient;

    @GetMapping("/user/{id}/{name}")
    public String getUserInfo(@PathVariable("id") final String id, @PathVariable("name") final String name) {
        return "1. ---" + userFeignClient.getUserInfoWithRequestParam(id, name);
    }
}
  1. 在本地运行此工程,去看注册中心页面,发现已经注册成功:
    在这里插入图片描述
  2. 在浏览器输入:http://localhost:8080/user/aaa/bbb ,可见服务B的返回内容中有调用服务A时返回的信息,所以调用成功:
    在这里插入图片描述
    实战完成,从注册到远程调用都一切正常。

一点小遗憾

在使用kubectl port-forward命令的时候,本来是想执行以下命令的,这样可以将本地请求转发到my-eureka的deployment上去,就不用指定具体的pod了(pod的名字不如deployment固定):

kubectl port-forward deployment/my-eureka 8081:8080

但是在windows环境下此命令会报错"error: invalid resource name “deployment/my-eureka”: [may not contain ‘/’]",也就是名字不能带有斜杠,但是上述命令是官方文档上列举出来的,地址是:https://kubernetes.io/docs/tasks/access-application-cluster/port-forward-access-application-cluster/ ,如下图:
在这里插入图片描述

同样的困惑

这里有一篇文章,文中作者也是在本地调用kubernetes服务时,同样是用kubectl port-forward解决了问题:https://imti.co/kubernetes-port-forwarding
在这里插入图片描述
此文章的配图是比较细致清晰的,在此转载了:
在这里插入图片描述

至此,本地服务调用K8S环境中的SpringCloud微服务实战已完成,当您开发微服务时如遇到类似场景,希望本文能够给您一些参考。

来源:https://blog.csdn.net/boling_cavalry/article/details/90578934

上一篇: Docker镜像列表中的none:none是什么

下一篇: 如何让input输入框只能填写数字