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.2.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.2-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: k8s-diagram-0.1.2.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.2.tar.gz
Algorithm Hash digest
SHA256 d9cf1609aa8296123081a90365ae54d5f75aa7e2ac30af7a96b43c7d40ff24ec
MD5 1265f5e236b45ebe9d6c5a83e3f875e7
BLAKE2b-256 a62f796605ed8e8b9b0c877fbb2c4b8826d790978101b7e35e4fbaf2e241eaa0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: k8s_diagram-0.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ac43d8f24e9bc26718f88604d7a24896490a5b0bc6bdd5aa4d40b2c9ad411e48
MD5 bd0e183386ce20d9466d1402babd998c
BLAKE2b-256 6d7182c7da04ed5692fdfee73764018b6344688406cb8cc338f7880ba50b95f4

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