GKE Cluster Management

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

  • View GKE clusters alongside BareOS, Azure Native Clusters and AWS Native Clusters
  • View and Edit RBAC configurations
  • View and Manage Cluster Workloads
  • Use the Application Catalog to deploy Helm 3 applications
  • Deploy Platform9 Monitoring

Platform9 requires that the service principal that was used to create the Cloud Provider must have access to the GKE Cluster as an Google Cloud Kubernetes Service Cluster Admin Role. To validate IAM access download Cloud Provider Checks CLI

Import an GKE Cluster

To import a GKE cluster, clients must first create a service account for Platform9 in Google Cloud, and then export and download the account's JSON Key. The service account must have access to each cluster with Kubernetes Engine Admin: roles/container.adminpermissions. Clients can then create a Google Cloud Provider within Platform9.

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

To import a GKE Cluster, follow these steps:

  1. Within Google Cloud, create a Google Cloud Service Account for Platform9

  2. Grant the Service Account container admin permissions

  3. Log into Platform9 and navigate to the Infrastructure ⇾ Cloud Providers tab

  4. On the Cloud Providers tab, click '+ Add Cloud Provider'

  5. Next, provide a Name for the Cloud Provider and the JSON file for the Google Service Account

  6. Once the Cloud Provider has been validated, clients can save the credentials to Platform9

  7. Now, navigate to the Infrastructure ⇾ Clusters tab and select 'Import' from the 'Add Cluster' button

  8. Then, select Google Cloud as the target cloud and click 'Import GKE Cluster'

  9. Select the Cloud Provider configured with GKE Cluster Access and click 'Next'

  10. Next, select each region where the GKE 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.

  11. Review the final list for import and click 'Import'

    1. IMPORTANT: ECO must be installed into each cluster after import to ensure that Platform9 can communicate with the clusters API server
  12. 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.

Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
  Last updated