通过Nacos管理服务 - 微服务引擎MSE

前提条件

开通MSE。
创建Nacos引擎且Nacos引擎版本需要升级至2.0.3.0及以上。具体操作，请参见升级Nacos引擎版本。
创建命名空间。

创建服务

说明

您可以通过控制台创建空服务（即提供者数量为0），用于提前定义服务或进行测试。需要打开隐藏空服务开关，服务列表中才能够显示该空服务。

登录MSE注册配置中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择注册配置中心 > 实例列表。
在实例列表页面，单击目标实例名称。
在左侧导航栏，选择服务管理 > 服务列表。在页面左上角选择命名空间，然后单击创建服务。

在创建服务面板，配置相关参数，然后单击确定。

Nacos版本为2.1.2.1及以上

配置项	描述
服务名称	自定义服务的名称。
分组名称	自定义服务所归属的分组名称。
实例来源	选择实例来源。包括控制台注册和SDK注册。
保护阈值	当实例来源为控制台注册、SDK注册时，您需要设置保护阈值。建议您设置为能承载最大流量的最少节点数的所占比例，例如您有10个实例节点，最少有6个节点就可以承载最大流量，低于6个节点就可能会导致雪崩，则保护阈值为0.6。

Nacos版本为2.0.3.0 ~ 2.1.2.0

配置项	描述
服务名称	自定义服务的名称。
分组名称	自定义服务所归属的分组名称。
持久化	该服务及其实例是否被持久化。
保护阈值	该服务下的健康实例占总实例数比例不足阈值时，触发保护阈值，用于防止雪崩效应。允许范围为0~1，默认为0。更多信息，请参见MSE注册配置中心高可用最佳实践。

删除服务实例

说明

删除服务实例操作只对设置了持久化的服务实例（非临时实例）有效。

登录MSE注册配置中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择注册配置中心 > 实例列表。
在实例列表页面，单击目标实例名称。
在左侧导航栏，选择服务管理 > 服务列表。在页面左上角，选择命名空间，单击目标服务操作列下方的更多> 删除，然后在对话框中单击确定。

查看服务详情

登录MSE注册配置中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择注册配置中心 > 实例列表。
在实例列表页面，单击目标实例名称。
在左侧导航栏，单击服务管理 > 服务列表，并在页面左上角，选择命名空间。
在该命名空间下，您可以查看该Nacos上所有服务的信息，如服务名称、分组名称、提供者数量以及集群数。

后续相关操作如下。
- 查看服务详情：单击目标服务，查看服务详情。
  - 在服务详情页面上方，可查看服务的基础信息，包括服务名称、服务分组、是否持久化服务以及集群数等信息。
  - 单击提供者页签，可以查看所有提供当前服务的实例，实例以集群维度进行展示，默认展示第一个集群的提供者。
    - 在页面左侧的全部集群区域，单击目标集群名称切换集群。
    - 在目标实例操作列，可以编辑提供者的权重、上线实例、下线实例、删除实例以及查看元数据。
  - 单击订阅者页签，可以查看所有订阅当前服务的客户端实例列表。列表中可以查看订阅者的 IP 地址（客户端 IP）、客户端版本（如 Nacos-Java-Client:v1.4.1）及应用名等信息。
  - 单击推送轨迹页签，可以查看当前服务推送轨迹的详细信息，包括推送时间、推送客户端IP、推送服务名称、推送服务分组、服务实例数量以及节点名称等信息。
- 删除服务：在服务详情页面的操作列，单击删除，然后在对话框中单击确定。
  重要
  
  仅允许删除空服务，当服务数量不为0时，删除按钮为置灰状态。
  
  服务如果保持空服务状态大于1分钟，Nacos会自动删除此服务。

为服务添加实例

您可以通过控制台向任意服务中添加新的实例（即服务提供者），用于提前定义实例或进行测试。

登录MSE注册配置中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择注册配置中心 > 实例列表。
在实例列表页面，单击目标实例名称。
在左侧导航栏，选择服务管理 > 服务列表，页面左上角选择命名空间。
单击目标服务，查看服务详情。

单击提供者页签，然后单击创建实例，在创建实例对话框，配置相关参数，并单击确定。

配置项	描述
IP	输入实例的IP地址。
PORT	输入实例的端口。
Cluster Name	输入实例的所属集群，在Nacos中进行集群的逻辑区分，默认为DEFAULT。
上下线状态	选择实例初始时的上下线状态，默认为是（即上线状态）。
权重	设置实例的权重值，范围为0~10000，默认为1。流量会按照权重进行分配，权重越大，流量越多。如果您设置的权重没有生效，请参见如何解决Nacos上修改服务实例的权重不生效问题。

上线或下线应用实例

说明

实例上线或下线功能是对Nacos中的具体实例进行操作。

登录MSE注册配置中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择注册配置中心 > 实例列表。
在实例列表页面，单击目标实例名称。
在左侧导航栏，选择服务管理 > 服务列表，页面左上角选择命名空间。
单击目标服务，查看服务详情。
单击提供者页签，在目标实例的操作列，单击上线或下线，并在弹出的对话框，单击确定，即可上线或下线该实例数据。

说明

若调用上线接口的时间与服务注册完成的时间间隔过近，可能导致数据尚未同步完成，使上线操作未能生效。建议在服务注册成功后等待约 10 秒再调用上线接口，以确保操作生效。

常见问题

MSE Nacos 是否支持自定义服务心跳超时下线的时间和次数？

目前 MSE 注册中心（Nacos）的服务心跳超时下线时间由服务端固定参数控制，不支持自定义设置超时时间和超时次数。

为什么 MSE 上注册的 Nacos 服务只能加载出一个实例？

原因是在服务注册来源配置中未包含所有相关 Nacos 实例。解决方法：在 MSE 控制台的服务注册来源配置中，手动添加未加载的 Nacos 实例 ID（如 mse-580c5140），确保所有需要的 Nacos 实例都被纳入服务发现范围。

发布 metadata 报错 publish nacos metadata failed 如何处理？

报错原因是 Dubbo provider 的 metadata 内容超出了 Nacos 默认限制（参数 nacos.naming.metadata.max.total.length 默认为 4096 字节）。可通过以下方式解决：

优化 metadata 内容，将其控制在 8 KB 以内。
若业务无法缩减，请登录阿里云配额中心，搜索产品微服务引擎 MSE，找到配额项Nacos 服务元数据最大总长度（字节），提交调整申请（最大支持 8192 字节）。申请审批通过后自动生效，无需重启。

Python、Docker 等服务注册后通过域名访问报 503 Service Temporarily Unavailable 如何排查？

按以下步骤逐项排查：

检查 Nacos 控制台，确认服务已注册且实例 IP 正确。
确认服务提供者与消费者（网关）处于同一命名空间（Namespace）。
排查健康检查配置。若应用启用鉴权导致健康检查接口（如 /health）返回 401 而非 200，会被判定为不健康从而切断流量，需调整鉴权逻辑或配置正确的健康检查路径。
验证网关与后端实例的网络连通性。
在 MSE 控制台查看推送轨迹，确认实例 IP 是否正确下发给消费端。