Skip to main content

Creates a preview diagram of Kubernetes Resources without the need to apply them.

Project description

K8s Diagram Previewer

This project exists to help developers take some of the guesswork out of deploying Kubernetes definitions by providing a preview of what will actually be deployed with a set of YAML definitions.

Installation

Clone the repo and run pip install k8s-diagram

You may also need to install graphviz.

Running

This script takes one argument, a path to a folder containing K8s YAML definitions and outputs a PNG diagram at kubernetes.png representing those definitions, as well as a python file at create_diagram.py if you would like to extend the diagram with other infrastructure surrounding your project. To automatically open the image upon completion, add the --show flag.

k8s-diagram <path_to_folder>

To try out the example, run k8s-diagram ./example_yaml

For Helm Charts, simply run with the --helm flag and your chart will be templated and placed into /tmp/helm_preview_yaml/chart.yaml before the script runs.

You can also pass in a context from kubeconfig with the --cluster-context flag to pull in all supported resources from the target context prior to diagram generation.

Run k8s-diagram --help to see other available options.

Support

This tool currently supports the following Kubernetes resource types:

  • Deployment
  • Service
  • Ingress
  • Pod
  • CronJob
  • Job
  • DaemonSet
  • StatefulSet
  • ConfigMap
  • Secret
  • PersistentVolumeClaim

There is partial support for all node types listed at https://diagrams.mingrammer.com/docs/nodes/k8s but links will not be formed.

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

k8s-diagram-0.1.4.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

k8s_diagram-0.1.4-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file k8s-diagram-0.1.4.tar.gz.

File metadata

  • Download URL: k8s-diagram-0.1.4.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.7 CPython/3.9.5 Darwin/21.0.0

File hashes

Hashes for k8s-diagram-0.1.4.tar.gz
Algorithm Hash digest
SHA256 a716ec25bc6abad037f8d90fcfdf814a3a53201a11b299c3d3f3494b10fb112a
MD5 2125bee6c6dd7286b2285c0b43fb44f4
BLAKE2b-256 f3dc73f998bb28bb38366fd6a1dd3399e13441750efdd48910d177179c92a8a3

See more details on using hashes here.

File details

Details for the file k8s_diagram-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: k8s_diagram-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 6.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.7 CPython/3.9.5 Darwin/21.0.0

File hashes

Hashes for k8s_diagram-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 9453de7345b28bc15f5b8afe4caf409a3544f10ad0d5fe8205e09770ac7071ed
MD5 0ef7ad27d0309cf4ddffc52dcaa28d33
BLAKE2b-256 c0faf011581b58b2e89d2a50e9ded7f7e0c509a572bd557e17284bc6305b8357

See more details on using hashes here.

Supported by

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