作者 | 磊哥

來源 | Java中文社群(ID：javacn666)

轉(zhuǎn)載請聯(lián)系授權(quán)(微信ID：GG_Stone)

Nacos 中的參數(shù)有很多，如：命名空間、分組名、服務(wù)名、保護(hù)閾值、服務(wù)路由類型、臨時(shí)實(shí)例等，那這些參數(shù)都是什么意思?又該如何設(shè)置?接下來我們一起來盤它。

1.命名空間

在 Nacos 中通過命名空間(Namespace)+ 分組(Group)+服務(wù)名(Name)可以定位到一個(gè)唯一的服務(wù)實(shí)例。

命名空間(Namespace)：Nacos 服務(wù)中最頂層、也是包含范圍最廣的概念，用于強(qiáng)制隔離類似環(huán)境或租戶等場景。Nacos 的服務(wù)也需要使用命名空間來進(jìn)行隔離。命名空間在 Nacos 控制臺的一級目錄里可以找到，如下圖所示：

在服務(wù)列表中也能看到命名空間的身影，如下圖所示：

1.1 命名空間用法

命名空間默認(rèn)為 public，在項(xiàng)目開發(fā)中，如果不指定命名空間，那么會使用默認(rèn)值 public。官方推薦使用運(yùn)行環(huán)境來定義命名空間，如生產(chǎn)版本可使用 public，開發(fā)版可定義為 private。在項(xiàng)目開發(fā)中，可通過配置“spring.cloud.nacos.discovery.namespace”來定義命名空間，如下圖所示：

1.2 注意事項(xiàng)

命名空間在使用前，必須先在控制臺新建命名空間，如下圖所示：

如果在控制臺沒有新建命名空間，直接在項(xiàng)目中使用的話，是不能將服務(wù)成功的注冊到 Nacos 中的，如下在項(xiàng)目中配置了一個(gè)未新建的 dev 命名空間，如下圖所示：

然后啟動項(xiàng)目，此時(shí)會發(fā)現(xiàn)，在 Nacos 控制臺的服務(wù)列表中一直刷新不到任何服務(wù)實(shí)例，如下圖所示：

2.分組名

分組名(Group)：Nacos 中次于命名空間的?種隔離概念，區(qū)別于命名空間的強(qiáng)制隔離屬性，分組屬于?個(gè)弱隔離概念，主要用于邏輯區(qū)分?些服務(wù)使用場景或不同應(yīng)用的同名服務(wù)，最常用的情況主要是同?個(gè)服務(wù)的測試分組和生產(chǎn)分組、或者將應(yīng)用名作為分組以防止不同應(yīng)用提供的服務(wù)重名。分組名在 Nacos 控制臺的服務(wù)列表中可以看到，如下圖所示：

分組名默認(rèn)為 DEFAULT_GROUP，在項(xiàng)目中可通過“spring.cloud.nacos.discovery.group”來設(shè)置，如下圖所示：

此項(xiàng)可省略，省略時(shí)的默認(rèn)值為 DEFAULT_GROUP。分組名可以直接在項(xiàng)目中使用，無需像命名空間那樣，在使用前還要在控制臺中新建，設(shè)定了分組名之后，刷新服務(wù)列表就可以看到新的分組名稱了，如下圖所示：

3.服務(wù)名

服務(wù)名(Name)：該服務(wù)實(shí)際的名字，?般用于描述該服務(wù)提供了某種功能或能力。通常推薦使用由運(yùn)行環(huán)境作為命名空間、應(yīng)用名作為分組，服務(wù)功能作為服務(wù)名的組合來確保該服務(wù)的天然唯?性，當(dāng)然使用者可以忽略命名空間和分組，僅使用服務(wù)名作為服務(wù)唯?標(biāo)示，這就需要使用者在定義服務(wù)名時(shí)額外增加自己的規(guī)則來確保在使用中能夠唯?定位到該服務(wù)而不會發(fā)現(xiàn)到錯(cuò)誤的服務(wù)上。服務(wù)名在項(xiàng)目中可以通過“spring.application.name”來指定，如下圖所示：

4.保護(hù)閾值

