ark operator

Install, upgrade, and inspect the ark-operator Helm release from the CLI - full reference for ark operator subcommands.

Install, upgrade, and inspect the ark-operator Helm release. Requires helm and kubectl to be installed and configured.

ark operator <subcommand> [flags]

Subcommands

SubcommandDescription
ark operator installAdd the Helm repo and install the operator chart
ark operator upgradeUpgrade (or install) the operator chart to a new version
ark operator statusShow the operator pod status and Helm release info

ark operator install

Add the arkonis-dev Helm repository and install the ark-operator chart.

ark operator install [flags]

Flags

FlagDefaultDescription
--namespaceark-systemKubernetes namespace for the operator
--task-queue-url-Redis connection string, e.g. redis://redis.ark-system.svc:6379
--agent-env-Env var injected into every agent pod, e.g. OPENAI_API_KEY=sk-... (repeatable)
--versionlatestChart version to install
--set-Pass-through --set to Helm (repeatable)
--contextcurrent contextKubernetes context to use
--waitfalseWait for the operator pod to be ready before returning

Examples

# Install with defaults (uses in-cluster Redis)
ark operator install

# Install with an external Redis and OpenAI-compatible endpoint
ark operator install \
  --task-queue-url redis://redis.ark-system.svc:6379 \
  --agent-env OPENAI_BASE_URL=http://ollama.ai-tools.svc:11434/v1 \
  --agent-env OPENAI_API_KEY=ollama \
  --wait

# Install a specific chart version
ark operator install --version 0.3.5

# Install with extra Helm values
ark operator install --set replicaCount=2 --set resources.limits.memory=512Mi

ark operator upgrade

Upgrade the operator to a new chart version. Uses helm upgrade --install so it is safe to run even if the operator is not yet installed.

ark operator upgrade [flags]

Accepts the same flags as ark operator install.

# Upgrade to the latest chart version
ark operator upgrade --wait

# Upgrade to a specific version
ark operator upgrade --version 0.4.0 --wait

ark operator status

Show the operator pod status and Helm release metadata.

ark operator status [flags]

Flags

FlagDefaultDescription
--contextcurrent contextKubernetes context to use

Example output

Helm release:  ark-operator  (ark-system)
  Chart:       ark-operator-0.3.1
  Status:      deployed
  Revision:    3

Pods:
  ark-operator-7d9f4b8c6-xq2pn   Running   2/2   ark-system

See also