refresh addon¶
EKS add-on operations (list, get, update)
Inspect and update the managed EKS add-ons (vpc-cni, coredns, kube-proxy, and others) on a cluster. List shows installed versions and status, describe drills into one add-on, and update rolls a single add-on or every add-on (--all) to a compatible version with optional health gating and waiting.
Flags¶
| Flag | Env | Default | Description |
|---|---|---|---|
--help, -h |
— | — | show help |
Subcommands¶
refresh addon list¶
List EKS add-ons in a cluster
List the managed EKS add-ons installed on a cluster along with their current version, status, and (with --health) a health badge.
Use --watch to keep the listing live: it redraws on the --watch-interval (top-style on a terminal, appended when the output is piped) so you can watch an add-on update progress without re-running the command. Press Ctrl+C to stop.
Examples: refresh addon list my-cluster refresh addon list my-cluster -o plain refresh addon list my-cluster --watch --watch-interval 5s
Flags¶
| Flag | Env | Default | Description |
|---|---|---|---|
--timeout, -t duration |
REFRESH_TIMEOUT |
1m0s |
Operation timeout |
--cluster, -c string |
— | — | EKS cluster name or pattern |
--show-health, -H |
— | — | Include health mapping in table output |
--format, -o string |
— | table |
Output format (table, json, yaml, plain) |
--watch, -w |
— | — | Re-run and redraw every --watch-interval until interrupted |
--watch-interval duration |
— | 10s |
Refresh interval for --watch |
--help, -h |
— | — | show help |
refresh addon describe¶
Describe a specific EKS add-on
Aliases: get
Show detailed information for one add-on: its version, status, and configuration. The add-on name may be the second positional or --addon, and a case-insensitive substring is resolved against the installed add-ons.
refresh addon describe my-cluster vpc-cni refresh addon describe my-cluster coredns -o json
Flags¶
| Flag | Env | Default | Description |
|---|---|---|---|
--timeout, -t duration |
REFRESH_TIMEOUT |
1m0s |
Operation timeout |
--cluster, -c string |
— | — | EKS cluster name or pattern |
--addon, -a string |
— | — | Add-on name (e.g., vpc-cni) |
--format, -o string |
— | table |
Output format (table, json, yaml, plain) |
--help, -h |
— | — | show help |
refresh addon update¶
Update an EKS add-on (use --all to update every add-on)
Update a single managed add-on to a target version, or with --all update every add-on in the cluster to its latest compatible version.
Single add-on: pass the add-on name and an optional version (defaults to 'latest'). The version may be the third positional or --version:
refresh addon update my-cluster vpc-cni # vpc-cni -> latest refresh addon update my-cluster coredns v1.11.1 # pin a version refresh addon update my-cluster vpc-cni --dry-run # preview only
All add-ons (--all): updates every add-on, optionally in dependency-safe order, in parallel, and/or waiting for each to settle. --parallel and --dependency-order are mutually exclusive (parallel defeats ordering). The --parallel/--skip/--dependency-order flags apply only with --all and are ignored (with a warning) on a single-add-on update. The command exits non-zero if any add-on update fails.
refresh addon update my-cluster --all --dependency-order --wait refresh addon update my-cluster --all --skip vpc-cni --parallel
Use --health-check to verify the add-on is ACTIVE and version-compatible before updating. -o json|yaml emits a machine-readable result/summary.
Flags¶
| Flag | Env | Default | Description |
|---|---|---|---|
--timeout, -t duration |
REFRESH_TIMEOUT |
10m0s |
Operation timeout |
--cluster, -c string |
— | — | EKS cluster name or pattern |
--addon, -a string |
— | — | Add-on name (e.g., vpc-cni) |
--version string |
— | latest |
Target version or 'latest' (can be provided as third positional) |
--all |
— | — | Update all add-ons in the cluster to their latest versions |
--health-check |
— | — | Verify the addon is ACTIVE before updating and validate version compatibility with the cluster |
--dry-run, -d |
— | — | Preview without applying changes |
--parallel, -p |
— | — | (--all only) Update addons in parallel |
--wait |
— | — | Wait for each update to complete |
--wait-timeout duration |
— | 5m0s |
Per-addon wait timeout (with --wait) |
--dependency-order |
— | — | (--all only) Update addons in dependency-safe order (vpc-cni -> coredns/kube-proxy -> others) |
--skip, -s string |
— | — | (--all only) Skip specific addons (repeatable) |
--format, -o string |
— | table |
Output format (table, json, yaml, plain) |
--help, -h |
— | — | show help |