To use this option you’ll need access to servers you intend to use in your Kubernetes cluster. Provision each server according to the requirements, which includes some hardware specifications and Docker. After you install Docker on each server, you willl also run the command provided in the Rancher UI on each server to turn each one into a Kubernetes node.

    This section describes how to set up a custom cluster.

    Creating a Cluster with Custom Nodes

    Begin creation of a custom cluster by provisioning a Linux host. Your host can be:

    • A cloud-host virtual machine (VM)
    • An on-prem VM
    • A bare-metal server

    If you want to reuse a node from a previous custom cluster, before using it in a cluster again. If you reuse a node that hasn’t been cleaned, cluster provisioning may fail.

    Provision the host according to the installation requirements and the

    1. Choose Custom.

    2. Enter a Cluster Name.

    3. Use Member Roles to configure user authorization for the cluster. Click Add Member to add users that can access the cluster. Use the Role drop-down to set permissions for each user.

    4. Using Windows nodes as Kubernetes workers?

    5. Click Next.

    6. From Node Role, choose the roles that you want filled by a cluster node.

    7. Copy the command displayed on screen to your clipboard.

    8. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection. Run the command copied to your clipboard.

      Note: Repeat steps 7-10 if you want to dedicate specific hosts to specific node roles. Repeat the steps as many times as needed.

    9. When you finish running the command(s) on your Linux host(s), click Done.

    Result:

    Your cluster is created and assigned a state of Provisioning. Rancher is standing up your cluster.

    Active clusters are assigned two Projects:

    • , containing the default namespace
    • System, containing the cattle-system, , kube-public, and kube-system namespaces

    If you have configured your cluster to use Amazon as Cloud Provider, tag your AWS resources with a cluster ID.

    The following resources need to tagged with a ClusterID:

    • Nodes: All hosts added in Rancher.
    • Subnet: The subnet used for your cluster

    • Security Group: The security group used for your cluster.

      Note: Do not tag multiple security groups. Tagging multiple groups generates an error when creating Elastic Load Balancer.

    The tag that should be used is:

    can be any string you choose. However, the same string must be used on every resource you tag. Setting the tag value to owned informs the cluster that all resources tagged with the <CLUSTERID> are owned and managed by this cluster.

    If you share resources between clusters, you can change the tag to:

    1. Key=kubernetes.io/cluster/CLUSTERID, Value=shared

    Optional Next Steps

    After creating your cluster, you can access it through the Rancher UI. As a best practice, we recommend setting up these alternate ways of accessing your cluster:

    • Access your cluster with the kubectl CLI: Follow to access clusters with kubectl on your workstation. In this case, you will be authenticated through the Rancher server’s authentication proxy, then Rancher will connect you to the downstream cluster. This method lets you manage the cluster without the Rancher UI.