Skip to content

ezgh kubernetes clusters create

Create a cluster.

Updated View as Markdown
ezgh kubernetes clusters create <name> --subnet s --bot b [flags] [--wait]

Create a cluster in a subnet of your VPC. The VPC needs a Network Gateway, and the subnet’s route table must send 0.0.0.0/0 to it. --bot is the cluster bot: load balancers, volumes and node capacity the cluster creates in this project are made as it, so it needs KubernetesClusterAccess, and you need bots.pass on it. You get cluster admin access unless --no-creator-access. It takes about 15 minutes: --wait waits until it’s active and prints it.

--logging-type sends control-plane logs to the Obs project --logging-project names by its ID (prj_…), billed as log ingest in that project, under service ezgh.kubernetes with attribute kubernetes.log_type:

api                the API server's logs
audit              the API server's audit log
authenticator      one entry per sign-in with an EZGH cluster token or a node's instance identity:
                   time, credential type, whether it was authenticated, username, uid, groups and
                   error; never the token
controllerManager  the controller manager's logs
scheduler          the scheduler's logs

--control-plane-metrics sends the API server’s, etcd’s, the scheduler’s and the controller manager’s metrics once a minute to the cluster’s project in Obs, production environment, free.

Part of ezgh kubernetes clusters.

Examples

ezgh kubernetes clusters create prod --subnet sbn_2m9x0a7qpe4k --bot bot_4k2m9x0a7qpe --wait

Flags

Flag Type Default Description
--bot string the cluster bot (bot_…), with KubernetesClusterAccess
--control-plane-metrics boolean send the control plane’s metrics to the cluster’s project in Obs, free
--encryption-key string a Keys key (kms_…) to encrypt Kubernetes Secrets with (default an EZGH-managed key)
--logging-project string the Obs project the logs go to, by its ID (prj_…)
--logging-type string, repeatable send these control-plane logs to Obs: api, audit, authenticator, controllerManager or scheduler; repeat for more
--maintenance-window string when patch updates are made, day:hour UTC (sunday:9)
--no-creator-access boolean don’t give you cluster admin access
--no-public-access boolean close the public endpoint: kubectl reaches it only from inside the VPC
--public-access-cidr string, repeatable an IPv4 CIDR that may reach the public endpoint; repeat for more (default 0.0.0.0/0)
--service-ipv4-cidr string the IPv4 range Services get addresses from, outside the VPC’s (default 10.100.0.0/16)
--subnet string the subnet its endpoint’s private addresses are in (sbn_…)
--tag string, repeatable a tag, key=value; repeat for more
--version string the Kubernetes version, from ezgh kubernetes versions list (default the newest)
--wait boolean wait until it’s active, and print it then
--wait-timeout duration 45m0s how long --wait waits

This command also takes the global flags.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close