When you provision a cluster hosted by an infrastructure provider, node templates are used to provision the cluster nodes. These templates use Docker Machine configuration options to define an operating system image and settings/parameters for the node. You can create node templates in two contexts:
- While provisioning a node pool cluster.
- At any time, from your user settings.
When you create a node template, it is bound to your user profile. Node templates cannot be shared among users. You can delete stale node templates that you no longer user from your user settings.
Creating a Node Template from User Settings
- From your user settings, select User Avatar > Node Templates.
- Click Add Template.
- Select one of the cloud providers available. Then follow the instructions on screen to configure the template.
Result: The template is configured. You can use the template later when you provision a node pool cluster.
Updating a Node Template
- From your user settings, select User Avatar > Node Templates.
Choose the node template that you want to edit and click the ⋮ > Edit.
Note: As of v2.2.0, the default
active
node drivers and any node driver, that has fields marked aspassword
, are required to use cloud credentials. If you have upgraded to v2.2.0, existing node templates will continue to work with the previous account access information, but when you edit the node template, you will be required to create a cloud credential and the node template will start using it.Edit the required information and click Save.
Result: The node template is updated. All node pools using this node template will automatically use the updated information when new nodes are added.
Cloning Node Templates
When creating new node templates from your user settings, you can clone an existing template and quickly update its settings rather than creating a new one from scratch. Cloning templates saves you the hassle of re-entering access keys for the cloud provider.
- From your user settings, select User Avatar > Node Templates.
- Find the template you want to clone. Then select ⋮ > Clone.
- Complete the rest of the form.
Result: The template is cloned and configured. You can use the template later when you provision a node pool cluster.
Deleting a Node Template
When you no longer use a node template, you can delete it from your user settings.
- From your user settings, select User Avatar > Node Templates.
- Select one or more template from the list. Then click Delete. Confirm the delete when prompted.