控制台手册

Nacos 控制台 主要旨在于增强对于服务列表，健康状态管理，服务治理，分布式配置管理等方面的管控能力，以便进一步帮助用户降低管理微服务应用架构的成本，将提供包括下列基本功能:

  • 服务管理
    • 服务列表及服务健康状态展示
    • 服务元数据存储及编辑
    • 服务流量权重的调整
    • 服务优雅上下线
  • 配置管理
    • 多种配置格式编辑
    • 编辑 DIFF
    • 示例代码
    • 推送状态查询
    • 配置版本及一键回滚
  • 命名空间
  • 登录管理

特性详解

服务管理

开发者或者运维人员往往需要在服务注册后，通过友好的界面来查看服务的注册情况，包括当前系统注册的所有服务和每个服务的详情。并在有权限控制的情况下，进行服务的一些配置的编辑操作。Nacos 在这个版本开放的控制台的服务发现部分，主要就是提供用户一个基本的运维页面，能够查看、编辑当前注册的服务。

服务列表管理

服务列表帮助用户以统一的视图管理其所有的微服务以及服务健康状态。整体界面布局是左上角有服务的搜索框和搜索按钮，页面中央是服务列表的展示。服务列表主要展示服务名、集群数目、实例数目、健康实例数目和详情按钮五个栏目。

在服务列表页面点击详情，可以看到服务的详情。可以查看服务、集群和实例的基本信息。

服务流量权重支持及流量保护

Nacos 为用户提供了流量权重控制的能力，同时开放了服务流量的阈值保护，以帮助用户更好的保护服务服务提供者集群不被意外打垮。如下图所以，可以点击实例的编辑按钮，修改实例的权重。如果想增加实例的流量，可以将权重调大，如果不想实例接收流量，则可以将权重设为 0。

服务元数据管理

Nacos 提供多个维度的服务元数据的暴露，帮助用户存储自定义的信息。这些信息都是以 K-V 的数据结构存储，在控制台上，会以 k1=v1,k2=v2 这样的格式展示。类似的，编辑元数据可以通过相同的格式进行。例如服务的元数据编辑，首先点击服务详情页右上角的 “ 编辑服务 “ 按钮，然后在元数据输入框输入：version=1.0,env=prod。

点击确认，就可以在服务详情页面，看到服务的元数据已经更新了。

服务优雅上下线

Nacos 还提供服务实例的上下线操作，在服务详情页面，可以点击实例的 “ 上线 “ 或者 “ 下线 “ 按钮，被下线的实例，将不会包含在健康的实例列表里。

配置管理

Nacos 支持基于 Namespace 和 Group 的配置分组管理，以便用户更灵活的根据自己的需要按照环境或者应用、模块等分组管理微服务以及 Spring 的大量配置，在配置管理中主要提供了配置历史版本、回滚、订阅者查询等核心管理能力。

多配置格式编辑器

Nacos 支持 YAML、Properties、TEXT、JSON、XML、HTML 等常见配置格式在线编辑、语法高亮、格式校验，帮助用户高效编辑的同时大幅降低格式错误带来的风险。

Nacos 支持配置标签的能力，帮助用户更好、更灵活的做到基于标签的配置分类及管理。同时支持用户对配置及其变更进行描述，方便多人或者跨团队协作管理配置。

编辑 DIFF

Nacos 支持编辑 DIFF 能力，帮助用户校验修改内容，降低改错带来的风险。

示例代码

Nacos 提供示例代码能力，能够让新手快速使用客户端编程消费该配置，大幅降低新手使用门槛。

监听者查询

Nacos 提供配置订阅者即监听者查询能力，同时提供客户端当前配置的 MD5 校验值，以便帮助用户更好的检查配置变更是否推送到 Client 端。

配置的版本及一键回滚

Nacos 通过提供配置版本管理及其一键回滚能力，帮助用户改错配置的时候能够快速恢复，降低微服务系统在配置管理上的一定会遇到的可用性风险。

命名空间管理

Nacos 基于 Namespace 帮助用户逻辑隔离多个命名空间，这可以帮助用户更好的管理测试、预发、生产等多环境服务和配置，让每个环境的同一个配置（如数据库数据源）可以定义不同的值。

登录管理

Nacos0.8 版本支持简单登录功能，默认用户名 / 密码为：nacos/nacos。

修改默认用户名 / 密码方法

  1. 生成加密密码，在 com.alibaba.nacos.console.utils.PasswordEncoderUtil.main 函数中，将 nacos 改成你要改成的密码，运行即可得到加密有算法。注意盐值是随机的，所以生成密码每次可能不一样，请不要担心。
1
2
3
4
5
6
7
public class PasswordEncoderUtil {

    public static void main(String[] args) {
        System.out.println(new BCryptPasswordEncoder().encode("nacos"));
    }
}

  1. 创建用户名或者密码的时候，用指定用户名密码即可。
1
2
3
INSERT INTO users (username, password, enabled) VALUES ('nacos', '$2a$10$EuWPZHzz32dJN7jexM34MOeYirDdFAZm2kuWj7VEOJhhZkDrxfvUu', TRUE);
INSERT INTO roles (username, role) VALUES ('nacos', 'ROLE_ADMIN');

关闭登录功能

由于部分公司自己开发控制台，不希望被 nacos 的安全 filter 拦截。因此 nacos 支持定制关闭登录功能找到配置文件 ${nacoshome}/conf/application.properties，替换以下内容即可。

1
2
3
4
5
6
7
8
9
10
## spring security config
### turn off security
spring.security.enabled=false
management.security=false
security.basic.enabled=false
nacos.security.ignore.urls=/**

#nacos.security.ignore.urls=/,/**/*.css,/**/*.js,/**/*.html,/**/*.map,/**/*.svg,/**/*.png,/**/*.ico,/console-fe/public/**,/v1/auth/login,/v1/console/health,/v1/cs/**,/v1/ns/**,/v1/cmdb/**,/actuator/**


会话时间

默认会话保持时间为 30 分钟。30 分钟后需要重新登录认证。暂时不支持修改该默认时间。

社区参与的前端共建

在 Nacos 前端风格、布局的讨论中，社区踊跃投票，最终选择了这套经典黑白蓝风格的皮肤，并且通过我们 UED 程瑶同学的设计，布局，让交互变得十分自然流畅。

在控制台的开发之前，我们通过社区招募到了很多前端同学一起参与了前端代码的开发，在此尤其感谢李晨、王庆、王彦民同学在 Nacos 前端开发过程中的大力支持！

更多与 Nacos 相关的开源项目信息：