Subscription node pools

Node Pools provide a convenient way to logically group the Nodes in a subscription. Any number of node pools can be created for a subscription as long as they follow these rules:

  • A node pool can have either On-demand nodes or BYON nodes
  • On-demand nodes are automatically added to the node pool when they are provisioned
  • BYON nodes need to be added manually to the node pool
  • All nodes in a node pool must have same architecture and operating system. For instance, a node pool cannot have a nodes of type macOS 10.12 and Windows Server 2016
  • The number of nodes of each type that can be added for a node pool is limited by the billing plans available for the subscription

Viewing subscription node pools

You can view all the currently active node pools in your Subscription by following the steps below:

  • Click on the Subscription in the left navbar.

View Subscriptions

  • On the Subscription page, click on the Gears icon and click on Node Pools.

  • On the Node Pools page, the first panel lists the licenses that have been purchased for the subscription. It also provides a short usage summary of the licenses. Subscription Node Pools view for Shippable DevOps Assembly Lines

  • On the Node Pools page, the second panel lists all the existing Node Pools available for the subscription. Subscription Node Pools view for Shippable DevOps Assembly Lines

  • The header for each Node Pool provides useful information about it. This includes: Whether the node pool is set to default for the subscription, operating system, architecture, name of the node pool, version of Shippable agent running on the nodes of the node pool and the type of nodes in the node pool: BYON or On-Demand Subscription Node Pools view for Shippable DevOps Assembly Lines

Managing node pools

Creating a node pool

You can create a new node pool by clicking on the + icon on top right corner of the Node Pools page. This will open the ADD NODE POOL page.

Subscription Node Pools add for Shippable DevOps Assembly Lines

  • Selecting Set as default will set the node pool as the default node pool for the subscription. All jobs that do not explicitly define which node pool to use, will run on nodes of the default node pool

  • TYPE can be either BYON or On Demand

  • Architecture can be either x86_64 or aarch64

  • OS is the list of operating systems supported for BYON nodes for the selected Architecture. For a list of supported OS and architecture combinations, refer to the documentation on Nodes

  • Runtime Version defines the default version of Shippable Machine Images that will be used to run the jobs. You can choose a specific Machine Image to make sure the build nodes have the versions you need for languages/services/CLIs/etc. To learn more about this, read our Machine image document

  • Node Count is the number of nodes that can be added to the node pool. The upper limit is set by the number of licenses that are available at the subscription level for the type of selected node pool

Updating node pools

You can edit any node pool by clicking on the Edit button the node pool header. This will take you to the Edit Node Pool page.

Subscription Node Pools view for Shippable DevOps Assembly Lines

  • Selecting Set as default will set the node pool as the default node pool for the subscription. All jobs that do not explicitly define which node pool to use, will run on nodes of the default node pool

  • Architecture, OS and Machine Size (for On-demand nodes only) fields cannot be edited for a node pool. A new node pool should be created with different values for these fields if required

  • Runtime Version defines the default version of Shippable Machine Images that will be used to run the jobs. You can choose a specific Machine Image to make sure the build nodes have the versions you need for languages/services/CLIs/etc. To learn more about this, read our Machine image document

  • Node Count is the number of nodes that can be added to the node pool. The upper limit is set by the number of licenses that are available at the subscription level for the type of selected node pool

Adding nodes to node pools

  • On-demand nodes automatically get added to the node pool when they're provisioned. For creating node pools containing On-demand nodes, no additional steps are required.

  • BYON nodes need to be manually added to the node pools when creating them. Refer to the documentation on BYON nodes for steps to add new nodes.

Removing nodes from node pools

  • To remove On-demand nodes, simply edit the node pool and reduce the Node Count. The node pool will then have only the new node count as the maximum limit for the nodes it can provision.

  • To remove BYON nodes from node pools, delete individual nodes from their respective node pools. Refer to the documentation on BYON nodes for steps to delete nodes.