Skip to content

ksail workload

Manage workload operations including resource inspection, GitOps reconciliation, and lifecycle management.
Read operations:
get - List resources with optional -o json for structured output including status/conditions
describe - Show detailed resource info including events, conditions, and error details
logs - Print container logs (use --tail=N, --previous for crash diagnostics)
explain - Show API documentation for a resource kind
images - List container images required by cluster components
wait - Wait for a specific condition on resources
Write operations:
apply, create, debug, delete, edit, exec, export, expose, import, install, push, reconcile, rollout, scale, watch
GitOps diagnostics: Use 'get' with Flux resources (kustomization, helmrelease, ocirepository -A -o json) or ArgoCD resources (application -A -o json) to check reconciliation status, health, and errors in a single call.
Usage:
ksail workload [flags]
ksail workload [command]
Available Commands:
apply Apply manifests
create Create resources
debug Create debugging sessions for troubleshooting workloads and nodes
delete Delete resources
describe Describe resources
edit Edit a resource
exec Execute a command in a container
explain Get documentation for a resource
export Export container images from the cluster
expose Expose a resource as a service
gen Generate Kubernetes resource manifests
get Get resources
images List container images required by cluster components
import Import container images to the cluster
install Install Helm charts
logs Print container logs
push Package and push an OCI artifact to a registry
reconcile Trigger reconciliation for GitOps workloads
rollout Manage the rollout of a resource
scale Scale resources
validate Validate Kubernetes manifests and kustomizations
wait Wait for a specific condition on one or many resources
watch Watch for file changes and auto-apply workloads
Global Flags:
--benchmark Show per-activity benchmark output
--config string Path to config file (default: ksail.yaml found via directory traversal)
Use "ksail workload [command] --help" for more information about a command.