Skip to main content
Version: v2.6

Managing Node Templates

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:

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

  1. Click ☰ > Cluster Management.
  2. Click RKE1 Configuration > Node Templates.
  3. Click Add Template.
  4. 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

  1. Click ☰ > Cluster Management.

  2. Click RKE1 Configuration > Node Templates.

  3. Choose the node template that you want to edit and click the ⋮ > Edit.

    note

    The default active node drivers and any node driver, that has fields marked as password, are required to use cloud credentials.

  4. 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.

  1. Click ☰ > Cluster Management.
  2. Click RKE1 Configuration > Node Templates.
  3. Find the template you want to clone. Then select ⋮ > Clone.
  4. 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.

  1. Click ☰ > Cluster Management.
  2. Click RKE1 Configuration > Node Templates.
  3. Select one or more template from the list. Then click Delete. Confirm the delete when prompted.