美文网首页
Alibaba-Nacos入门

Alibaba-Nacos入门

作者: 非典型_程序员 | 来源:发表于2019-08-11 17:43 被阅读0次

    最近在做微服务项目中公司开始使用Nacos,所以决定今天简单的学习入门。Nacos致力于是微服务注册、发现和配置。和Eureka比较接近,但是功能上更为强大一些。以为这个是阿里开源的,各种文档文档都还是比较齐全的,学习中尽量参考官方文档。自己虽然在工作中使用到了Nacos但是一直没有时间去学习它的使用,因为目前微服务部署在阿里云的EDAS上,而EDAS似乎本身就集成了Nacos,所以这次单独来学习一下Nacos,主要从Nacos的安装启动开始,然后在demo中使用Nacos替换Eureka,最后学习使用Nacos如何配置服务。

    一、Nacos启动

    Nacos支持 LinuxMacWindows,根据自己喜好下载Nacos的源码或者压缩包,我下载是最新版本1.1.3版本,我看github上更新还是很快的。然后执行相关的命令启动Nacos服务:

    // linux /unix/mac
    sh startup.sh -m standalone
    // windows
    cmd startup.cmd
    

    linux环境下指定以单实例方式启动,不然会报错:
    java.io.FileNotFoundException: /home/ypcfly/ypcfly/software/nacos/nacos-server-0.9.0/nacos/conf/cluster.conf (没有那个文件或目录)
    即没有找到Nacos集群的配置文件。另外在我本地ubuntu环境下,使用上述命令也会出错,显示:

    startup.sh: 78: startup.sh: [[: not found
    startup.sh: 88: startup.sh: [[: not found
    startup.sh: 90: startup.sh: [[: not found
    startup.sh: 96: startup.sh: [[: not found
    

    需要以下面的命令启动Nacos

    bash -f ./startup.sh -m standalone
    

    让后根据控制台输出就会发现Nacos成功启动了。Nacos是自带了一个管理的界面的,浏览器输入:127.0.0.1:8848/nacos。这时候浏览器跳转到Nacos的登录页面

    图-1.png
    输入默认的用户名nacos和密码nacos就可以登录到Nacos的管理界面。里面主要有两个选项,一个是配置管理,即注册服务的相关配置;另一个是服务管理,这里可以看到所有注册的服务列表。接下来通过一个非常简单的demo来使用Nacos。

    二、使用Nacos

    快速构建一个spring boot项目,引入Nacos的相关依赖,主要就是Nacos的服务发现注册和配置两个依赖,整个demo的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 http://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.ypc.learn</groupId>
        <artifactId>nacos</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <name>nacos</name>
        <description>learn nacos</description>
    
        <properties>
            <java.version>1.8</java.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            <dependency>
                <groupId>com.alibaba.boot</groupId>
                <artifactId>nacos-config-spring-boot-starter</artifactId>
                <version>0.2.2</version>
            </dependency>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
                <version>0.2.2.RELEASE</version>
            </dependency>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
                <version>0.2.2.RELEASE</version>
            </dependency>
    
            <dependency>
                <groupId>com.alibaba.boot</groupId>
                <artifactId>nacos-discovery-spring-boot-starter</artifactId>
                <version>0.2.2</version>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
        </dependencies>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    
    </project>
    

    接着是配置文件,在项目下新建一个bootstrap.properties,配置如下:

    spring.cloud.nacos.config.server-addr=127.0.0.1:8848
    spring.cloud.nacos.config.file-extension=properties
    spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848
    
    spring.application.name=nacos-service
    

    上面配置文件指定了Nacos配置中心和注册中心的地址,并指定了配置文件后缀,nacos支持PropertiesYAMLJSON等等,但是我看文档说明目前只支持PropertiesYAML类型,配置中心使用的文件类型须和上面配置中spring.cloud.nacos.config.file-extension保持一致。
    接着在启动类上加上@EnableDiscoveryClient注解,这个在Nacos和Eureka是没有区别的,都是将服务注册到注册中心。
    使用默认端口号(8080)启动项目,然后我们在配置文件添加一个配置,配置中心的配置优先级要高于项目的配置文件,在配置中心添加配置文件时需要注意有一个dataId属性,这个值的组成如下:

    ${prefix}-${spring.profile.active}.${file-extension}
    

    prefix 默认为 spring.application.name 的值,也可以通过配置项 spring.cloud.nacos.config.prefix来配置。
    spring.profile.active 即为当前环境对应的 profile,详情可以参考 Spring Boot文档。 注意:当 spring.profile.active 为空时,dataId 变成 ${prefix}.${file-extension}
    file-exetension 为配置内容的数据格式,可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。
    因为这个demo里面没有配置spring.profile.active,所以dataId为就是应用名称 + 配置文件后缀,即nacos-service.propertiesGroup没有显性指定,所以选择默认值DEFAULT_GROUP,配置内容我们将服务端口修改为9090。

    图-2.png
    然后重新启动服务,看看服务启动的控制台日志:
    图-3.png
    根据日志输出发现tomcat的端口号已经改成了9090了,说明Nacos配置中心的配置是生效了,而且也显示服务已经注册完成了。但是在Nacos服务列表查询的的时候会自动从Nacos管理页面退出,这个有点奇怪.....看了下日志:
    2019-08-11 17:13:46,238 INFO [NACOS-RAFT] datum is changed, key: com.alibaba.nacos.naming.iplist.ephemeral.public##DEFAULT_GROUP@@nacos-service, value: {"cachedChecksum":"","instanceList":[{"app":"","clusterName":"DEFAULT","enabled":true,"ephemeral":true,"healthy":true,"instanceHeartBeatInterval":5000,"instanceHeartBeatTimeOut":15000,"instanceId":"192.168.199.151#9090#DEFAULT#DEFAULT_GROUP@@nacos-service","ip":"192.168.199.151","ipDeleteTimeout":30000,"lastBeat":1565514826238,"marked":false,"metadata":{"preserved.register.source":"SPRING_CLOUD"},"port":9090,"serviceName":"DEFAULT_GROUP@@nacos-service","tenant":"","weight":1.0}]}
    
    2019-08-11 17:13:46,240 INFO [NACOS-RAFT] datum is changed, key: com.alibaba.nacos.naming.iplist.ephemeral.public##DEFAULT_GROUP@@nacos-service, value: {"cachedChecksum":"","instanceList":[{"app":"DEFAULT","clusterName":"DEFAULT","enabled":true,"ephemeral":true,"healthy":true,"instanceHeartBeatInterval":5000,"instanceHeartBeatTimeOut":15000,"instanceId":"192.168.199.151#9090#DEFAULT#DEFAULT_GROUP@@nacos-service","ip":"192.168.199.151","ipDeleteTimeout":30000,"lastBeat":1565514826240,"marked":false,"metadata":{"preserved.register.source":"SPRING_CLOUD"},"port":9090,"serviceName":"DEFAULT_GROUP@@nacos-service","tenant":"","weight":1.0}]}
    
    2019-08-11 17:13:54,342 INFO receive config info: unknown#192.168.199.151:8848#1565514834342#2
    
    

    以为是ip的问题,但是修改了Nacos注册中心和配置中心以后还是不行。控制台显示是注册完成,但是可能实际上并没有注册完成。暂时网上也没找到相关问题,这个问题只能暂时留着以后解决了。

    三、总结

    Nacos从功能上来看确实要比Eureka多些,但是因为Nacos还没有大规模使用,所以稳定性还有待证明。总的来说感觉坑还是很多,喜欢的小伙伴可以尝试下。今天虽然只是简单的入门,但是中间遇到了好几个坑,比如单例启动,还有就ubuntu下启动方式和文档不一致等,另外其实中途还遇到了这个异常:
    java.lang.IllegalStateException: failed to req API:/nacos/v1/ns/instance after all servers([127.0.0.1:8848]) tried
    网上找了一下发现很多人都遇到这个异常,但是并没有找到解决方案。最后自己更换了Nacos版本就解决了,但是服务列表又不使用了,尴尬。现在只能等着社区有没有相关的答案和解决方案了。总的来说我觉得上生产环境的话还是慎重一些.....


    更新:今天在阿里云环境上也遇到了服务不能正常注册的问题,后来问了同事,需要添加一项配置:

    spring.cloud.nacos.discovery.watch.enabled=false
    

    然后重启服务在到Nacos看服务列表,发现服务注册成功了


    图-4.png

    相关文章

      网友评论

          本文标题:Alibaba-Nacos入门

          本文链接:https://www.haomeiwen.com/subject/cgtsjctx.html