The steps described below capture the steps needed to import a cluster manually using the Rafay Console. Watch a video showcasing the Import of an existing AWS EKS Cluster into Rafay.
Kubernetes v1.14.1 or higher is the minimum supported version for imported clusters.
Step 1: Start Import¶
- In the Rafay Console, click on New Cluster
- Select "Import Existing Kubernetes Cluster" and click Continue
- Select "Environment" based on where the cluster is provisioned
- Select "Kubernetes Distribution"
- Give it a name and Click on "Continue"
Below illustration shows an example of importing existing EKS cluster.
Step 2: Provide Cluster Details¶
In the wizard on the Rafay Console,
- Select a location for the cluster from the dropdown
- Select the blueprint from the drop down (default blueprint will be used if nothing is specified)
- If a custom blueprint is selected select the version for the blueprint
Step 3: Register Cluster with Rafay¶
You will now be presented with a cluster registration step where the user has to deploy a uniquely generated "Rafay Bootstrap YAML" file to their cluster using "KubeCTL". This process initiates the registration process of the imported cluster with the Rafay Controller, deploys all the required software components for the Rafay k8s operator and configured cluster blueprint.
- Download the YAML file generated for the cluster
- Deploy the YAML file to your cluster using "kubectl"
You must have cluster-admin privilege to import the cluster into Rafay.
If successful, you should see output similar to the image below
Once registration starts, and the Rafay in-cluster components are successfully deployed,
- The cluster will check in with the controller
- The namespaces will be synchronized
- Finally, the configured blueprint will be applied to the imported cluster.
Once all the steps are complete and if the import process was successful, you should see details about the cluster on the Ops Console. The imported cluster is now managed by the Rafay Controller.