README.md

Getting Started

A quick start guide to get Kepler up and running inside your container-based development cluster.

To create a new emphemeral local kubernetes cluster

You can bring the cluster up with:

export CLUSTER_PROVIDER=`kind`
make cluster-up

For more information please read our

Then build and run kepler on your cluster

First, point the Makefile to the container registry of your choice:

export IMAGE_REPO=index.docker.io/myrepo
export IMAGE_TAG=mybuild

We assume that you have logged in your container registry

Then point the Makefile to cluster provider to build the right manifests:

export CLUSTER_PROVIDER=kubernetes

By default we use the IMAGE_TAG=devel and CLUSTER_PROVIDER=kubernetes

After that, build the manifests and images:

make build-manifest
make _build_containerized
make push-image

If successful, the manifests are at _output/manifest/$CLUSTER_PROVIDER/

Finally, push the manifests to your cluster:

make cluster-deploy

Or just simply build and deploy with:

make cluster-sync

To run kepler externally to the cluster

This quick tutorial is for developing and testing Kepler locally but with access to kubelet

Install bcc-devel and kernel-devel

Refer to the builder Dockerfile

Compile

Go to the root of the repo and do the following:

 make _build_local

If successful, the binary is at _output/bin/_/kepler

Test

Create the k8s role and token, copy data files, this is only needed once.

cd dev/
./create_k8s_token.sh
./prepare_dev_env.sh

Then run the Kepler binary at _output/bin/_/kepler

Build kepler and base multi-arch images

./hack/build-images.sh help