springcloud学习笔记（3）-服务管理组件Nacos

news2024/11/17 23:29:08

Nacos简介

在2中学习了服务治理中心eureka，而本节的nacos来自springcloud alibaba。

Nacos也是一个服务注册和管理的组件。

Nacos 支持几乎所有主流类型的“服务”的发现、配置和管理

官方文档

快速开始 | Spring Cloud Alibaba (aliyun.com)

概述 | Spring Cloud Alibaba (aliyun.com)

Nacos Spring Cloud 快速开始

安装启动

Nacos 快速开始

访问：http://127.0.0.1:8848/nacos/

示例

可以使用官方示例

spring-cloud-alibaba/spring-cloud-alibaba-examples/nacos-example/nacos-config-example at 2022.x · alibaba/spring-cloud-alibaba · GitHub

参考官方教程：快速开始 | Spring Cloud Alibaba (aliyun.com)

Nacos 来实现分布式环境下的配置管理和服务注册发现。

配置管理

（这节讲的是如何通过应用实现对nacos的配置进行管理）

通过 Nacos Server 和 spring-cloud-starter-alibaba-nacos-config 实现配置的动态变更，这里的配置，是指nacos本身的配置，可以对nacos添加配置，更新配置。
Nacos Spring Cloud 快速开始

如果要在您的项目中使用 Nacos 来实现配置管理，需要进行以下操作（确保 Nacos Server 已启动）：

需要在 pom.xml 文件中引入 group ID 为 com.alibaba.cloud 和 artifact ID 为 spring-cloud-starter-alibaba-nacos-config 的 starter：
```
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
```

在应用的 /src/main/resources/application.yaml 配置文件中配置 Nacos Config 地址并引入服务配置：

spring:
  cloud:
    nacos:
      serverAddr: 127.0.0.1:8848
  config:
    import:
      - nacos:nacos-config-example.properties?refresh=true

完成上述两步后，应用会从 Nacos Server 中获取相应的配置，并添加在 Spring Environment 的 PropertySources 中。假设我们通过 Nacos 作为配置中心保存应用服务的部分配置，有以下几种方式实现：
- BeanAutoRefreshConfigExample：通过将配置信息配置为bean，支持配置变自动刷新；
- ConfigListenerExample：监听配置信息；
- DockingInterfaceExample：对接 Nacos 接口，通过接口完成对配置信息增删改查
- ValueAnnotationExample：通过 @Value 注解进行配置信息获取。示例代码给出了这几种方式

调用 Nacos Open API 向 Nacos Server 发布配置

命令行方式：

$ curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos-config-example.properties&group=DEFAULT_GROUP&content=spring.cloud.nacos.config.serverAddr=127.0.0.1:8848%0Aspring.cloud.nacos.config.prefix=PREFIX%0Aspring.cloud.nacos.config.group=GROUP%0Aspring.cloud.nacos.config.namespace=NAMESPACE"

控制台方式（推荐使用）：

dataId为：nacos-config-example.properties
group为：DEFAULT_GROUP

配置内容如下：

spring.cloud.nacos.config.serveraddr=127.0.0.1:8848
spring.cloud.nacos.config.prefix=PREFIX
spring.cloud.nacos.config.group=GROUP
spring.cloud.nacos.config.namespace=NAMESPACE

添加后的配置

报错不支持java 17，需要在project structure将SDK设置为JDK17，运行解决。

请求 http://127.0.0.1:18084/nacos/bean 地址，可以看到成功从 Nacos 配置中心中获取了数据。

$ curl http://127.0.0.1:18084/nacos/bean

响应结果：

{
    "serverAddr": "127.0.0.1:8848",
    "prefix": "PREFIX",
    "namespace": "NAMESPACE",
    "group":"GROUP"
}

这里返回的是BeanAutoRefreshConfigExample读取到的nacos的配置。

在命令行终端执行以下命令刷新 Nacos 的配置信息：

$ curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos-config-example.properties&group=DEFAULT_GROUP&content=spring.cloud.nacos.config.serveraddr=127.0.0.1:8848%0Aspring.cloud.nacos.config.prefix=PREFIX%0Aspring.cloud.nacos.config.group=DEFAULT_GROUP%0Aspring.cloud.nacos.config.namespace=NAMESPACE"

（修改nacos的配置）

再次请求 http://127.0.0.1:18084/nacos/bean 地址，可以看到应用已经从 Nacos 中获取到了最新的数据。

$ curl http://127.0.0.1:18084/nacos/bean

响应结果：

{
    "serverAddr": "127.0.0.1:8848",
    "prefix": "PREFIX",
    "namespace": "NAMESPACE",
    "group": "DEFAULT_GROUP"
}

服务注册与发现

服务注册，是指服务被注册到nacos中，nacos可以对服务进行管理。

服务发现，是指当一个服务consumer，请求另一个服务provider时，由nacos发现 provider，consumer才去获取provider提供的服务。如果没有nacos，consumer找不到provider。

服务注册

将服务注册到Nacos中

微服务的节点都需要注册到服务注册中心

1）加依赖

需要在 pom.xml 文件中引入 group ID 为 com.alibaba.cloud 和 artifact ID 为 spring-cloud-starter-alibaba-nacos-discovery 的 starter：

<dependency> 
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2）加配置

添加应用配置：在应用的 /src/main/resources/application.properties 配置文件中配置 Nacos Server 地址：

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848
spring.application.name=service-provider #这里的name配置了服务的名称。
server.port=18082

3）加注解

使用 @EnableDiscoveryClient 注解开启服务注册与发现功能：

@SpringBootApplication
@EnableDiscoveryClient
public class ProviderApplication {

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

    @RestController
    class EchoController {
        @GetMapping(value = "/echo/{string}")
        public String echo(@PathVariable String string) {
            return string;
        }
    }
}

启动应用并验证

启动provider应用，
IDE直接启动：找到 nacos-discovery-provider-example 项目的主类 ProviderApplication，执行 main 方法启动应用。
报错提示找不到或无法加载主类 com.alibaba.cloud.examples.ProviderApplication