Overview

You can manage containerized applications in batches on all nodes in the same group, including deploying, updating, and uninstalling containerized applications. Nodes and node groups are uniquely identified by IDs, which are automatically generated. The node ID, NodeName, UniqueName, and SerialNumber fields must be unique.

Constraints

A maximum of 1024 node groups are supported.
A maximum of 1024 edge nodes are supported.
A node group can contain a maximum of 1024 edge nodes.
A single edge node can be added to a maximum of 10 node groups.
Update operations other than Querying the List of Nodes That Are Not Managed by MindEdge Framework and Deleting Nodes That Are Not Managed by MEF cannot be performed on unmanaged nodes.

Node Status

ready: Kubernetes has been connected, and the node is normal.
notReady: Kubernetes has been connected, but the node status is abnormal.
unknown: The connection between the node and Kubernetes is interrupted, and the status is unknown.
offline: The node does not exist in a Kubernetes cluster, but exists in the MEF Center database.
abnormal: The connection between the node and MEF Center is abnormal.

Process of Managing Edge Nodes

The management operation involves adding nodes in a cluster to the MindEdge Framework system for management. MEF Center performs edge node management only on nodes that have been successfully managed, and refrains from operating on nodes that are yet to be managed. When calling an API, you can create a node group and add nodes to the group when managing them. Alternatively, you can manage nodes independently without adding them to any node group and then add them to one or more groups before performing operations related to containerized applications. The process is as follows:

Create a node group or use an existing node group.
This step is to add nodes to the node group to manage and operate nodes in batches. For details about the API for creating a node group, see Creating a Node Group.
```
https://{ip}:{port}/edgemanager/v1/nodegroup
```
Optional: Query the managed nodes.
This step is to find the node ID corresponding to the current MEF Edge device. For details about the API for querying unmanaged nodes, see Querying the List of Nodes That Are Not Managed by MindEdge Framework.
```
https://{ip}:{port}/edgemanager/v1/node/list/unmanaged?pageNum={pageNum}&pageSize={pageSize}&name={name}
```
Manage nodes.
- This step is to add MEF Edge node device information to the node database. All operations performed by MEF Center on nodes are based on managed nodes. For details about the API for managing nodes, see Managing Nodes.
```
https://{ip}:{port}/edgemanager/v1/node/add
```
- If the node group ID is not set during node management, refer to Adding Nodes to a Node Group to add the node to the node group before using node resources.
```
https://{ip}:{port}/edgemanager/v1/nodegroup/node
```
Optional: Modify nodes.
This step is to modify the name and description of a node based on the node ID, which serves as the unique identifier. For details about the API for modifying nodes, see Modifying Managed Nodes.
```
https://{ip}:{port}/edgemanager/v1/node
```
Optional: Delete managed nodes or remove nodes from a node group.
- Delete managed nodes.
  Delete nodes in batches based on a specified node ID array. For details about the API for deleting nodes, see Deleting Nodes Managed by MindEdge Framework.
```
https://{ip}:{port}/edgemanager/v1/node/batch-delete
```
- Remove nodes from a node group.
  - You can delete multiple nodes in batches in a node group and uninstall and delete containerized applications on the nodes. For details about the API, see Deleting Nodes from a Node Group.
```
https://{ip}:{port}/edgemanager/v1/nodegroup/node/batch-delete
```
  - By deleting the pod of a single containerized application, you can remove a node from a node group to uninstall the containerized application. For details about the API, see Uninstalling Containerized Applications.
```
https://{ip}:{port}/edgemanager/v1/nodegroup/pod/batch-delete
```

Parent topic: Node Management APIs