liveBook · Manning

Gkectl

As explained in Google Anthos in Action

gkectl is the GKE on-prem command-line tool for creating, validating, scaling, upgrading, and managing clusters.

gkectl is the command-line tool for operating GKE on-prem clusters. It supports configuration validation, load-balancer creation, user-cluster creation, and cluster updates, while release-specific limits and configuration procedures may change. section 5.2 section 5.2.1

Use gkectl within an operational structure that separates administration from workloads:

  • Keep the admin cluster dedicated to monitoring and administering user clusters; do not deploy services that could affect it. section 5.2
  • Use the admin-cluster kubeconfig for validation, load-balancer creation, and new user-cluster creation. section 5.2.1
  • Use the user-cluster kubeconfig when updating an existing user cluster. section 5.2.1
  • Plan for at least three nodes per user cluster, up to 100 nodes in the stated release guidance, and reserve capacity for recreation or upgrades. section 5.2.1

Validate and create a user cluster

Run validation before creation, then create the load balancer and cluster with the relevant admin kubeconfig and configuration file. section 5.2.1

gkectl check-config --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] --config [CONFIG_FILE]

Validates a GKE on-prem configuration before applying it. section 5.2.1

gkectl create cluster --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] --config [CONFIG_FILE]

Creates a user cluster from a configuration file through the admin cluster context. section 5.2.1

How Google Anthos in Action covers it

How deep it goes
Provides operational commands and sizing guidance but defers current release procedures and limits to external documentation.
Examples
Uses configuration validation, load-balancer creation, user-cluster creation, and user-cluster update commands.
What it assumes
Assumes admin and user cluster contexts, kubeconfig files, configuration files, IP planning, and protected infrastructure credentials.
What you can do after
Operate/configure GKE on-prem clusters with release-aware validation, creation, and update workflows.
How it connects
Connects admin clusters, user clusters, kubeconfig contexts, configuration files, Secret Manager, IAM, and cluster upgrades.
Cover of Google Anthos in Action
liveBookmanning.com
Read Google Anthos in Action on liveBook Get the book at manning.com

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Google Anthos in Action. The section links point to the parts of the book it draws on.