liveBook · Manning

Admin workstation

As explained in Google Anthos in Action

An admin workstation is a management machine from which GKE on-prem admin and user clusters are installed and operated.

An admin workstation is the management machine used to install and operate GKE on-prem admin and user clusters. The gkeadm tool creates it, after which gkectl provisions and updates the clusters. section 17.3.3 section 5.2.1

Prepare the workstation with the following capabilities:

  • Run the same Linux operating system as the cluster nodes, with Docker 19.03 or higher configured for nonroot management. section 17.3.3
  • Install gcloud with anthos-auth and kubectl, and provide more than 50 GB of free disk space. section 17.3.3
  • Provide L3 connectivity to every cluster node, passwordless root SSH access through private keys, and access to the control-plane VIP. section 17.3.3
  • Supply vCenter credentials, a whitelisted GCP service-account key, and the vCenter certificate authority path in the generated configuration. section 5.2.1

Treat configuration credentials as an operational risk: vCenter and F5 Big-IP passwords can be written in plaintext. A wrapper around Google Cloud Secret Manager and gcloud can retrieve secrets, substitute them temporarily, apply the configuration, and remove them. section 5.2.1

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

Validate the generated configuration before creating the load balancer and clusters with gkectl. section 5.2.1

How Google Anthos in Action covers it

How deep it goes
Specifies operating-system, Docker, storage, network, SSH, certificate, and credential requirements, but not workstation build automation.
Examples
Uses gkeadm configuration generation, gkectl validation, cluster creation, certificate retrieval, and Secret Manager commands.
What it assumes
Assumes access to Linux nodes, Docker, vCenter, cluster networking, SSH keys, a control-plane VIP, and a whitelisted service account.
What you can do after
Operate/configure GKE on-prem by preparing the workstation, validating configuration, and installing or updating clusters.
How it connects
Connects gkeadm, gkectl, admin clusters, user clusters, node pools, Docker, SSH, vCenter, and Google Cloud Secret Manager.

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.