Nacos上手实践（整合Spring Cloud）

Nacos介绍

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

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

安装Nacos

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

image

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

image

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

image

服务发现

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

echo service

创建工程

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

    org.springframework.cloud
    spring-cloud-starter-alibaba-nacos-discovery
    ${latest.version}

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

image

image

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

image

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

    1.8
    Edgware.SR5

    

  
    
        org.springframework.cloud
        spring-cloud-dependencies
        ${spring-cloud.version}
        pom
        import
    
  

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

    org.springframework.cloud
    spring-cloud-alibaba-dependencies
    0.1.2.RELEASE
    pom
    import

指定Nacos相关依赖版本为0.1.2

    1.8
    Edgware.SR5
    0.1.2.RELEASE

配置Nacos服务地址

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

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

给启动类添加注解：

@EnableDiscoveryClient

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

image

点击详情后可查看当前服务的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服务。刷新控制台，可以看到注册服务有两个：

image

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

image

管理服务

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

image

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

image

注意

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

---

配置中心

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

image

---

image

---

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

image

在项目中添加依赖：

    org.springframework.cloud
    spring-cloud-starter-alibaba-nacos-config
    ${latest.version}

在Controller中添加方法

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

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


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

运行程序访问

image

注意

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