Create Cluster Definition

To complete the Edge Installation process, an Edge host must become a member of a host cluster. You can add an Edge host to an existing host cluster of type Edge Native, or you can create a new host cluster for Edge hosts and make the Edge host a member.

Select the workflow that best fits your needs.

• Create an Edge Native Host Cluster
• Add an Edge Host to a Host Cluster

Create an Edge Native Host Cluster

Use the following steps to create a new host cluster so that you can add Edge hosts to the node pools.

Prerequisites

• A registered Edge host.

Create Cluster

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Click on Add New Cluster.

4. Choose Edge Native for the cluster type and click Start Edge Native Configuration.

5. Give the cluster a name, description, and tags. Click on Next.

6. Select a cluster profile. If you don't have a cluster profile for Edge Native, refer to the Create Edge Native Cluster Profile guide. Click on Next after you have selected a cluster profile.

7. Review your cluster profile values and make changes as needed. Click on Next.

8. Provide the host cluster with the Virtual IP (VIP) address used by the physical site. You can also select any SSH keys in case you need to remote into the host cluster. You can also provide a list of Network Time Protocol (NTP) servers. Click on Next.

9. The node configuration page is where you can specify what Edge hosts make up the host cluster. Assign Edge hosts to the master-pool and the worker-pool. When you have completed configuring the node pools, click on Next.

10. (Optional) When you assign Edge hosts to node pools, you can optionally specify a static IP address for each Edge host. If you want to specify a static IP, toggle on Static IP and provide the following information:

    Field	Description
    IP Address	The static IP address assigned to your Edge host. This should be unique within your network.
    Default gateway	The IP address of the default gateway for your cluster network. This gateway routes traffic from your cluster to external networks.
    Subnet mask	The subnet mask of your cluster network. This defines the range of IP addresses within your cluster network.
    DNS server	The IP address of the DNS server your cluster uses for domain resolution.

    If certain network information is already available, the corresponding fields will be pre-populated.

    caution

    After you create the cluster, you will not be able to change the IP address of your existing Edge hosts unless you remove and re-add them back to the cluster.

11. The Settings page is where you can configure a patching schedule, security scans, backup settings, and set up Role-Based Access Control (RBAC). Review the settings and make changes if needed. Click on Validate.

12. Review the settings summary and click on Finish Configuration to deploy the cluster.

After you create the cluster, the Palette Edge Host agent will start the installation process. You can track the installation progress in Palette. The cluster overview page displays a summary of the progress. Use the Events tab to review detailed logs.

Validate

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Select the host cluster you created to view its details page.

4. Review the Cluster Status. Ensure the Cluster Status field displays Running.

You can also use the command kubectl get nodes to review the status of all nodes in the cluster. Check out the Access Cluster with CLI guide to learn how to use kubectl with a host cluster.

Add an Edge Host to a Host Cluster

You can add Edge hosts to the node pool of an existing host cluster. Use the following steps to add the Edge host to the node pool.

Prerequisites

• A registered Edge host.

• A host cluster of type Edge Native.

caution

When adding a new Edge host to an existing cluster, ensure you are not creating a scenario where etcd could fail in establishing a quorum. Quorum failures typically result when there is an even number of nodes. To learn more, check out the resource from the etcd documentation titled Why an odd number of cluster members.

Add Edge Host to Node Pool

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Use the Cloud Types drop-down Menu and select Edge Native.

4. Select the host cluster to add the registered Edge host.

5. Click on the Nodes tab.

6. Select the node pool to add the Edge host and click the Edit button.

7. Navigate to the Edge Hosts drop-down Menu and select your Edge host.

8. (Optional) When you select your Edge host, you can optionally specify a static IP address for the Edge host. If you want to specify a static IP, toggle on Static IP and provide the following information:

   Field	Description
   IP Address	The static IP address assigned to your Edge host. This should be unique within your network.
   Default gateway	The IP address of the default gateway for your cluster network. This gateway routes traffic from your cluster to external networks.
   Subnet mask	The subnet mask of your cluster network. This defines the range of IP addresses within your cluster network.
   DNS server	The IP address of the DNS server your cluster uses for domain resolution.

   If certain network information is already available, the corresponding fields will be pre-populated.

   caution

   After you add the Edge host to your cluster, you will not be able to change its IP address unless you remove and re-add them back to the cluster.

9. Confirm your changes.

The Palette Edge Host agent will start the installation process. You can track the installation progress in Palette. The cluster overview page displays a summary of the progress. Use the Events tab to review detailed logs.

Validate

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Select the host cluster you created to view its details page.

4. Review the Cluster Status. Ensure the Cluster Status field displays Running.

You can also use the command kubectl get nodes to review the status of all nodes in the cluster. Check out the Access Cluster with CLI to learn how to use kubectl with a host cluster.