kcpcl

README

kcpcl

CLI tool and consumable library that supports download and upload operations which download objects from a k8s cluster into a local directory and upload objects from that local directory into a target k8s cluster.

Useful to load "test" clusters with "real" world cluster objects with minimal latency.

Usage

End user

1. Install: go install github.com/elankath/kcpcl
2. See help: kcpcl -h

Developer

Use the Makefile targets

1. See Available Make Targets: make help
2. GARDNER CLUSTERS: Generate viewer kubeconfigs for a cluster: make genkubeconfig
   1. Requres LANDSCAPE, PROJECT and SHOOT env variables to be set.
   2. This creates viewer kubeconfigs for a cluster and downloads them into the gen folder.
3. Build Binary: make build
4. Execute Download: ./bin/kcpcl -k gen/<cluster-name>.yaml -d /tmp/<cluster-name>
   1. Uses a default list of GVR that allow the kube-scheduler to successfully assign pods to nodes.
   2. Example: ./bin/kcpcl download -k gen/garden-i034796--aw-external.yaml -d /tmp/aw
5. Execute Upload: ./bin/kcpcl -k gen/<cluster-name>.yaml -d /tmp/<cluster-name>
   1. Example: ./bin/kcpcl upload -k /tmp/kvcl.yaml -d /tmp/aw #Using virtual cluster from https://github.com/unmarshall/kvcl