前言

前景回顾：

• Nacos（五）：多环境下如何“读取”Nacos中相应环境的配置
• Nacos（四）：SpringCloud项目中接入Nacos作为配置中心

现如今，在微服务体系中，一个系统往往被拆分为多个服务，每个服务都有自己的配置文件，然后每个系统往往还会准备开发环境、测试环境、正式环境

我们来说算一算，假设某系统有10个微服务，那么至少有10个配置文件吧，三个环境（dev\test\prod），那就有30个配置文件需要进行管理。

这么多的配置文件，要修改一个或者多个的时候，稍有不慎可能就会出现改错了、不生效…等等问题。

那么如果引入Nacos作为配置中心后，如何有效的进行配置文件的管理和不同环境间的隔离区分呢？

别担心，Namespace可以帮助我们进行多环境下的管理和隔离

有了上一篇文章的介绍，本文主要从以下几个方面介绍：

• Namespace是什么
• Namespace如何进行配置和服务的管理、隔离
• 创建和获取NamespaceID
• Namespace实施方案1
• Namespace实施方案2

Namespace

Nacos引入了命名空间(Namespace)的概念来进行多环境配置和服务的管理及隔离

Namespace也是官方推荐的多环境支持方案。

如何进行配置和服务的管理、隔离

当我们的服务达到一定的数量，集中式的管理许多服务会十分不便，

那我们可以将这些具有相同特征或属性的服务进行分组管理，服务对应的配置也进行分组隔离

这里的分组就是Namespace的概念，将服务和配置纳入相同的Namespace进行管理

不同Namespace下的服务和配置之间就隔离开来

创建和获取NamespaceID

NamespaceId值是在配置文件配置时必须要填入的配置项，所以需要我们先创建Namespace和Id，步骤如下：

nacos 的控制台左边功能栏看到有一个命名空间的功能，点击就可以看到新建命名空间 的按钮

新建成功后，可以在命名空间列表中查看到你所创建的Namespace和他生成的ID值

这里只是讲解创建步骤，本文继续延用Nacos（五）中创建的DEV、TEST

Namespace实施方案1

Nacos给出了两种Namespace的实践方案

• 面向一个租户
• 面向多个租户

方案1主要说明一下面向一个租户

从一个租户(用户)的角度来看，如果有多套不同的环境，那么这个时候可以根据指定的环境来创建不同的 namespce，以此来实现多环境的隔离。

例如，你可能有dev，test和prod三个不同的环境，那么使用一套 nacos 集群可以分别建以下三个不同的 namespace。如下图所示：

这里的单租户同样也适于小型项目，或者是项目不太多时的实施方案

通过定义不同的环境，不同环境的项目在不同的Namespace下进行管理，不同环境之间通过Namespace进行隔离

当多个项目同时使用该Nacos集群时，还可以通过Group进行Namespace内的细化分组

这里以Namespace：dev为例，在Namespace中通过不同Group进行同一环境中不同项目的再分类

有了以上思路，我们通过代码来实践一下

Namespace下新建配置文件

启动Nacos-Server，进入Nacos控制台，切换到Namespace：dev界面，新建配置文件

• DataId:nacos-namespace-one-dev.yml
• Group:namespace-one
• 配置格式：YAML
• 配置内容：

  1 2	nacos: config: 项目：nacos-namespace-one，Namespace：dev

继续新建配置文件

• DataId:nacos-namespace-two-dev.yml
• Group:namespace-two
• 配置格式：YAML
• 配置内容：

  1 2	nacos: config: 项目：nacos-namespace-two，Namespace：dev

切换到Namespace：test环境，按照dev中的创建方式，分别创建nacos-namespace-one-test.yml和nacos-namespace-two-test.yml

注意检查DataId是否正确、group、配置内容与环境是否匹配

创建项目

在聚合工程Nacos下创建名为nacos-namespace-one的子项目，该工程的依赖文件和启动类的代码与Nacos（四）完全一致。

以下NamespaceId均来自创建Namespace时生成的Id，在控制台命名空间页面中可以查看

创建dev环境配置文件bootstrap-dev.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

server:
  port: 9911
