【Spring实战】32 Spring Boot3 集成 Nacos 服务注册中心 并在 Gateway 网关中应用_springboot3 nacos

1. 定义

Nacos 是 Dynamic Naming and Configuration Service 的首字母简称，一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。它提供了服务发现、动态配置管理和服务元数据等功能，是构建和管理云原生应用的关键组件之一。

2. 背景

随着微服务架构的普及，服务的规模迅速增加，传统的配置管理和服务发现方式逐渐显得力不从心。Nacos 应运而生，致力于解决微服务领域中的服务注册、发现和配置管理等问题，为我们提供了更加灵活、高效的解决方案。它源于阿里巴巴内部对微服务架构管理的需求，经过多年的发展和实践，逐渐演化成了一个功能强大、稳定可靠的开源项目。

3. 功能和特性

• 服务发现

  提供了强大的服务发现功能，允许微服务注册和发现其他服务。通过 Nacos，服务可以在动态环境中进行注册、注销和发现，确保微服务架构的高可用性和弹性扩展

• 动态配置管理

  支持动态配置管理，我们可以通过Nacos实时修改配置，而无需重启应用。这为应对不同环境、不同配置需求提供了极大的灵活性

• 服务健康监测

  能够监测注册在其上的服务的健康状态，及时发现并处理故障，确保整个微服务体系的稳定运行

• 元数据管理

  允许我们为服务添加自定义的元数据，便于更灵活、更智能地管理服务实例

• 高可用和扩展性

  是一个高可用和可扩展的系统，支持构建多节点的集群，确保服务的可用性和性能

4. 下载安装

本文选择从官方的 GitHub 进行下载，选取了当前最新版本 2.2.1 ，网址如下：

https://github.com/alibaba/nacos/releases/tag/2.2.1

等待下载完成

将其解压到任意位置

5. 服务启动

根据官网进行修改配置文件

官网描述：

https://nacos.io/docs/v2/quickstart/quick-start/

因此本地修改 \nacos-server-2.2.1\nacos\conf\application.properties

然后进入 \nacos\bin 目录下，使用 CMD 执行下面命令来启动服务

startup.cmd -m standalone

直到看见了 Nacos started successfully in stand alone mode. 这就代表了 Nacos 服务启动成功了，并且端口号是 8848

访问服务，帐号和密码都是 nacos

http://localhost:8848/nacos

点击提交之后，就可以登录到 Nacos 啦

6. 使用示例

下面通过一个简单的示例演示如何使用 Nacos 进行服务注册中心和配置管理中心。

1）服务提供者

首先，我们创建一个简单的 Spring Boot 应用，然后将其注册到 Nacos 注册中心上

添加依赖

            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>2022.0.0.0-RC1</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-bootstrap</artifactId>
            </dependency>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
            </dependency>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

再 bootstrap.yml 文件中添加服务名以及 Nacos 地址

spring:
  application:
    name: account
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848

1
2
3
4
5
6
7
8

application.yml

server:
  port: 9501
  servlet:
    context-path: /account

1
2
3
4
5

创建一个 REST 请求，用于一会测试使用

package com.cheney.koala.account.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("hello")
    public String hello() {
        return "Hello world";
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

创建一个启动类 KoalaAccountApplication

package com.cheney.koala.account;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class KoalaAccountApplication {
    public static void main(String[] args) {
        SpringApplication.run(KoalaAccountApplication.class, args);
    }
}
1
2
3
4
5
6
7
8
9
10
11

启动服务之后，这样就可以将一个 Spring boot 应用注册上去了

在 Nacos 的控制台上，我们可以看到服务已经注册成功了，并且可以看到实例数和健康数等信息

2）服务消费者

首先，我们创建一个再去使用一下 Gateway 网关应用，然后也将其注册到 Nacos 注册中心上

添加依赖

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</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-bootstrap</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-loadbalancer</artifactId>
        </dependency>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

bootstrap.yml

spring:
  application:
    name: gateway
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848

1
2
3
4
5
6
7
8

application.yml

server:
  port: 9500

spring:
  cloud:
    gateway:
      routes:
        - id: account
          uri: lb://account
          predicates:
            - Path=/account/**

1
2
3
4
5
6
7
8
9
10
11
12

注意，这里的 uri 和之前不一样了，这里使用的是在 Nacos 上注册的服务名，而不是具体的 IP+端口号

这样的好处是无需关心服务的 IP 是多少，端口是多少，只需知道服务名即可，就可以访问了

创建一个启动类 KoalaGatewayApplication

package com.cheney.koala.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

1
2
3
4
5
6
7
8
9
10
11
12

启动服务之后，这样就可以将我们的 gateway 应用注册上去了

3）测试

这里我们直接请求 Gateway 网关的 URL 进行测试

http://localhost:9500/account/hello

7. 代码参考

https://gitee.com/cheney09/koala-system

结语

通过这篇博客，我们初步认识了 Nacos 的定义、背景、起源、功能和特性，并通过简单示例演示了其在微服务中的应用。在接下来的学习过程中，你将更深入地了解 Nacos 的各项功能，并掌握其在构建可靠、高可用的微服务体系中的应用。