Spring Cloud Alibaba（一） 如何使用nacos服务注册和发现
Nacos介绍
Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。
Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。
Nacos 的关键特性
- 服务发现和服务健康监测
- 动态配置服务，带管理界面，支持丰富的配置维度。
- 动态 DNS 服务
- 服务及其元数据管理
Nacos下载及部署
官方介绍文档：Nacos 快速开始或者直接下载zip包，部署下载
windows环境部署过程遇到的问题汇总
jdk版本要求
一定要注意，jdk版本要求 64bit JDK 1.8+
运行报错
运行startup.cmd，一闪而过。打开startup.cmd脚本，在最后一行添加 pause 使报错不会立即结束方便查看报错信息，这时会发现以下报错信息：
Exception in thread "main" java.lang.UnsupportedClassVersionError: org/springfra
mework/boot/loader/PropertiesLauncher : Unsupported major.minor version 52.0
at java.lang.ClassLoader.defineClass1(Native Method)
at java.lang.ClassLoader.defineClass(ClassLoader.java:800)
at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:14
2)
at java.net.URLClassLoader.defineClass(URLClassLoader.java:449)
at java.net.URLClassLoader.access$100(URLClassLoader.java:71)
at java.net.URLClassLoader$1.run(URLClassLoader.java:361)
at java.net.URLClassLoader$1.run(URLClassLoader.java:355)
at java.security.AccessController.doPrivileged(Native Method)
at java.net.URLClassLoader.findClass(URLClassLoader.java:354)
at java.lang.ClassLoader.loadClass(ClassLoader.java:425)
at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
at java.lang.ClassLoader.loadClass(ClassLoader.java:358)
at sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:482)
产生以上问题的原因是我电脑上有些老项目使用jdk 1.7，所以项目是jdk1.7和jdk1.8交叉着使用。在cmd里查看版本 java -version 输出然后是1.8.0_211（只会输出最高的版本）
解决方案
- 配置java_home，增加jdk1.8环境变量，怎么添加环境变量需要自行百度，以下贴出我的java环境变量
C:\Users\Administrator>set java_home
JAVA_HOME=D:\Program Files\Java\jdk1.7.0_71
C:\Users\Administrator>set java8_home
JAVA8_HOME=D:\Program Files\Java\jdk1.8.0_201
C:\Users\Administrator>
- 调整startup.cmd脚本，使用java8_home变量，使它能正确调用jdk1.8而非jdk1.7，以下是调整部分代码
if not exist "%JAVA8_HOME%\bin\java.exe" echo Please set the JAVA8_HOME variable in your environment, We need java(x64)! jdk8 or later is better! & EXIT /B 1
set "JAVA=%JAVA8_HOME%\bin\java.exe"
这里只做个替换，把原来的JAVA_HOME规划成JAVA8_HOME，运行startup.cmd，此时能正确运行Nacos服务了
查看界面
启动成功，在浏览器上访问：http://localhost:8848/nacos ，会跳转到登陆界面，默认的登陆用户名为nacos，密码也为nacos。
登陆成功后，就可以操作管理界面了
使用Nacos服务注册和发现
要使用nacos，需要在pom.xml添加必要的依赖
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Greenwich.SR3</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2.1.0.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
服务注册与发现示例代码创建
在本案例中，使用3个服务注册到Nacos上，分别为服务提供者ali-nacos-provider和负载均衡ribbon消费者ali-nacos-consumer-ribbon、申明式服务调用feign消费者ali-nacos-consumer-feign。
什么是ribbon和feign，及使用示例这里不重复介绍，需要了解可以查看示例
创建服务提供者ali-nacos-provider
pom.xml添加nacos依赖
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
application.yml配置
server:
port: 9000 #指定为9000端口
spring:
application:
name: ali-nacos-provider #服务名
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848 #服务注册地址(nacos默认为8848端口)
management:
endpoints:
web:
exposure:
include: '*'
启动类增加 @EnableDiscoveryClient 注解
package com.easy.aliNacosProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
@EnableDiscoveryClient
@SpringBootApplication
public class AliNacosProviderApplication {
public static void main(String[] args) {
SpringApplication.run(AliNacosProviderApplication.class, args);
}
}
写个hello服务接口 HelloController.java
package com.easy.aliNacosProvider;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
@RestController
@Slf4j
public class HelloController {
@GetMapping(value = "/hello/{str}", produces = "application/json")
public String hello(@PathVariable String str) {
log.info("-----------收到消费者请求-----------");
log.info("收到消费者传递的参数：" + str);
String result = "我是服务提供者，见到你很高兴==>" + str;
log.info("提供者返回结果：" + result);
return result;
}
}
创建ribbon服务消费者
pom.xml增加nocos和ribbon依赖
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
</dependency>
</dependencies>
application.yml
server:
port: 9100
spring:
application:
name: ali-nacos-consumer-ribbon
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
服务调用HomeController.java
package com.easy.ancRibbon;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;
@RestController
@Slf4j
public class HomeController {
@Autowired
private RestTemplate restTemplate;
@GetMapping(value = "/", produces = "application/json")
public String home() {
log.info("-----------------consumer调用开始-----------------");
String param = "云天";
log.info("消费者传递参数：" + param);
String result = restTemplate.getForObject("http://ali-nacos-provider/hello/" + param, String.class);
log.info("收到提供者响应：" + result);
return "ribbon消费者，" + result;
}
}
启用类AncRibbonConsumerApplication.java
package com.easy.ancRibbon;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestTemplate;
@SpringBootApplication
@EnableDiscoveryClient
public class AncRibbonConsumerApplication {
@Bean
@LoadBalanced
public RestTemplate restTemplate() {
return new RestTemplate();
}
public static void main(String[] args) {
SpringApplication.run(AncRibbonConsumerApplication.class, args);
}
}
创建feign服务消费者
pom.xml
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
</dependencies>
application.yml
server:
port: 9101
spring:
application:
name: ali-nacos-consumer-feign
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
main:
allow-bean-definition-overriding: true #允许一样的beanName
这里有个坑要注意下，如果allow-bean-definition-overriding为设置为true,运行会报如下错：
错误： Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true
这里有问题的详细介绍问题原因
申请服务HelloService.java
package com.easy.ancFeign;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
@FeignClient("ali-nacos-provider")
public interface HelloService {
@RequestMapping(path = "hello/{str}")
String hello(@RequestParam("str") String param);
}
服务调用HomeController.java
package com.easy.ancFeign;
import lombok.extern.slf4j.Slf4j;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@Slf4j
public class HomeController {
@Autowired
private HelloService helloService;
@GetMapping(value = "/", produces = "application/json")
public String home() {
log.info("-----------------consumer调用开始-----------------");
String param = "云天";
log.info("消费者传递参数：" + param);
String result = helloService.hello(param);
log.info("收到提供者响应：" + result);
return "feign消费者" + result;
}
}
启动类AncFeignConsumerApplication.java
package com.easy.ancFeign;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;
@SpringBootApplication
@EnableFeignClients(basePackages = {"com.easy.ancFeign"})
public class AncFeignConsumerApplication {
public static void main(String[] args) {
SpringApplication.run(AncFeignConsumerApplication.class, args);
}
}
使用示例
现有三个项目如下
ali-nacos-provider：服务提供者1，服务名：ali-nacos-provider，端口：9000
ali-nacos-consumer-ribbon：ribbon服务消费者，服务名：ali-nacos-consumer-ribbon，端口：9100
ali-nacos-consumer-feign：feign消费者，服务名：ali-nacos-consumer-feign，端口：9101
运行测试
首先要启动服务注册中心 nacos
其次，分别启动ali-nacos-provider、ali-nacos-consumer-ribbon、ali-nacos-consumer-feign三个服务
- 访问地址：http://localhost:9100/，返回：ribbon消费者，我是服务提供者，见到你很高兴==>云天，说明ribbon消费成功了。
- 访问地址：http://localhost:9101/，返回：feign消费者我是服务提供者，见到你很高兴==>云天，说明feign消费费成功了。
- 访问地址：http://localhost:9000/hello/yuntian，返回：我是服务提供者，见到你很高兴==>yuntian，说明服务提供者访问成功了(PS:服务提供者一般是不对外公开的，怎么隐蔽接口将在接下去的文章里介绍)
- 访问地址：http://localhost:8848/nacos/#/login，输入用户：nacos，密码：nacos。进入服务管理界面，在服务管理-服务列表里可以看到我们运行的三个服务了。
