Havener /ˈheɪvənə/

Introducing Havener

Convenience tool to handle tasks around Containerized CF workloads on a Kubernetes cluster. It deploys multiple Helm Charts using a configuration file, which is used to add in a tiny amount of glue code that is sometimes needed to make things work. Under to cover, havener does the same calls that helm and kubectl do, nothing special. That means that at the end you have a Helm Release just like you would have using helm alone.

How do I get started

There are different ways to get havener. You are free to pick the one that makes the most sense for your use-case.

• Docker Hub serves curated Docker images with havener as well as kubectl and other important CLI tools. There are two flavours available:

  • Alpine based images: docker pull havener/alpine-havener
  • Ubuntu based images: docker pull havener/ubuntu-havener

• On macOS systems, a Homebrew tap is available to install havener:

  brew install homeport/tap/havener

• Use a convenience script to download the latest release to install it in a suitable location on your local machine:

  curl -sL https://raw.githubusercontent.com/homeport/havener/master/scripts/download-latest.sh | bash

• Of course, you can also build it from source:

  go get github.com/homeport/havener/cmd/havener

  This might take a moment, because havener comes with a lot of dependencies in vendor that need to be downloaded and compiled as well.

Quick Command Overview

Like kubectl and helm, havener relies on the Kubernetes configuration that can be set via the KUBECONFIG environment variable. It can also be provided with the --kubeconfig flag, which takes the path to the YAML file (for example $HOME/.kube/config).

A convenience tool to handle tasks around Containerized CF workloads on a Kubernetes cluster, for example:
- Deploy a new series of Helm Charts
- Remove all Helm Releases
- Retrieve log and configuration files from all pods

See the individual commands to get the complete overview.

Usage:
  havener [command]

Available Commands:
  certs       Check certificates
  deploy      Deploy to Kubernetes
  events      Shows Cluster events
  help        Help about any command
  logs        Retrieve log files from pods
  node-exec   Execute command on Kubernetes node
  pod-exec    Execute command on Kubernetes pod
  purge       Deletes Helm Releases
  top         Shows CPU and Memory usage
  upgrade     Upgrade Helm Release in Kubernetes
  version     Shows the version

Flags:
      --kubeconfig string     Kubernetes configuration file (default "/Users/mdiester/.kube/config")
      --terminal-width int    disable autodetection and specify an explicit terminal width (default -1)
      --terminal-height int   disable autodetection and specify an explicit terminal height (default -1)
  -v, --verbose               verbose output
  -h, --help                  help for havener

Use "havener [command] --help" for more information about a command.

commands

cert command

The cert command checks whether certificates are valid or not. It automatically searches all secrets in all namespaces, so it doesn't need any flags to specify where to look.

deploy command

The deploy command installs a helm release. A config file has to be provided, either with the flag --config or by setting an environment variable HAVENERCONFIG.

• For deploying one or more helm charts, we have friendly configuration files for different IaaS. The idea behind is mainly to reduce the pain when deploying multiple charts via helm.

• The HAVENERCONFIG supports the execution of shell commands inside the values of all children keys under the release.Overrides path, e.g.: <key>: (( shell <command> | <command>))

• Deploying SCF on minikube

  minikube start --cpus 4 --disk-size 100g --memory 8192
  havener deploy --config examples/minikube-config.yml

• Installing SCF on IBM Armada

  havener deploy --config examples/armada-config.yml

logs command

It loops over all pods and all namespaces and downloads log and configuration files from some well-known hard-coded locations to a local directory. Use this to quickly scan through multiple files from multiple locations in case you have to debug an issue where it is not clear yet where to look.

node-exec command

The node-exec command executes a shell command on a node.

• For example:

  havener node-exec --tty <NODE_IP> /bin/bash

purge command

The purge command deletes all listed helm releases. This includes deployments, stateful sets, and namespaces. It requires at least one argument.

top command

The top command shows usage metrics (CPU and memory) by pod and namespace.

upgrade command

The upgrade command upgrades an existing helm release. A config file has to be provided, either with the flag --config or by setting an environment variable HAVENERCONFIG.

version command

The version command pretty much does what it says on the tin: it gives out the version currently used.

Contributing

We are happy to have other people contributing to the project. If you decide to do that, here's how to:

• get Go (havener requires Go version 1.11 or greater)
• fork the project
• create a new branch
• make your changes
• open a PR.

Git commit messages should be meaningful and follow the rules nicely written down by Chris Beams:

The seven rules of a great Git commit message

1. Separate subject from body with a blank line
2. Limit the subject line to 50 characters
3. Capitalize the subject line
4. Do not end the subject line with a period
5. Use the imperative mood in the subject line
6. Wrap the body at 72 characters
7. Use the body to explain what and why vs. how

Running test cases and binaries generation

There are multiple make targets, but running all does everything you want in one call.

make all

Test it with Linux on your macOS system

Best way is to use Docker to spin up a container:

docker run \
  --interactive \
  --tty \
  --rm \
  --volume $GOPATH/src/github.com/homeport/havener:/go/src/github.com/homeport/havener \
  --workdir /go/src/github.com/homeport/havener \
  golang:1.11.2 /bin/bash

License

Licensed under MIT License