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

news2024/11/17 11:29:58

文章目录

- 1. 定义
- 2. 背景
- 3. 功能和特性
- 4. 下载安装
- 5. 服务启动
- 6. 使用示例
- - 1）服务提供者
  - 2）服务消费者
  - 3）测试
- 7. 代码参考
- 结语

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>

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

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

application.yml

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

创建一个 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";
    }
}

创建一个启动类 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);
    }
}

启动服务之后，这样就可以将一个 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>

bootstrap.yml

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

application.yml

server:
  port: 9500

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

注意，这里的 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);
    }
}