健康保護(hù)閾值(ProtectThreshold)：為了防止因過多實(shí)例故障，導(dǎo)致所有流量全部流入剩余實(shí)例，繼而造成流量壓力將剩余實(shí)例被壓垮形成雪崩效應(yīng)。應(yīng)將健康保護(hù)閾值定義為?個(gè) 0 到 1 之間的浮點(diǎn)數(shù)。當(dāng)域名健康實(shí)例數(shù)占總服務(wù)實(shí)例數(shù)的比例小于該值時(shí)，無論實(shí)例是否健康，都會將這個(gè)實(shí)例返回給客戶端。這樣做雖然損失了?部分流量，但是保證了集群中剩余健康實(shí)例能正常工作。簡單來說，保護(hù)閾值是一個(gè) 0-1 的浮點(diǎn)值，保護(hù)閾值是允許集群中健康實(shí)例占比的最小值，如果實(shí)際健康實(shí)例的占比小于或等于設(shè)置的保護(hù)閾值時(shí)，就會觸發(fā)閾值保護(hù)，如下圖所示，設(shè)置保護(hù)閾值為 0.75：

停掉唯一的健康實(shí)例，集群的健康實(shí)例占比降成了 0%，小于設(shè)置的保護(hù)閾值 0.75(75%)，此時(shí)就會觸發(fā)閾值保護(hù)，如下圖所示：

5.服務(wù)路由類型

服務(wù)路由類型的設(shè)置如下圖所示：

它是用來設(shè)置服務(wù)的路由策略的，默認(rèn)值為 none。如果設(shè)置此值為 label(標(biāo)簽)模式，需要設(shè)置相應(yīng)的標(biāo)簽表達(dá)式來匹配實(shí)例選擇器(Selector)，通過實(shí)例選擇器可以完成自定義負(fù)載均衡策略，比如我們可以自定義實(shí)例選擇器，實(shí)現(xiàn)就近訪問的負(fù)載均衡策略，這樣消費(fèi)者在調(diào)用時(shí)，會優(yōu)先調(diào)用離自己比較近的 IP 節(jié)點(diǎn)，從而實(shí)現(xiàn)更高效的服務(wù)調(diào)用。

6.權(quán)重

權(quán)重(Weight)：實(shí)例的級別配置。權(quán)重為浮點(diǎn)數(shù)，范圍為 0-10000。權(quán)重越大，分配給該實(shí)例的流量越大。它是針對服務(wù)實(shí)例進(jìn)行設(shè)置的，如下圖所示：

7.臨時(shí)實(shí)例

在 Nacos 中服務(wù)實(shí)例有兩種(類型)：持久化實(shí)例和臨時(shí)實(shí)例(也叫非持久化實(shí)例)。當(dāng)控制臺中“臨時(shí)實(shí)例”為 true 時(shí)，表示此服務(wù)為臨時(shí)實(shí)例，如下圖所示：

7.1 臨時(shí)實(shí)例 VS 持久化實(shí)例

臨時(shí)實(shí)例和持久化實(shí)例的區(qū)別主要有以下兩點(diǎn)：

• 臨時(shí)實(shí)例在非健康狀態(tài)下會被自動剔除，而持久化實(shí)例不會被自動剔除。
• 臨時(shí)實(shí)例的健康狀況是 Nacos 客戶端以固定頻率(5s一次)上報(bào)給 Nacos 服務(wù)器端的，而持久化實(shí)例是 Nacos 服務(wù)器端主動探測的。

7.2 實(shí)例類型設(shè)置

在項(xiàng)目開發(fā)中，可以通過設(shè)置“spring.cloud.nacos.discovery.ephemeral”來指定服務(wù)的實(shí)例類型，默認(rèn)為臨時(shí)實(shí)例，也就是默認(rèn)“spring.cloud.nacos.discovery.ephemeral=true”。如果要設(shè)置持久化實(shí)例，需要設(shè)置“spring.cloud.nacos.discovery.ephemeral”設(shè)置為 false，如下圖所示：

7.3 注意事項(xiàng)

服務(wù)的實(shí)例類型一旦確定之后，整個(gè)生命周期內(nèi)不允許被修改，如果試圖修改實(shí)例類型會提示如下錯(cuò)誤：

總結(jié)

Nacos 中通過命名空間 + 分組名 + 服務(wù)名可以定位到一個(gè)唯一實(shí)例，通常推薦使用由運(yùn)行環(huán)境作為命名空間、應(yīng)用名作為分組，服務(wù)功能作為服務(wù)名的組合來定義服務(wù)。保護(hù)閾值是犧牲?部分流量，保證集群中剩余健康實(shí)例能正常工作的一種手段。服務(wù)路由類型和權(quán)重都是用來定義 Nacos 路由規(guī)則的，而臨時(shí)實(shí)例和持久化實(shí)例是 Nacos 中的兩種實(shí)例類型。