spring:
  application:
    name: nacos-namespace-one
  profiles:
    active: dev
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
        namespace: edbd013b-b178-44f7-8caa-e73071e49c4d
        group: namespace-one
      config:
        server-addr: 127.0.0.1:8848
        prefix: ${spring.application.name}
        file-extension: yml
        namespace: edbd013b-b178-44f7-8caa-e73071e49c4d
        group: namespace-one

创建test环境配置文件bootstrap-dev.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

server:
  port: 9912

spring:
  application:
    name: nacos-namespace-one
  profiles:
    active: test
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
        namespace: 0133bd1e-25c3-4985-96ed-a4e34efdea2e
        group: namespace-one
      config:
        server-addr: 127.0.0.1:8848
        prefix: ${spring.application.name}
        file-extension: yml
        namespace: 0133bd1e-25c3-4985-96ed-a4e34efdea2e
        group: namespace-one

重复以上操作，再创建一个名为nacos-namespace-two的子项目

nacos-namespace-two项目的dev和test启动端口分别设置为9921和9922，group为：namespace-two

记得修改spring.application.name、namespace和group

启动工程

分别启动两个项目的两个环境（四个启动类）,如下图

现在我们有2个项目：nacos-namespace-one和nacos-namespace-two

2个项目分别有两个不同的环境dev和test

此时观察Nacos-Server控制台如下：

尝试访问接口来获取配置信息，验证是否可以读取相应环境配置

1
2
3
4

访问127.0.0.1:9911/getValue,返回：项目：nacos-namespace-one，Namespace：dev
访问127.0.0.1:9912/getValue,返回：项目：nacos-namespace-one，Namespace：test
访问127.0.0.1:9921/getValue,返回：项目：nacos-namespace-two，Namespace：dev
访问127.0.0.1:9922/getValue,返回：项目：nacos-namespace-two，Namespace：test

通过以上实验，方案1可以达到多环境多项目下的服务、配置管理的目标

方案1通过Namespace来隔离不同的环境（dev\test）,在具体的环境Namespace中通过Group来管理不同的项目

Namespace实施方案2

了解了单租户的方案1，再来看看Nacos推荐的面向多租户的方案2

从多个租户(用户)的角度来看，每个租户(用户)可能会有自己的 namespace,每个租户(用户)的配置数据以及注册的服务数据都会归属到自己的 namespace 下，以此来实现多租户间的数据隔离。

例如超级管理员分配了三个租户，分别为张三、李四和王五。张三负责A项目，李四负责B项目，王五负责C项目

分配好了之后，各租户用自己的账户名和密码登录后，创建自己的命名空间。如下图所示：

方案2通过Namespace来隔离多租户之间的服务和配置，但不仅于此，他有很好的扩展性

在该方案中，Group同样也有用武之地。

需求改变下，公司发展迅速业务调整，张三负责A项目、B项目、C项目，李四负责D项目、E项目、F项目，王五负责G项目、H项目、I项目,

而每个项目又分了dev、test、prod三个环境，继续沿用之前的Namespace隔离租户方案，显得有些管理不便，这时候可以在NameSpace中加入Group进行项目环境分组，如图：

但是当业务规模更大的时候（不考虑Nacos集群能否支持的因素），张三、李四、王五每人都负责10多个项目时，即项目数>环境数时，可以通过Group进行项目分组，如下图：

通过上面的理论分析，可以看出方案二有很好的扩展性

依旧如上，我们通过代码来实践一下方案2（Namespace隔离租户 + group环境分组）

场景描述

依旧使用上面的两个项目，假设现在有两个租户，张三、李四

张三负责项目：nacos-namespace-one, 李四负责项目：nacos-namespace-two，项目分别有dev和test环境

新建Namespace和配置文件

新建两个Namespace来隔离租户，分别为zhangsan、lisi

在Namespace：zhangsan 下创建配置文件

• DataId:nacos-namespace-one-dev.yml
• Group:namespace-one-dev
• 配置格式：YAML
• 配置内容：

  1 2	nacos: config: 项目：nacos-namespace-one，Namespace：张三，环境：dev

继续创建test环境配置文件

• DataId:nacos-namespace-one-test.yml
• Group:namespace-one-test
• 配置格式：YAML
• 配置内容：

  1 2	nacos: config: 项目：nacos-namespace-one，Namespace：张三，环境：test

