Nacos快速入门（windows）

news2024/11/14 14:09:35

Nacos是 Dynamic Naming and Configuration Service的简称。Nacos能快速实现动态服务发现、服务配置、服务元数据及流量管理

下载启动Nacos

Nacos下载启动（windows）

 以下两种随意选择一种即可

从github上下载源码方式启动

git clone https://github.com/alibaba/nacos.git
cd nacos/
 mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U
 ls -al distribution/target/
 
 // change the $version to your actual path
 cd distribution/target/nacos-server-$version/nacos/bin

下载编译后压缩包方式(推荐)
下载 nacos-server-2.3.1.zip
下载地址:https://github.com/alibaba/nacos/releases
解压下载的zip包，进入nacos/bin 输入启动命令 startup.cmd -m standalone

登录nacos 。本地浏览器输入地址 http://localhost:8848/nacos 登录。默认密码是nacos/nacos

注册服务和发现服务

pom文件中引入 spring-cloud-starter-alibaba-nacos-discovery，注意springboot和引入nacos包的版本，本例子中引入的springboot 是2.0.4.RELEASE ，nacos是0.2.1.RELEASE （注意:springboot 的2.1.9.RELEASE 和nacos0.2.1.RELEASE 版本不兼容，会导致服务注册不上去，切记，因为这个我浪费了很多时间）

如报错 java.lang.IllegalStateException: failed to req API:/nacos/v1/ns/instance after all servers([127.0.0.1:8848]) tried
at com.alibaba.nacos.client.naming.net.NamingProxy.reqAPI(NamingProxy.java:335) ~[nacos-client-0.6.2.jar:na] 可以在原有的nacso里面排除nacos-client 重新引入nacos-client ，如pom文件里面一样

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.4.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
            <version>0.2.1.RELEASE</version>
            <exclusions>
                <exclusion>
                    <groupId>com.alibaba.nacos</groupId>
                    <artifactId>nacos-client</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
            <version>1.1.0</version>
        </dependency>
    </dependencies
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

application.properties文件中

-- 微服务端口
server.port=8045
-- 微服务名
spring.application.name=demo01
 -- 配置 Nacos server 的地址
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

启动类中加注解@EnableDiscoveryClient

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

启动微服务登录nacos,即可看到服务注册上去了

在这里插入图片描述

启动配置管理

pom文件引入spring-cloud-starter-alibaba-nacos-config

修改application.properties 成bootstrap.properties(或者yml,但注意后面添加配置的时候dataId需要同步修改后缀)并增加 spring.cloud.nacos.config.server-addr=127.0.0.1:8848

spring.cloud.nacos.config.server-addr=127.0.0.1:8848

	<dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
            <version>0.2.1.RELEASE</version>
 	</dependency>

如果application.properties 不修改成bootstrap.properties启动微服务，会报错如下。因为是bootstrap.yml 是被一个父级的 Spring ApplicationContext 加载的。这个父级的 Spring ApplicationContext是在加载application.yml 的 ApplicationContext之前先加载的

Caused by: com.alibaba.nacos.api.exception.NacosException: endpoint is blankat 
at com.alibaba.nacos.client.config.impl.ServerListManager.<init>(ServerListManager.java:154) ~[nacos-client-1.1.0.jar:na]
at com.alibaba.nacos.client.config.http.ServerHttpAgent.<init>(ServerHttpAgent.java:244) ~[nacos-client-1.1.0.jar:na]
at com.alibaba.nacos.client.config.NacosConfigService.<init>(NacosConfigService.java:83) ~[nacos-client-1.1.0.jar:na]
... 15 common frames omitted

nacos配置中心添加配置如下图

Data Id : demo01.properties (注意不能写错，如果项目加了注解@Value获取值，获取不到，启动会报错)

dataId 的完整格式如下   ${prefix}-${spring.profiles.active}.${file-extension}
prefix 默认为 spring.application.name 的值，也可以通过配置项 spring.cloud.nacos.config.prefix来配置。
spring.profiles.active 即为当前环境对应的 profile，详情可以参考 Spring Boot文档。 注意：当 spring.profiles.active 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成 ${prefix}.${file-extension}
file-exetension 为配置内容的数据格式，可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml/yml 类型。properties可默认不配置，但是yml需要在配置

注意设置值时候的配置格式，当配置文件为properties的时候，最常用的可以设置为TEXT/JSON/YAML/Properties。当配置文件为yml的时候，最常用的可以设置成YAML(别设置成text,可能会取不到)
在这里插入图片描述

在这里插入图片描述

编写测试类
在测试类上加注解@RefreshScope 实现配置自动更新
```
@RestController
@RefreshScope
public class DemoController {
  @Value("${testDemo}")
  String testDemo;
  @RequestMapping("/demo/getCode")
  public String getCode() {
      return "testDemo:"+testDemo;
  }
}
```
在浏览器测试url（http://127.0.0.1:8045/demo/getCode），当nacos里面的配置改变时，nacos会自动通知项目已更新值(如下图提示)，再次调用显示的是最新值了