RKE templates can be applied to new clusters.

You can Then the cluster’s settings can only be changed if the template is updated.

You can’t change a cluster to use a different RKE template. You can only update the cluster to a new revision of the same template.

To add a cluster using an RKE template, use these steps:

  1. From the Global view, go to the Clusters tab.
  2. Provide the cluster name and node template details as usual.
  3. To use an RKE template, under the Cluster Options, check the box for Use an existing RKE template and revision.
  4. Choose an existing template and revision from the dropdown menu.
  5. Optional: You can edit any settings that the RKE template owner marked as Allow User Override when the template was created. If there are settings that you want to change, but don’t have the option to, you will need to contact the template owner to get a new revision of the template. Then you will need to edit the cluster to upgrade it to the new revision.
  6. Click Save to launch the cluster.

When the template owner creates a template, each setting has a switch in the Rancher UI that indicates if users can override the setting.

  • If the setting allows a user override, you can update these settings in the cluster by editing the cluster.

If a cluster was created from an RKE template, you can edit the cluster to update the cluster to a new revision of the template.

This section describes how to create an RKE template from an existing cluster.

RKE templates cannot be applied to existing clusters, except if you save an existing cluster’s settings as an RKE template. This exports the cluster’s settings as a new RKE template, and also binds the cluster to that template. The result is that the cluster can only be changed if the and the cluster is upgraded to use a newer version of the template.

  1. From the Global view in Rancher, click the Clusters tab.
  2. Go to the cluster that will be converted to use an RKE template. Click ⋮ > Save as RKE Template.
  3. Enter a name for the template in the form that appears, and click Create.

Results:

  • A new RKE template is created.
  • The cluster is converted to use the new template.
  • New clusters can be