EKS Import

Platform9 can connect to AWS and import any existing EKS clusters, bringing them under the management of Platform9 to enable centralized administration. Once a cluster has been imported and the External Cluster Operator has been installed Platform9, enables:

• View EKS clusters alongside BareOS, Azure Native Clusters and AWS Native Clusters
• View and Edit RBAC configuration
• View and Managed Cluster Workloads
• Use the Application Catalog to deploy Helm 3 app
• Deploy Platform9 Monitoring

Importing an EKS Cluster

Create Accounts

To import an EKS cluster, users must first:

1. Create a service account for Platform9 in AWS
2. Create an Access Key/Secret Key pair for that service account
3. Grant the service account access to each EKS cluster
4. Create an AWS Cloud Provider within Platform9

Import Clusters

Once the Cloud provider has been added, users can import any EKS cluster that the Service Account has access to.

Below are the steps to import an EKS Cluster.

1. Within AWS, create a service account for Platform9
2. Generate an access key for the service account
3. Grant the service account access to each EKS cluster
4. Log into Platform9 and navigate to Infrastructure → Cloud Providers tab
5. On the Cloud Providers tab, click “+ Add Cloud Provider”
6. Provide a Name for the Cloud Provider and the Access Key Secret Key pair for the Service account and click next
7. Once the Cloud Provider is validated, save the credentials to Platform9
8. Validate the Cloud Provider has access to the regions you are running EKS clusters and then click Done
9. Navigate to the Infrastructure → Clusters tab and select 'Import' from the Add Cluster button
10. Select AWS as the target cloud and click “Import EKS Cluster”
11. Select the Cloud Provider configured with EKS Cluster Access and click Next
12. Select each region where EKS clusters are running and select each cluster to be imported, several clusters can be imported in one action. Once all clusters are selected, click next.
13. Review the final list for import and click “Import”
14. 1. IMPORTANT: ECO must be installed into each cluster after import to ensure that Platform9 can communicate with the clusters API server
15. Install ECO for each imported cluster

Installing ECO

To connect to the external clusters API Server the Platform9 External Cluster Operator must be installed. This can only be done after the cluster has been imported.

1. Once the external cluster import is complete, click Install ECO on the Imported cluster table or select the cluster via the radio checkbox and click edit
2. On the External Cluster Operator tab, download the YAML and save to your client machine. Then, use Kubectl apply -f <fileLocation>/<fileName> to install ECO
3. The status of ECO will refresh once all ECO components are installed

Conclusion

Should you encounter any difficulties adopting or deploying the information noted above, our talented and responsive support team is available 24/7/365 to provide any additional assistance needed.