keightool (k8-tool) - the 'k' stands for kowboy 🤠

A Container Image and YAML to mess around inside Kubernetes.

What's included?

• git
• fish shell
• openssh-client
• curl
• dnsutils
• jq
• netcat
• tcpdump

The most up-to-date list can be found inside the Dockerfile

The Docker Image is available on Docker Hub as gzur/keightool

Installation

The yeehaaw way

1. NAMESPACE=default kubectl apply --namespace $NAMESPACE -f https://raw.githubusercontent.com/gzur/keightool/main/yaml/keightool.yaml

2. NAMESPACE=default kubectl exec --namespace $NAMESPACE -it $(kubectl get pods -l app=keightool -o jsonpath='{@.items[0].metadata.name}') -- bash

3. You should now be in an interactive a shell, running in a pod, inside your cluster.

The other way

Pre-requisites

• An active kube context against the cluster you're cowboying 🤠
• kubectl

Installing via make

1. Clone this repo.

2. Make sure your kubecontext is pointing towards the namespace you want to install into.

3. make k8s.up 

Uninstalling via make

1. Make sure your kubecontext is pointing towards the namespace you installed keightool into.

2. make k8s.down 

Usage via make

make k8s.shell

You should now have a shell inside the running keightool pod.

Press Ctrl-D to exit the pod

Contributing

1. Fork
2. Make a change.
3. Bump the VERSION - let SemVer guide your way.
4. Create a Pull Request

Releasing

1. Push a tag which matches the content of the VERSION file.
2. Github Actions takes care of the rest.