你應(yīng)該知道的 Nacos 接入和避坑指南

猿友 2020-08-26 10:53:38 瀏覽數(shù) (4978)

反饋

本文給大家分享一個強大的組件Nacos，它是微服務(wù)環(huán)境下必須要用到的組件。用了Nacos后，再也不用擔(dān)心服務(wù)注冊和發(fā)現(xiàn)以及配置管理混亂的問題了。

背景

Nacos 致力于幫助開發(fā)人員發(fā)現(xiàn)、配置和管理微服務(wù)，Nacos 提供了一組簡單易用的特性集，快速實現(xiàn)動態(tài)服務(wù)發(fā)現(xiàn)、服務(wù)配置、服務(wù)元數(shù)據(jù)及流量管理。

目前主流的互聯(lián)網(wǎng)服務(wù)都是基于微服務(wù)架構(gòu)的，那服務(wù)與服務(wù)之間的交互是必不可少的，而且各個服務(wù)的上下線都是相互獨立的，而且服務(wù)的配置信息也是會動態(tài)調(diào)整的，這就需要我們的服務(wù)更加靈活。Nacos 的出現(xiàn)就是幫助我們實現(xiàn)這些繁瑣的功能。

詳細(xì)的 Nacos 介紹和部署可以參考官方網(wǎng)站 Nacos.io。這里只介紹一下在 SpringBoot 項目中如何快速接入以及接入和使用過程中可能會遇到的坑。

接入

加入依賴

第一步在 pom 配置文件中加入下面的依賴，用于實現(xiàn)服務(wù)注冊發(fā)現(xiàn)和配置中心功能。

<!-- nacos 配置中心 -->
<dependency>
  <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId></dependency>
  <!-- nacos 注冊發(fā)現(xiàn) -->
<dependency>
  <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId></dependency>

增加配置

第二步在 SpringBoot 項目的啟動類上增加如下注解 @EnableDiscoveryClient 用于啟動服務(wù)注冊發(fā)現(xiàn)功能。

增加配置文件，對應(yīng)的配置信息需要修改成適合自己的，為了方便管理，應(yīng)用的分組名稱，命名空間以及相關(guān)的配置都需要合理的設(shè)置。多個業(yè)務(wù)使用同一個 nacos 集群的時候，需要根據(jù)各個的業(yè)務(wù)設(shè)定各自的命名空間。所有的配置文件都需要在對應(yīng)的命名空間下設(shè)置，避免多個業(yè)務(wù)混用，另外業(yè)務(wù)需要根據(jù)用到的組件或者配置，設(shè)定獨立的配置文件，例如數(shù)據(jù)庫的配置，Redis 的配置等都需要單獨設(shè)定，這樣是為了同一個應(yīng)用其他的其他服務(wù)也可以使用，而且再有地址變更的時候可以只修改一個文件就好，不會忘記。

# 應(yīng)用服務(wù)名稱
spring.application.name=application-name
# 應(yīng)用分組名稱
spring.cloud.nacos.config.group=GROUP-NAME
# 配置文件的后綴名
spring.cloud.nacos.config.file-extension=properties
# nacos 對應(yīng)的命名空間，在后臺創(chuàng)建好命名空間后會自動生成
spring.cloud.nacos.config.namespace=xxxxxxxxxxxxxxxxxxxxxxxxx
# 對應(yīng)的配置文件
# MySQL 相關(guān)配置
spring.cloud.nacos.config.ext-config[0].data-id=mysql.properties
spring.cloud.nacos.config.ext-config[0].group=GROUP-NAME
# Redis 相關(guān)配置
spring.cloud.nacos.config.ext-config[1].data-id=redis.properties
spring.cloud.nacos.config.ext-config[1].group=GROUP-NAME
# 其他配置等
spring.cloud.nacos.config.ext-config[2].data-id=other.properties
spring.cloud.nacos.config.ext-config[2].group=GROUP-NAME
# 配置中心地址，多個逗號分隔
spring.cloud.nacos.config.server-addr=xxx.xx.xx.xx:xxxx
# 服務(wù)注冊發(fā)現(xiàn)地址，多個逗號分隔
spring.cloud.nacos.discovery.server-addr=xxx.xx.xx.xx:xxxx
# 集群名稱
spring.cloud.nacos.discovery.cluster-name=CLUSTER-NAME

代碼中可以使用注解 @Value() 來直接讀取 Nacos 配置中的屬性參數(shù)，也可以使用 @ConfigurationProperties(prefix = "spring.datasource") 讀取批量參數(shù)。

