Managing CentOS BYON Nodes

To learn the basics of BYON nodes, please read this overview.

This tutorial page shows you how to attach/delete your CentOS BYON nodes to Shippable, as well as perform periodic maintenance on them.

Minimum requirements

The minimum requirements for a CentOS BYON type node that can be attached to Shippable are:

  • 1.8GB RAM
  • 30GB SSD
  • Supported architecture, OS and Docker versions for CentOS
Architecture OS Docker Version
x86_64 CentOS 7 17.06

Viewing your nodes

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

  • From your Dashboard, click on Subscriptions in the left sidebar menu and click on your subscription.

List nodes

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

Node pools option

  • Right below the LICENSES panel, you can see all your On Demand and BYON nodes in their respective Node Pools.

Subscription Nodes view for Shippable DevOps Assembly Lines

Adding new nodes

You can add a new node by clicking the Add node button on the top right corner of your Node Pool panel.

Subscription Nodes view for Shippable DevOps Assembly Lines

  • Since every node should be part of a Node Pool, you need to select which node pool will the new node be a part of. Read Node Pool documentation to learn how to create node pools

  • Click on the Docker version dropdown and select the version you want installed on your nodes. Please note that the list of available versions is populated based on the type of OS and architecture of the node pool

  • Enter a name for the node and its IP address. add node for centos BYON for Shippable DevOps Assembly Lines

  • Shippable does not provide a way to automatically initialize CentOS nodes. The only initialization method available right now is manually running the init scripts on the node.

  • To run the initialization scripts,

    • Choose whether you want to enable swap space on your machine.
    • Click on Generate initialization scripts to generate the script.
    • Click on Download scripts to download. Copy it to your build machine and run them.
    • Check the I have run this script on my node successfully and then click on the Save button.
    • Your node status will automatically show green at this point. We have no way of verifying that the node was in fact successfully initialized so you will need to make sure this was the case.
  • Once the node has been added, any builds that are queued for the node pool which this node is a part of, will be picked up by this node

Re-initializing a node

You might want to re-initialize a BYON node for the following reasons:

  • An updated version is available for the build agent. This is indicated by a red exclamation icon in the Build Agent Version column of the Node.
  • You made some changes to the node manually and it is no longer picking up jobs.
  • The node isn't picking up jobs and seems 'frozen' for some reason.

To re-initialize a node:

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

Node pools option

  • Right below the LICENSES panel, you can see all your On Demand and BYON nodes in their respective Node Pools.

Subscription Nodes view for Shippable DevOps Assembly Lines

  • Click on the node you want to reinitialize.
  • You can reset a node by clicking on the Re-initialize button, followed by downloading and running the new initialization script on your node manually. This action will initialize/install all build components from scratch.

Deleting a build node

  • From your Dashboard, click on Subscriptions in the left sidebar menu and click on your subscription.
  • Click on the gear icon on the Subscription page and then on Node Pools. All your nodes can be seen right below the LICENSES panel in their respective Node pool.
  • Click on the node you want to delete.
  • Scroll to the bottom of the screen and click on Delete to delete your build node. This action is final and cannot be undone.