Spring Cloud Alibaba基础教程：使用Nacos实现服务注册与发现

自Spring Cloud Alibaba发布第一个Release以来，就备受国内开发者的高度关注。虽然Spring Cloud Alibaba还没能归入Spring Cloud的主版本管理中，可是凭借阿里中间件团队的背景，仍是获得很多团队的支持；同时，因为Spring Cloud Alibaba中的几项主要功能都直指Netflix OSS中的重要组件，然后者最近频繁宣布各组件不在更新新特性，这使得Spring Cloud Alibaba关注度不断飙升，很多开发者或团队也开始小范围试水。笔者对此也进行了一段时间的调研与试水，接下来计划以《Spring Cloud Alibaba基础教程》为主题，为你们完成一套快速入门的免费内容，以支持开源社区的发展！ ^_^

更多关于Spring Cloud Alibaba的介绍可见：《Spring Cloud 加盟重量级成员Spring Cloud Alibaba，打造更符合中国国情的微服务体系》

什么是Nacos

Nacos致力于帮助您发现、配置和管理微服务。Nacos提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。Nacos帮助您更敏捷和容易地构建、交付和管理微服务平台。Nacos是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。

在接下里的教程中，将使用Nacos做为微服务架构中的注册中心（替代：eurekba、consul等传统方案）以及配置中心（spring cloud config）来使用。

安装Nacos

下载地址：https://github.com/alibaba/na...
本文版本：0.7.0

下载完成以后，解压。根据不一样平台，执行不一样命令，启动单机版Nacos服务：

• Linux/Unix/Mac：sh startup.sh -m standalone
• Windows：cmd startup.cmd -m standalone

startup.sh脚本位于Nacos解压后的bin目录下。这里主要介绍Spring Cloud与Nacos的集成使用，对于Nacos的高级配置，后续再补充。因此，持续关注个人博客或者公众号吧！

启动完成以后，访问：http://127.0.0.1:8848/nacos/，能够进入Nacos的服务管理页面，具体以下；

构建应用接入Nacos注册中心

在完成了Nacos服务的安装和启动以后，下面咱们就能够编写两个应用（服务提供者与服务消费者）来验证服务的注册与发现了。

服务提供者

第一步：建立一个Spring Boot应用，能够命名为：alibaba-nacos-discovery-server。若是您还不会或者不了解Spring Boot应用，建议先学习《Spring Boot基础教程》。

第二步：编辑pom.xml，加入必要的依赖配置，好比：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.5.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Finchley.SR1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>0.2.1.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.2</version>
        <optional>true</optional>
    </dependency>
</dependencies>

上述内容主要三部分：

• parent：定义spring boot的版本
• dependencyManagement：spring cloud的版本以及spring cloud alibaba的版本，因为spring cloud alibaba还未归入spring cloud的主版本管理中，因此须要本身加入
• dependencies：当前应用要使用的依赖内容。这里主要新加入了Nacos的服务注册与发现模块：spring-cloud-starter-alibaba-nacos-discovery。因为在dependencyManagement中已经引入了版本，因此这里就不用指定具体版本了。

第三步：建立应用主类，并实现一个HTTP接口：

@EnableDiscoveryClient
@SpringBootApplication
public class TestApplication {

    public static void main(String[] args) {
        SpringApplication.run(TestApplication.class, args);
    }

    @Slf4j
    @RestController
    static class TestController {
        @GetMapping("/hello")
        public String hello(@RequestParam String name) {
            log.info("invoked name = " + name);
            return "hello " + name;
        }
    }
}

内容很是简单，@SpringBootApplication定义是个Spring Boot应用；@EnableDiscoveryClient开启Spring Cloud的服务注册与发现，因为这里引入了spring-cloud-starter-alibaba-nacos-discovery模块，因此Spring Cloud Common中定义的那些与服务治理相关的接口将使用Nacos的实现。这点不论咱们使用Eureka、Consul仍是其余Spring Cloud整合的注册中心都同样，这也是Spring Cloud作了封装的好处所在，若是对Eureka、Consul这些注册中心的整合还不熟悉的能够看看之前的这篇：Spring Cloud构建微服务架构：服务注册与发现（Eureka、Consul）。

第四步：配置服务名称和Nacos地址

spring.application.name=alibaba-nacos-discovery-server
server.port=8001

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

第五步：启动上面建立的应用。能够在启动时候增长-Dserver.port=8001的形式在本机的不一样端口上启动多个实例。

在应用启动好以后，咱们能够在控制台或日志中看到以下内容，表明已经注册成功：

INFO 10476 --- [           main] o.s.c.a.n.registry.NacosServiceRegistry  : nacos registry, alibaba-nacos-discovery-server 10.123.18.216:8001 register finished

在启动都ok以后，咱们能够访问Nacos的管理页面http://127.0.0.1:8848/nacos/来查看服务列表，此时能够看到以下内容：

这里会显示当前注册的全部服务，以及每一个服务的集群数目、实例数、健康实例数。点击详情，咱们还能看到每一个服务具体的实例信息，以下图所示：

服务消费者

接下来，实现一个应用来消费上面已经注册到Nacos的服务。

第一步：建立一个Spring Boot应用，命名为：alibaba-nacos-discovery-client-common。

第二步：编辑pom.xml中的依赖内容，与上面服务提供者的同样便可。

第三步：建立应用主类，并实现一个HTTP接口，在该接口中调用服务提供方的接口。

@EnableDiscoveryClient
@SpringBootApplication
public class TestApplication {

    public static void main(String[] args) {
        SpringApplication.run(TestApplication.class, args);
    }

    @Slf4j
    @RestController
    static class TestController {

        @Autowired
        LoadBalancerClient loadBalancerClient;

        @GetMapping("/test")
        public String test() {
            // 经过spring cloud common中的负载均衡接口选取服务提供节点实现接口调用
            ServiceInstance serviceInstance = loadBalancerClient.choose("alibaba-nacos-discovery-server");
            String url = serviceInstance.getUri() + "/hello?name=" + "didi";
            RestTemplate restTemplate = new RestTemplate();
            String result = restTemplate.getForObject(url, String.class);
            return "Invoke : " + url + ", return : " + result;
        }
    }
}

这里使用了Spring Cloud Common中的LoadBalancerClient接口来挑选服务实例信息。而后从挑选出的实例信息中获取可访问的URI，拼接上服务提供方的接口规则来发起调用。

第四步：配置服务名称和Nacos地址，让服务消费者能够发现上面已经注册到Nacos的服务。

spring.application.name=alibaba-nacos-discovery-client-common
server.port=9000

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

第五步：启动服务消费者，而后经过curl或者postman等工具发起访问，下面以curl为例：

$ curl localhost:9000/test
Invoke : http://10.123.18.216:8001/hello?name=didi, return : hello didi
$ curl localhost:9000/test
Invoke : http://10.123.18.216:8002/hello?name=didi, return : hello didi

能够看到，两次不一样请求的时候，真正实际调用的服务提供者实例是不一样的，也就是说，经过LoadBalancerClient接口在获取服务实例的时候，已经实现了对服务提供方实例的负载均衡。可是很明显，这样的实现仍是比较繁琐，预告下后面的几篇，关于服务消费的几种不一样姿式。

参考资料

• Nacos官方文档
• Nacos源码分析

代码示例

本文示例读者能够经过查看下面仓库的中的alibaba-nacos-discovery-server和alibaba-nacos-discovery-client-common项目：

• Github
• Gitee

若是您对这些感兴趣，欢迎star、follow、收藏、转发给予支持！

如下专题教程也许您会有兴趣

• Spring Boot基础教程
• Spring Cloud基础教程