Change or delete a node group
A node group's projects run only on its nodes. Change the group when those nodes change, for example a new GPU machine joins or an old one retires, and delete it when no project needs it any more. To make a group or give one to a project, see Run a project on some nodes only.
Plan: node groups are on the Business plan. On other plans a group's page shows Not on your plan.
Who can do this: you need the permission to edit nodes. Without it, a group's page only reads.
Change a group
- In the sidebar, select Directory, then Machines.
- Select the Groups tab. All is on top and can't be changed; your groups follow.
- Select the group's name. Its page opens beside the list.
- To rename it, change Name or Description, then select Save. Saved. shows when it's done.
- To add a node, type its name in Add a node under Members and pick it. It's added at once, with no Save.
- To take a node out, select × on its chip. When projects that use the group have tasks running on that node, Jaah asks first in Stop using 1 node? and lists the node with its running tasks. Select Change groups to go ahead, or Cancel to keep it.
The projects that use the group start their next tasks on its new set of nodes. A task already running on a node you removed finishes there.
To add or remove one node from its own side instead, open the node: its Overview has a Groups section with Add to a group and an × on each group.
Delete a group
- On the Groups tab, select the group's name.
- Check Projects on its page: these are the projects that lose the group.
- Select Delete at the top right.
- Read Delete "name"?. It lists the projects that lose the group, or reads No project uses it.
- Select Delete. You're taken back to the Groups tab.
A project left with no group runs on All again, every enabled node of your organization. To keep a project off some nodes, give it another group on its page before you delete this one. Running tasks are never stopped.
Related
- Node groups: every field on the Groups tab and a group's page.
- Run a project on some nodes only: make a group and give it to a project.
- Drain or disable a node: stop new tasks on one node without changing groups.
- How nodes work: what a node is and how tasks pick one.