Nacos上手实践(基于Spring Cloud)


Nacos介绍

Nacos是阿里出品的帮助发现、配置和管理微服务的一款产品,而且这应该是所有服务发现与管理产品中中文文档最为友好的,你完全直接去官网查看,中文手册用起来就是爽!

本文主要会快速上手入门使用Nacos,并结合项目(Spring Cloud)来进行开发。

安装Nacos

下载对应系统的包,windows下双击 startup.cmd 即可运行,运行成功如图,默认为8848端口

Nacos默认提供了控制台管理,访问地址:http://127.0.0.1:8848/nacos 可以看到:

默认用户命和密码都为:nacos,登录进入后可看到管理界面

服务发现

以下为 Nacoas 提供的一个服务发现的说明图。
echo service

创建工程

创建provider项目:leon-provider,指定Spring Boot版本为1.5.21,然后添加Nacos的相关依赖:

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>${latest.version}</version>
</dependency>

这里需要注意各个版本的对应关系

我们的spring boot是属于1.5.X的序列,所以对应的spring cloud的版本为:Spring Cloud Edgware 。
本位中使用的Nacos的版本为1.0.0,所以注意,如果需要引入spring cloud alibaba的相关依赖,那么就只能为特定三个版本。本文中使用0.1.2版本

在leon-provider中添加spring cloud 的相关依赖

<properties>
    <java.version>1.8</java.version>
    <spring-cloud.version>Edgware.SR5</spring-cloud.version>
</properties>

<dependencyManagement>
  <dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-dependencies</artifactId>
        <version>${spring-cloud.version}</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

如果需要使用 Spring Cloud Edgware 版本,请在 dependencyManagement 中添加如下内容

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

指定Nacos相关依赖版本为0.1.2

<properties>
    <java.version>1.8</java.version>
    <spring-cloud.version>Edgware.SR5</spring-cloud.version>
    <latest.version>0.1.2.RELEASE</latest.version>
</properties>

配置Nacos服务地址

在application.yml中配置Nacos服务信息:

server:
  port: 8080
spring:
  application:
    name: leon-provider
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

给启动类添加注解:

@EnableDiscoveryClient

启动程序,运行成功后,可以看到Nacos中已经有了注册信息:

点击详情后可查看当前服务的IP、端口、健康状态等信息。

在leon-provider工程中创建LoginService类,提供简单的登录方法:

@RestController
public class LoginService {

    @RequestMapping("/login")
    public String login(@RequestParam("userName") String userName, @RequestParam("passWord") String passWord) {
        if (userName.equals("leon") && passWord.equals("888")) {
            return "leon-provider: login success";
        }
        return "leon-provider: login fail";
    }
}

创建Consumer工程

创建leon-consumer工程,指定spring boot、Spring cloud版本和leon-provider一致,同时添加spring cloud feign依赖(关于Feign本文不在赘述)

添加Nacos的服务端IP和端口信息,

server:
  port: 8081
spring:
  application:
    name: leon-consumer
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

在leon-consumer中创建Feign Client,通过name属性定义想要调用的服务名称

@FeignClient(name = "leon-provider")
public interface UserFeignClient {
    @RequestMapping(value = "/login", method = RequestMethod.GET)
    public String login(@RequestParam("userName") String userName, @RequestParam("passWord") String passWord);
}

创建Controller类并调用接口

@RestController
public class UserController {

    @Autowired
    private UserFeignClient userFeignClient;

    /**
     * 用户账号名和密码登录
     *
     * @param userName
     * @param passWord
     * @return
     */
    @RequestMapping("/login")
    public String login(@RequestParam("userName") String userName, @RequestParam("passWord") String passWord) {
        return userFeignClient.login(userName, passWord);
    }
}

在启动类上添加注解 @EnableFeignClients,然后运行leon-consumer服务。刷新控制台,可以看到注册服务有两个:

访问leon-consumer中的login接口,查看是否能正常调用leon-provider服务。

管理服务

在控制台中,选择leon-provider服务,进入详情后,可以选择将其下线

下线后再次访问接口,可以发现已经找不到对应的服务了。通过配置的方式可以优雅的实现服务上、下线。

注意

服务通过控制台下线,只是代表会在订阅端过滤掉,在控制台不受影响,所以即使下线服务,在控制台依然显示是健康的实例。如果我们停掉服务,就会发现变成红色为非健康实例了


配置中心

Nacos同样提供了线上配置服务,新增配置



点击发布完成配置,然后返回可查看

在项目中添加依赖:

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>${latest.version}</version>
</dependency>

在Controller中添加方法

@Value("${name:}")
private String name;

@Value("${age:}")
private String age;


@RequestMapping("/config")
public String config() throws NacosException {
    return name + " | " + age;
}

运行程序访问

注意

  • 其中dataId的名字需要和spring.application.name保持一致(出去后缀)
  • 添加@RefreshScope注解才能实现动态刷新
  • 配置服务的参数必须配置在bootstrap文件中

文章作者:
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 !
 上一篇
Spring Cloud Gateway实践体验 Spring Cloud Gateway实践体验
整体介绍Spring Cloud Gateway是Spring Cloud官方推出的第二代网关框架,从官网给出的对比分析结果来看,Gateway比Zuul的性能要好很多,而且功能也更加丰富。以下是官方对比Gateway、Zuul、Linke
2019-06-19
下一篇 
Spring Cloud 基于Consul 实现配置服务 Spring Cloud 基于Consul 实现配置服务
Spring Cloud体系中提供了Config组件来进行配置服务管理。而Consul除了提供服务注册与发现功能外,同时也提供配置管理功能。本位将介绍如何结合Spring Cloud + Consul实现配置管理。 本文中使用的工程及
2019-06-12
  目录