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

Uploaded Python 3

File details

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

File metadata

  • Download URL: k8s-diagram-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 5d35be3f1acd194329f109cd40a7308e1387e8d78b21b4b0ba2c5e4e54b66350
MD5 b3df765f735ccca1d69b328bb9537be8
BLAKE2b-256 b232b1e4097309c8152042b6e52ddeaf1d8905093aec4ee966fde1e387010287

See more details on using hashes here.

File details

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

File metadata

  • Download URL: k8s_diagram-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 429d2f9c58a61021953526be4335159cf62581cd2c46aacff3c1baab9706e82e
MD5 ec5aaedf209cdd488da3374716818f81
BLAKE2b-256 02fad71f22450a111ecd47f5c4f0fac781827b8f7f155004a784a7ca1dfdf894

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