spring.cloud.nacos.config.ext-config[0].refresh=true 該參數(shù)表示是否開啟自動更新，根據(jù)是否需要自動更新覺得是否配置，如果需要自動更新，加上這個配置后還需要在需要自動更新配置的 Bean 上面增加@RefreshScop 注解。然后對應(yīng)的 Bean 內(nèi)部的屬性就可以實現(xiàn)自動更新了。增加了spring.cloud.nacos.config.ext-config[0].refresh=true 配置后在修改了 Nacos 中的配置過后日志會出現(xiàn)下面信息，會重新加載配置，并且輸出變更的 key 信息。

服務(wù)調(diào)用

當(dāng)所有的服務(wù)都接入 Nacos 過后，我們在 Nacos 的后臺就可以看到每個服務(wù)的情況，如下圖，可以看到服務(wù)狀態(tài)。

服務(wù)狀態(tài)

然后我們在服務(wù) A 里面如果要調(diào)用服務(wù) B 的時候，就可以直接在 FeginClient 中配置服務(wù) B 的名稱，不需要填寫 URL 了。這樣我們就不用考慮服務(wù) B 是否地址和端口會不會變。服務(wù) B 的實例增加還是減少，端口是否變了，對服務(wù) A 來說都不關(guān)心，只要有個服務(wù)名稱就可以了。

服務(wù)名稱

避坑

命名空間

Nacos 有一個默認(rèn)的名為 public 的命名空間，這個命名空間是無法刪除的，所有未指定命名空間的配置都會放在該命名空間下；同樣的 Nacos 有一個默認(rèn)的名為 DEFAULT_GROUP 的分組，在沒有指定分組名稱的時候默認(rèn)的配置都是在該分組下。

對于我們應(yīng)用程序來說，由于很多情況下一個 Nacos 集群是多個團(tuán)隊共同使用的，所以為了方便管理，我們需要根據(jù)自己的業(yè)務(wù)設(shè)置自己的命名空間，用于存放本業(yè)務(wù)的配置文件。本命名空間下的配置文件，根據(jù)各個的模塊決定是否需要重新分組。

要知道在沒有清晰的命名空間劃分的時候，要想修改一個配置的內(nèi)容，是很難受的一件事情。線上的配置調(diào)整，一個不小心就是事故。如果還是自動更新配置的話，那連后悔的機(jī)會都沒有。

精細(xì)配置

配置文件應(yīng)該專一，一個配置文件就設(shè)置一個內(nèi)容，比如 MySQL 的數(shù)據(jù)源單獨一個配置，Redis 的數(shù)據(jù)源單獨一個配置，如果多個 Redis 服務(wù)，根據(jù)功能建議分開配置，因為并不是所有的服務(wù)都需要每個 Redis 的鏈接配置。各自的服務(wù)根據(jù)需要單獨引用對應(yīng)的配置文件即可。

將所有的配置獨立成一個配置文件方便后續(xù)修改配置，只要修改一個配置文件就好，不用擔(dān)心其他還有未修改的地方。

合理的規(guī)劃配置文件的內(nèi)容，往往很多時候可以事半功倍，極大的節(jié)約時間和減少出錯的概率。

自動刷新

前面介紹了如何設(shè)置配置自動刷新，不過服務(wù)是否需要自動更新配置，這個根據(jù)自身的業(yè)務(wù)去決定。

我這里一般不建議設(shè)置自動更新，因為現(xiàn)在都是微服務(wù)部署，有時候我們上線一個新功能的時候都是灰度發(fā)布，如果配置自動更新，再調(diào)整配置過后，全部實例都會生效，這樣會有風(fēng)險。不設(shè)置自動更新的話，我們可以單獨重啟個別實例，觀察線上情況，等穩(wěn)定了再發(fā)布所有服務(wù)，這樣會安全很多。

當(dāng)然對于沒有那么多服務(wù)，不需要灰度，影響不大的場景下，配置自動更新會方便很多，再修改配置后不需要重啟服務(wù)。

(推薦教程：Spring Boot 那些事)

總結(jié)

Nacos 作為服務(wù)的注冊發(fā)現(xiàn)和配置的統(tǒng)一管理確實十分出色，除了能快速接入 SpringBoot 項目之外，其他的框架都能快速的接入，更多使用可以參考官網(wǎng)。

文章來源：公眾號--Java極客技術(shù)

以上就是W3Cschool編程獅關(guān)于你應(yīng)該知道的 Nacos 接入和避坑指南的相關(guān)介紹了，希望對大家有所幫助。

SpringBoot

0 人點贊