From 19e0270a098437ed1e17f8d925d371e975ffe7c1 Mon Sep 17 00:00:00 2001 From: Mark Bishop Date: Mon, 30 Jul 2018 17:26:37 -0700 Subject: [PATCH] adding procedures for managing node templates --- .../rke-clusters/node-pools/_index.md | 2 +- .../en/user-settings/node-templates/_index.md | 33 ++++++++++++++++++- 2 files changed, 33 insertions(+), 2 deletions(-) diff --git a/content/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools/_index.md b/content/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools/_index.md index a2bcb9b3f35..9fbdb7e18a6 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools/_index.md @@ -13,7 +13,7 @@ Using Rancher, you can create pools of nodes based on a [node template](#node-te Each node pool is assigned with a [node component]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/#node-components) to specify how these nodes should be configured for the Kubernetes cluster. -## Node templates +## Node Templates A node template is the saved configuration for the parameters to use when provisioning nodes in a specific cloud provider. Rancher provides a nice UI to be able to launch these nodes and uses [Docker Machine](https://docs.docker.com/machine/) to provision these nodes. The available cloud providers to create node templates are based on the active node drivers in Rancher. diff --git a/content/rancher/v2.x/en/user-settings/node-templates/_index.md b/content/rancher/v2.x/en/user-settings/node-templates/_index.md index 56f98859af9..0b936cd207b 100644 --- a/content/rancher/v2.x/en/user-settings/node-templates/_index.md +++ b/content/rancher/v2.x/en/user-settings/node-templates/_index.md @@ -1,5 +1,36 @@ --- title: Managing Node Templates weight: 7010 -draft: true --- + +[Node templates]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools/#node-templates) are operating system images and settings used to create nodes when you provision a [node pool]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools) cluster. You can create node templates in two contexts: + +- While [provisioning a node pool cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools). +- At any time, from your [user settings](#creating-a-node-template-from-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 + +1. From your user settings, select **User Avatar > Node Templates**. +1. Click **Add Template**. +1. 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]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools). + +## 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. + +1. From your user settings, select **User Avatar > Node Templates**. +1. Find the template you want to clone. Then select **Ellipsis > Clone**. +1. 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]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/node-pools). + +## Deleting a Node Template + +When you no longer use a node template, you can delete it from your user settings. + +1. From your user settings, select **User Avatar > Node Templates**. +1. Select one or more template from the list. Then click **Delete**. Confirm the delete when prompted. \ No newline at end of file