Skip to content

Operations.md

Latest commit

 

History

History
120 lines (82 loc) · 2.62 KB

Operations.md

File metadata and controls

120 lines (82 loc) · 2.62 KB
Raw

Operations

Tasks for a cluster installed with wasctl.

Application stack

flowchart LR
  status["wasctl status"] --> info["wasctl info"]
  info --> doctor["wasctl doctor"]
  doctor --> fix["Remediate / re-run stage"]
  fix --> status
Loading

Status and health

./wasctl status              # which stages completed
./wasctl info                # workloads, Kafka, storage
./wasctl doctor              # diagnostic checks

In the web UI (wasctl serve): select the workspace, then use Overview, Workloads, Kafka, Storage, or Operations → Diagnostics.

Configuration

./wasctl config show
./wasctl workspace list
./wasctl workspace info <cluster-name>

Clear a stuck install lock:

./wasctl unlock <cluster-name>
flowchart TB
  laptop["Any laptop with credentials"] --> meta["Cloud meta store"]
  meta --> ws["workspace.json · kubeconfig · locks"]
  ws --> cluster["Live EKS / AKS cluster"]
Loading

Upgrade

Chart / application

./wasctl install app
# or: helm upgrade — see the chart README

With a local checkout of this repo:

./wasctl install app --local

wasctl binary

Replace the binary. Workspace state remains in your cloud account.

Infrastructure

Re-run ./wasctl install infra only when you want Terraform to reconcile. Review the plan carefully; changes can replace nodes or networking.

Support bundle

./wasctl support-bundle

Send the archive to Wolfram support. The web UI Operations tab can generate the same bundle.

Destroy

flowchart RL
  app[app] --> addons[addons] --> kube[kubeconfig] --> infra[infra]
  infra --> backend[backend] --> boot[bootstrap]
Loading

Destroy reverses the install order (application and add-ons before infrastructure).

./wasctl destroy
./wasctl destroy --destroy-state-backend   # also delete TF state storage

Confirm the cluster name when prompted. In the web UI: Operations → Destroy.

./wasctl workspace delete <cluster-name>   # remove workspace metadata only

Recovery

Situation Action
Interrupted install wasctl status, then re-run the failed stage
Stuck lock wasctl unlock <name>
Wrong kubectl context wasctl does not write ~/.kube/config; use wasctl info or the web UI
Addon already exists --skip <addon> on the addons stage
Pending Azure log PVCs Check storage class and Premium share size; delete Pending PVCs before resizing

See also: troubleshooting.md · architecture.md.