If your Nacos instance is hosted on Microservices Engine (MSE), MSE manages the services that are registered with the Nacos instance. This topic describes how to manage services.
Prerequisites
MSE is activated. If you have not activated MSE, go to the product page to activate it.
A Nacos engine in version 2.0.3.0 or later is created. For more information about how to create a Nacos engine, see Create a Nacos engine. If the engine version is earlier than 2.0.3.0, you must upgrade the engine version. For more information about how to upgrade an engine version, see Upgrade a Nacos version.
A namespace is created. For more information, see Create a namespace.
Create a service
You can create an empty service in the MSE console to define or test the service in advance. For an empty service, no providers are available. To display an empty service in the MSE console, you must turn on Show Empty Service.
Log on to the MSE console, and select a region in the top navigation bar.
In the left-side navigation pane, choose Microservices Registry > Instances.
On the Instances page, click the name of the instance.
In the left-side navigation pane, choose Service Management > Services. On the page that appears, select a namespace from the Namespace drop-down list in the upper-left corner, and click Create service.
In the Create service panel, configure the parameters and click OK.
Nacos 2.1.2.1 or later
Parameter
Description
Service Name
The name of the service.
Group Name
The name of the group to which the service belongs.
Instance Source
The instance source. Valid values: Console and SDK.
Protection Threshold
If you set Instance Source to Console or SDK, you must specify this parameter. We recommend that you set the value to the proportion of the minimum number of nodes that can process the maximum traffic. For example, if 10 instance nodes are available, a minimum of 6 nodes can process the maximum traffic. If the number of nodes is less than 6, a system breakdown may occur. In this case, set this parameter to 0.6.
Nacos 2.0.3.0 to 2.1.2.0
Parameter
Description
Service Name
The name of the service.
Group Name
The name of the group to which the service belongs.
Persistence
Specifies whether the service and its instances are persisted.
Protection Threshold
If the ratio of healthy application instances to all application instances of the service is less than the specified threshold, the protection mechanism is triggered to prevent the system breakdown. Valid values: 0 to 1. Default value: 0.
For more information, see Implement high availability capabilities of MSE Microservices Registry.
Delete a service
You can only delete persistent services. Persistent services are not temporary services.
Log on to the MSE console, and select a region in the top navigation bar.
In the left-side navigation pane, choose Microservices Registry > Instances.
On the Instances page, click the name of the instance.
In the left-side navigation pane, choose Service Management > Services. On the page that appears, select a namespace from the Namespace drop-down list in the upper-left corner, and click More in the Actions column of the service. In the list that appears, select Delete. In the Delete Service message, click OK.
View service details
Log on to the MSE console, and select a region in the top navigation bar.
In the left-side navigation pane, choose Microservices Registry > Instances.
On the Instances page, click the name of the instance.
In the left-side navigation pane, choose Service Management > Services. On the page that appears, select a namespace from the Namespace drop-down list in the upper-left corner.
You can view the information about all services in the selected namespace of the Nacos instance. The information includes Service Name, Group Name, Number of providers, and Number of Clusters.
You can perform the following operations:
View the details of a service: Click the service name to view service details.
In the upper part of the service details page, view the basic information about the service, such as Service Name, Service Group, Persistence, and Number of Clusters.
Click the Provider tab to view all the application instances that provide the created service. Application instances are displayed by logical cluster. By default, the providers of the first logical cluster are displayed.
In the All Clusters section on the left, click the name of the logical cluster to view the information about application instances in the cluster.
In the Actions column of the application instance that you want to manage, edit the weight value, start the instance, shut down the instance, delete the instance, or view metadata.
Click the Subscriber tab to view a list of clients that subscribe to the current service. In the list, you can view the IP addresses and client versions of subscribers.
Click the Push track tab to view the push tracking details of the current service, such as Push Time, Push Client IP Address, Push service name, Push Service Group, Number of Instances, and Node name.
Delete a service: On the service details page, find the service that you want to delete, and click Delete in the Actions column. In the Delete Service message, click OK.
ImportantMSE allows you to only delete empty services. If the number of providers is not 0, the Delete button is dimmed.
If a service remains empty for more than 1 minute, the Nacos instance automatically deletes the service.
Add application instances for a service
You can add application instances (providers) for a service in the MSE console to define or test the instances in advance.
Log on to the MSE console, and select a region in the top navigation bar.
In the left-side navigation pane, choose Microservices Registry > Instances.
On the Instances page, click the name of the instance.
In the left-side navigation pane, choose Service Management > Services. On the page that appears, select a namespace from the Namespace drop-down list in the upper-left corner
Click the service name to view service details.
Click the Provider tab, and click Create an instance. In the Create an instance dialog box, configure the parameters and click OK. The following table describes the parameters.
Parameter
Description
IP
Enter the IP address of the application instance.
Port Number
Enter the port number of the application instance.
Cluster Name
Enter the name of the logical cluster to which the application instance belongs on the Nacos instance. Default value: DEFAULT.
Up and down line status
Select the initial status of the application instance. Default value: Yes. This value indicates that the initial status of the application instance is online.
Weight
Enter a weight value of the application instance. Valid values: 0 to 10000. Default value: 1. Traffic is allocated based on weights. A larger weight indicates that more traffic is allocated.
If the weight that you specify does not take effect, resolve the issue by following steps in What do I do if the modified weight of an application instance does not take effect on an MSE Nacos instance?
Start or shut down an application instance
You can start or shut down application instances that are registered with your Nacos instance.
Log on to the MSE console, and select a region in the top navigation bar.
In the left-side navigation pane, choose Microservices Registry > Instances.
On the Instances page, click the name of the instance.
In the left-side navigation pane, choose Service Management > Services. On the page that appears, select a namespace from the Namespace drop-down list in the upper-left corner.
Click the service name to view service details.
Click the Provider tab. Find the application instance that you want to manage, and click On line or Offline in the Actions column. In the message that appears, click OK.