参照以上操作，在Namespace：lisi命名空间中创建配置文件nacos-namespace-two-dev.yml和nacos-namespace-two-test.yml

注意核对DataId、Group、和配置内容

修改项目的配置文件bootstrap.yml

修改项目nacos-namespace-one的dev配置文件bootstrap-dev.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

server:
  port: 9911
spring:
  application:
    name: nacos-namespace-one
  profiles:
    active: dev
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848

        namespace: e0d75068-a12c-4314-9296-3f396139d5b3
        group: namespace-one-dev
      config:
        server-addr: 127.0.0.1:8848
        prefix: ${spring.application.name}
        file-extension: yml

        namespace: e0d75068-a12c-4314-9296-3f396139d5b3
        group: namespace-one-dev

修改test配置文件bootstrap-test.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

server:
  port: 9912
spring:
  application:
    name: nacos-namespace-one
  profiles:
    active: test
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848

        namespace: e0d75068-a12c-4314-9296-3f396139d5b3
        group: namespace-one-test
      config:
        server-addr: 127.0.0.1:8848
        prefix: ${spring.application.name}
        file-extension: yml

        namespace: e0d75068-a12c-4314-9296-3f396139d5b3
        group: namespace-one-test

重复以上操作相应的修改项目nacos-namespace-two的dev和test配置文件

主要修改namespace和group属性，与命名空间lisi的ID和其下配置文件的Group对应

启动项目

分别启动两个项目的两个环境（四个启动类），启动成功如下图

此时两个项目分别启动两个环境后，注册到Nacos上不同的Namespace下，并读取相应环境的配置，具体如下：

nacos-namespace-one

• dev: 注册到Namespace：zhangsan，读取Namespace：zhangsan下Group：namespace-one-dev的配置
• test: 注册到Namespace：zhangsan，读取Namespace：zhangsan下Group：namespace-one-test的配置

nacos-namespace-two

• dev: 注册到Namespace：lisi，读取Namespace：lisi下Group：namespace-two-dev的配置
• test: 注册到Namespace：lisi，读取Namespace：lisi下Group：namespace-two-test的配置

此时Nacos控制台如下图：

ok我们来测试下各个环境的服务能否访问到对应的配置

1
2
3
4

访问127.0.0.1:9911/getValue,返回：项目：nacos-namespace-one，Namespace：张三，环境：dev
访问127.0.0.1:9912/getValue,返回：项目：nacos-namespace-one，Namespace：张三，环境：test
访问127.0.0.1:9921/getValue,返回：项目：nacos-namespace-two，Namespace：李四，环境：dev
访问127.0.0.1:9922/getValue,返回：项目：nacos-namespace-two，Namespace：李四，环境：test

通过访问服务的接口，各个服务都可以准确的读取到各自环境下的配置文件

方案二可以看到同样支持服务和配置的隔离分组，同时支持业务的扩展，有较好的扩展性

问题描述

但是相信大家已经发现了一个问题，当使用的Group来进行分组后，配置文件相互之间可以实现不同环境与不同项目之间的分组隔离

但是服务注册后，虽然可以通过Namespace隔离，但指定的Group分组却并没有生效，依然是DEFAULT_GROUP

比如方案1 所有项目启动后Nacos服务列表页如下图

这里本应该是我们自定义的分组namespace-one和namespace-two却没有生效

由此发现，配置之间是达到了相互分组隔离名但服务列表暂时并不支持。

但是不要担心，Nacos的社区极度活跃，社区的大佬们也发现了这一情况，并且在Nacos-client的源码中可以看到NameingService在加载配置文件时是有预留Group这一属性字段的。

所以既然Nacos提供了这一实践方案，正常使用只不过是时间问题。

总结

以上分析了Nacos对于Namespace提供的两种实践方案，同时进行了代码实验，均达到了预期的要求。

现对两种方案进行一个总结

• 单租户方案（方案1）：适合小型项目，服务数量不多时，方案一完全够用
• 多租户方案（方案2）：适合项目量多，有一定的团队规模，且服务数量较多时，可以相对条理清晰的管理和隔离配置及服务。

本文源码：https://github.com/larscheng/larscheng-learning-demo/tree/master/Nacos

参考与感谢

Namespace最佳实践