Skip to content

NodeSets

Anton Kremenetsky edited this page Sep 16, 2025 · 1 revision

Node Sets

A NodeSet is a group of ordinary nodes launched from the same image. Other characteristics of nodes are also the same. Numbers of cores, memory amount, root disk size and so on. The number of nodes in the set is controlled by replicas field. Different sets types can interpretate this field differently but the default set use it as a number of nodes in the set.

Basic example of node set creation:

curl --location 'http://10.20.0.2:11010/v1/sets/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "uuid": "00000000-0000-0000-0000-000000000001",
    "name": "set",
    "project_id": "00000000-0000-0000-0000-000000000000",
    "root_disk_size": 10,
    "cores": 1,
    "ram": 1024,
    "replicas": 3,
    "image": "http://10.20.0.1:8080/genesis-base.raw"
}'

This request creates a set with count of replicas=3. That means under the hood three nodes will be created.

The main fields are:

  • uuid - uuid of the set.
  • name - name of the set.
  • project_id - it's a project the set belongs.
  • root_disk_size - the size of the root disk.
  • cores - the number of cores.
  • ram - the amount of RAM.
  • replicas - the number of nodes in the set.
  • image - the image to use for the nodes.

Universal agent driver

Internal implementation is based on the Universal agent driver.

Clone this wiki locally