---
title: "ezgh kubernetes clusters update"
description: "Change or upgrade a cluster."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh kubernetes clusters update

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh kubernetes clusters update <cluster> [flags] [--wait]
```

Change a cluster. Only what's given changes. `--version` upgrades it one minor version: pre-checks refuse it, changing nothing, while a node group would fall too far behind or the cluster still uses an API the new version removes. Node groups keep their version until you upgrade each. `--public-access-cidr` replaces the public endpoint's ranges and `--no-public-access` closes it; `--logging-type` replaces the logs sent to Obs and `--no-logging` stops them; `--control-plane-metrics` turns the metrics on and `--control-plane-metrics=false` off. Log and metrics changes apply to the running control plane, and a log type turned off stops once the update finishes. `--wait` waits until it's done 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:

```text
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`](/cli/reference/kubernetes-clusters).

## Examples

```sh
ezgh kubernetes clusters update prod --version 1.37 --wait
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--clear-tags` | boolean |  | remove its tags |
| `--control-plane-metrics` | boolean |  | send the control plane's metrics to the cluster's project in Obs, free; =false stops them |
| `--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; repeat for more; replaces them all |
| `--maintenance-window` | string |  | when patch updates are made, day:hour UTC (sunday:9) |
| `--no-logging` | boolean |  | stop sending control-plane logs to Obs |
| `--no-public-access` | boolean |  | close the public endpoint |
| `--public-access-cidr` | string, repeatable |  | an IPv4 CIDR that may reach the public endpoint; repeat for more; replaces them all |
| `--tag` | string, repeatable |  | a tag, key=value; repeat for more; replaces them all |
| `--version` | string |  | upgrade to this Kubernetes version, the next minor one |
| `--wait` | boolean |  | wait until it's done, and print it then |
| `--wait-timeout` | duration | `45m0s` | how long `--wait` waits |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/kubernetes-clusters-update/index.mdx
