Skip to content

Kubernetes kubectl

This section is rendered asynchronously by default

Info

Kubernetes is an open-source container orchestration system for automating software deployment, scaling, and management.

The kubectl section consists of kubectl_version and kubectl_context subsections. It is shown only when kubectl can connect to Kubernetes cluster.

Options

Variable Default Meaning
SPACESHIP_KUBECTL_SHOW false Show section
SPACESHIP_KUBECTL_ASYNC true Render section asynchronously
SPACESHIP_KUBECTL_PREFIX at· Section's prefix
SPACESHIP_KUBECTL_SUFFIX $SPACESHIP_PROMPT_DEFAULT_SUFFIX Section's suffix
SPACESHIP_KUBECTL_COLOR white Section's color of Kubernetes section
SPACESHIP_KUBECTL_SYMBOL ☸️·· Symbol displayed before the section

Kubernetes version kubectl_version

The kubectl_version section shows the version of the Kubernetes. It is shown only when kubectl binary is available.

Options

Variable Default Meaning
SPACESHIP_KUBECTL_VERSION_SHOW true Show subsection
SPACESHIP_KUBECTL_VERSION_ASYNC true Render section asynchronously
SPACESHIP_KUBECTL_VERSION_PREFIX - Subsection's prefix
SPACESHIP_KUBECTL_VERSION_SUFFIX $SPACESHIP_PROMPT_DEFAULT_SUFFIX Subsection's suffix
SPACESHIP_KUBECTL_VERSION_COLOR cyan Subsection's color

Kubernetes context kubectl_context

The kubectl_context section shows an active Kubernetes context, which consists of a cluster name and a namespace name (when working in a non-default namespace).

Tip

If your cluster name (and thus context name) is too long, you can give it a shorter name using:

kubectl config rename-context very_long_context_name name

Defining color base on current context or namespace

To set the section to a different color based on context or namespace, you can define an array of pair values in which the first value of a pair is a color name to use and the second value is a regular expression pattern to match against the section text (context name and/or namespace). The first matched pattern will determine the color, so list order can be used to prioritize patterns.

Here is an example:

.zshrc
SPACESHIP_KUBECTL_CONTEXT_COLOR_GROUPS=(
  # red if namespace is "kube-system"
  red    '\(kube-system)$'

  # else, green if "dev-01" is anywhere in the context or namespace
  green  dev-01

  # else, red if context name ends with ".k8s.local" _and_ namespace is "system"
  red    '\.k8s\.local \(system)$'

  # else, yellow if the entire content is "test-" followed by digits, and no namespace is displayed
  yellow '^test-[0-9]+$'
)

Options

Variable Default Meaning
SPACESHIP_KUBECTL_CONTEXT_SHOW true Show subsection
SPACESHIP_KUBECTL_CONTEXT_PREFIX at· Subsection's prefix
SPACESHIP_KUBECTL_CONTEXT_SUFFIX $SPACESHIP_PROMPT_DEFAULT_SUFFIX Subsection's suffix
SPACESHIP_KUBECTL_CONTEXT_COLOR cyan Subsection's color
SPACESHIP_KUBECTL_CONTEXT_SHOW_NAMESPACE true Should namespace be also displayed
SPACESHIP_KUBECTL_CONTEXT_COLOR_GROUPS - Array of pairs of colors and match patterns