Skip to content
🛥️🐳 KSail

ksail workload images

List container images required by the configured cluster components.


The image list is derived from the ksail.yaml configuration and includes
images for all enabled components (GitOps engine, CNI, policy engine, etc.).


This command is useful for:
  - Pre-pulling images before cluster creation
  - Creating offline image archives
  - Understanding infrastructure image requirements
  - CI/CD caching strategies


Output formats:
  - plain: One image per line (default, suitable for scripting)
  - json: JSON array of image strings


Examples:
  # List all images for current ksail.yaml config
  ksail workload images


  # List images as JSON array
  ksail workload images --output=json


  # Pipe to docker pull
  ksail workload images | xargs -n1 docker pull


  # Save to file for CI caching
  ksail workload images > required-images.txt


Usage:
  ksail workload images [flags]


Flags:
      --cert-manager CertManager       Cert-Manager configuration (Enabled: install, Disabled: skip)
      --cni CNI                        Container Network Interface (CNI) to use
      --csi CSI                        Container Storage Interface (Default: use distribution, Enabled: install CSI, Disabled: skip CSI)
  -d, --distribution Distribution      Kubernetes distribution to use
  -g, --gitops-engine GitOpsEngine     GitOps engine to use (None disables GitOps, Flux installs Flux controllers, ArgoCD installs Argo CD) (default None)
      --load-balancer LoadBalancer     LoadBalancer support (Default: use distribution × provider, Enabled: install, Disabled: uninstall)
      --metrics-server MetricsServer   Metrics Server (Default: use distribution, Enabled: install, Disabled: uninstall)
  -o, --output string                  Output format: plain, json (default "plain")
      --policy-engine PolicyEngine     Policy engine (None: skip, Kyverno: install Kyverno, Gatekeeper: install Gatekeeper)
      --provider Provider              Infrastructure provider backend (e.g., Docker)


Global Flags:
      --benchmark   Show per-activity benchmark output