Skip to main content

A Powerline segment for showing the status of current Kubernetes context

Project description

Powerline K8S Status

CodeQL codecov Python package

A Powerline segment for showing the status of current Kubernetes context.

By imjoseangel

screenshot

It will show any or all of:

  • context name
  • namespace
  • username
  • controlplane version

You can also:

  • Toggle on or off the powerline-k8sstatus segment using an environment variable which can easily be mapped to a function in your ~/.profile file.

  • Define certain contexts or namespaces to be colored differently for alerting purposes. For instance, you can have your production context or kube-system namespace showing up in bright red or solarized yellow respectively.

Requirements

The K8Sstatus segment requires kubectl. It can be installed following the instructions here.

Installation

Using pip

pip install powerline-k8sstatus

Configuration

The K8Sstatus segment uses a couple of custom highlight groups. You'll need to define those groups in your colorscheme, for example in .config/powerline/colorschemes/default.json:

{
  "groups": {
    "k8sstatus": {
      "fg": "brightestorange",
      "bg": "gray2",
      "attrs": []
    },
    "k8sstatus:alert": {
      "fg": "white",
      "bg": "solarized:red",
      "attrs": [
        "bold"
      ]
    },
    "k8sstatus_namespace": {
      "fg": "gray10",
      "bg": "darkestblue",
      "attrs": []
    },
    "k8sstatus_namespace:alert": {
      "fg": "darkestred",
      "bg": "solarized:yellow",
      "attrs": []
    },
    "k8sstatus_user": {
      "fg": "white",
      "bg": "green",
      "attrs": []
    },
    "k8sstatus_version": {
      "fg": "white",
      "bg": "mediumorange",
      "attrs": []
    },
    "k8sstatus:divider": {
      "fg": "white",
      "bg": "mediumorange",
      "attrs": []
    }
  }
}

Then you can activate the K8Sstatus segment by adding it to your segment configuration, for example in .config/powerline/themes/shell/default.json:

{
  "function": "powerline_k8sstatus.k8sstatus",
  "priority": 50,
  "args": {
    "show_namespace": true,
    "show_user": true,
    "show_version": true,
    "context_alert": [
      "minikube",
      "production"
    ],
    "namespace_alert": [
      "kube-system",
      "production"
    ]
  }
}
  • Context names added to the context_alert arguments will be outlined in the segment by a different colour.
  • Namespace names added to the namespace_alert arguments will be outlined in the segment by a different colour. Note that default namespace won't be shown and as result not colorized.

Reload powerline running powerline-daemon --replace to load the new settings.

By default powerline-k8sstatus will display the Kubernetes status segment context. It can be disabled temporarily if the environment variable POWERLINE_K8SSTATUS is set to 0. One way to do this would be with a simple function, such as putting this k8sstatus function in your ~/.bash_profile:

k8sstatus() {
    if [[ $POWERLINE_K8SSTATUS = "0" ]]; then
        unset POWERLINE_K8SSTATUS
    else
        export POWERLINE_K8SSTATUS=0
    fi
}

Toggle showing your Kubernetes segment in powerline by just typing k8sstatus in your terminal

Authors

Originally created by @imjoseangel

License

Licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

powerline-k8sstatus-21.2.2.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

powerline_k8sstatus-21.2.2-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file powerline-k8sstatus-21.2.2.tar.gz.

File metadata

  • Download URL: powerline-k8sstatus-21.2.2.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

File hashes

Hashes for powerline-k8sstatus-21.2.2.tar.gz
Algorithm Hash digest
SHA256 9c20ea98cf24a7441f52161a4aa9357271659c4f7adb642b15fc96e33072e52c
MD5 5a3f411fbd9eb3bb5bd692c1bb32efe2
BLAKE2b-256 4a8f478a3e29135f1f6fb4bd270335c8b13777281a61a25cd8bcda4f3482c750

See more details on using hashes here.

File details

Details for the file powerline_k8sstatus-21.2.2-py3-none-any.whl.

File metadata

  • Download URL: powerline_k8sstatus-21.2.2-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

File hashes

Hashes for powerline_k8sstatus-21.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5743f06ed0f538ce5689c5b661f9084e7d0dba95981e669e4c5d44efbeaaf7b7
MD5 2e75db18fdd93d18150dd0475324d300
BLAKE2b-256 3064e776104ad8af5c59bca8ed677c53743f9e38f0be7fa42a5d34dfdf9e7df6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page