Nacos系列(一)：Nacos环境安装及Hello World示例

深藏阁楼爱情的钟 2023-03-13 05:06 14阅读 0赞

现在微服务架构越来越火，微服务架构中比较重要的一项就是**配置中心**，

Nacos是阿里巴巴的一个开源项目，它的其中一个功能就是可以作为配置中心，实现配置的动态变更、历史版本对比、配置回滚等功能。

更多的描述细节请查看官网：[https://nacos.io/zh-cn/][https_nacos.io_zh-cn]。

本篇博客主要讲解以下内容：

1.  Nacos环境安装(Windows&Linux)
2.  Spring Boot项目接入Nacos配置中心
3.  初识Nacos控制台

## 1. Nacos环境安装(Windows) ##

下载地址：[https://github.com/alibaba/nacos/releases][https_github.com_alibaba_nacos_releases]。

下载官方推荐的稳定版本1.1.4：  
![format_png][]

下载完成后将其解压到你需要的目录，我这里解压到了D:\\Tools\\nacos，解压完成后目录如下图所示：

![format_png 1][]

打开bin文件夹，双击运行startup.cmd即可启动Nacos服务端。

![format_png 2][]

启动时会看到下图所示的界面：

![format_png 3][]

![format_png 4][]

启动成功后，会发现根目录下自动创建了2个文件夹，如下图所示：

![format_png 5][]

bin文件夹下自动创建了2个文件夹和1个文件，如下图所示：  
![format_png 6][]

如果需要停止Nacos服务端，有以下2种方式可以选择：

1.  将刚刚运行时打开的cmd窗口关闭
2.  双击运行bin文件夹下的shutdown.cmd
    
    ![format_png 7][]

## 2. Nacos环境安装(Linux) ##

将上面下载的zip压缩包上传到Linux服务器，我这里上传到了我的阿里云服务器的`/usr/local`目录下：

![format_png 8][]

然后执行如下命令进行解压：

cd /usr/local
    
    unzip nacos-server-1.1.4.zip

![format_png 9][]

![format_png 10][]

然后执行如下命令启动Nacos服务端，如下所示：

cd nacos/bin
    
    sh startup.sh -m standalone

![format_png 11][]

如果需要停止Nacos服务端，可以执行如下命令：

sh shutdown.sh

![format_png 12][]

## 3. Spring Boot项目接入Nacos配置中心 ##

首先，需要在pom.xml文件中引入以下依赖：

<dependency>
       <groupId>com.alibaba.boot</groupId>
       <artifactId>nacos-config-spring-boot-starter</artifactId>
       <version>0.2.3</version>
    </dependency>

然后在`application.yml`中添加Nacos Server的地址：

nacos:
      config:
        server-addr: 127.0.0.1:8848

如果你使用的是`application.properties`配置文件，按如下格式添加：

nacos.config.server-addr=127.0.0.1:8848

然后在启动类上添加`@NacosPropertySource`注解，`dataId`先使用示例的example，`autoRefreshed`设置为ture，开启自动刷新：  
![format_png 13][]

然后新建控制器ConfigController，并使用@NacosValue注解设置属性值，并开启自动刷新：

package com.zwwhnly.springbootaction.controller;
    
    import com.alibaba.nacos.api.config.annotation.NacosValue;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    @RequestMapping("config")
    public class ConfigController { 
    
        @NacosValue(value = "${useLocalCache:false}", autoRefreshed = true)
        private boolean useLocalCache;
    
        @RequestMapping(value = "/get", method = RequestMethod.GET)
        public boolean get() { 
            return useLocalCache;
        }
    }

运行项目，访问地址：http://localhost:8080/config/get，此时返回false，如下图所示：

![format_png 14][]

打开cmd窗口，执行如下命令，将useLocalCache的值设置为true：

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=example&group=DEFAULT_GROUP&content=useLocalCache=true"

![format_png 15][]

再次访问地址：http://localhost:8080/config/get，此时返回true，如下图所示：

![format_png 16][]

不用重启应用程序，配置就动态变更了，是不是很方便呢。

## 4. 初识Nacos控制台 ##

Nacos Server启动后，可以通过地址：http://localhost:8848/nacos/index.html，访问它的控制台。

默认会跳转到以下登录页面，默认的账号和密码为：nacos nacos。  
![format_png 17][]

登录成功后，可以在配置管理–配置列表界面，看到我们使用的dataId，也可以查看该dataId的配置详情：

![format_png 18][]

![format_png 19][]

如果想要访问阿里云服务器上部署的Nacos控制台，需要在ECS服务器的安全组规则里添加如下配置，不然访问不了：

![format_png 20][]

## 5. 源码及参考 ##

源码地址：[https://github.com/zwwhnly/springboot-action.git][https_github.com_zwwhnly_springboot-action.git]，欢迎下载。

[Nacos 快速开始][Nacos]

[Nacos Spring Boot 快速开始][Nacos Spring Boot]

[控制台手册][Link 1]

[https_nacos.io_zh-cn]: https://nacos.io/zh-cn/
[https_github.com_alibaba_nacos_releases]: https://github.com/alibaba/nacos/releases
[format_png]: /images/20230312/f8d267ae14e642b0a8ba365dbb5a4432.png
[format_png 1]: /images/20230312/7c576b5a6b9945cc802abb2ba6fc1858.png
[format_png 2]: /images/20230312/1aabd055cd124963853c6ecd3e15b01f.png
[format_png 3]: /images/20230312/deff82e553c943388eeac7b446696975.png
[format_png 4]: /images/20230312/f27b6f11d58d492ca1352615ecdf9d1d.png
[format_png 5]: /images/20230312/a4220541ea6940849abc2281b31e4fab.png
[format_png 6]: /images/20230312/bb9b0fb366014f40b796b4547ca77ad7.png
[format_png 7]: /images/20230312/fbc938b197e54bd59f2aa5a2230e8b7c.png
[format_png 8]: /images/20230312/c5fdd5d48721450c9bddea7e3d03f2f7.png
[format_png 9]: /images/20230312/ac78db0c9c24410b9706dd14b59d9c14.png
[format_png 10]: /images/20230312/a20843e8d88a4582920a3baf1ed92914.png
[format_png 11]: /images/20230312/3137fec7ec2640f29c2886847f0853d5.png
[format_png 12]: /images/20230312/ade829d89ba04c3bbd084e6c596c0770.png
[format_png 13]: /images/20230312/d067044837064ebeb9f3b018fb698ad7.png
[format_png 14]: /images/20230312/40ec218405a04d6aad336ed7fce6fc5c.png
[format_png 15]: /images/20230312/7f3db248eb06470ca98b0ba324e868e1.png
[format_png 16]: /images/20230312/da3aade4db3b41c1bd5899d652b6f7f9.png
[format_png 17]: /images/20230312/dbaf5c16429b41ee8c308ebbe8689d35.png
[format_png 18]: /images/20230312/1522e6195818475aa7216d79b1062e51.png
[format_png 19]: /images/20230312/63a56c571c6546d78104c46339218c03.png
[format_png 20]: /images/20230312/77e485ef5ec446b9954c598cd8333bf2.png
[https_github.com_zwwhnly_springboot-action.git]: https://github.com/zwwhnly/springboot-action.git
[Nacos]: https://nacos.io/zh-cn/docs/quick-start.html
[Nacos Spring Boot]: https://nacos.io/zh-cn/docs/quick-start-spring-boot.html
[Link 1]: https://nacos.io/zh-cn/docs/console-guide.html