Michal.Wrobel/openbao-helm
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Helm chart to install OpenBao and other associated components.
52 commits 11 branches 48 tags 1.4 MiB
Shell 89.9%
Smarty 8%
HCL 0.9%
Makefile 0.7%
Dockerfile 0.5%
Find a file
Maciek Misztal febaab96fa #7 added an optional storageClass to the server-statefuset
2018-09-20 21:35:08 +02:00
templates #7 added an optional storageClass to the server-statefuset 2018-09-20 21:35:08 +02:00
test Add consul-dns service 2018-09-11 17:53:02 -07:00
.gitignore Move all terraform setup to test/terraform 2018-08-20 16:16:22 -07:00
.helmignore Ignore bin dirs 2018-08-20 17:30:52 -07:00
Chart.yaml Add consul-helm repo to Chart.yaml 2018-09-05 07:52:27 -07:00
LICENSE.md Add license 2018-08-17 22:09:05 -07:00
Makefile Initial stuff 2018-08-20 15:26:37 -07:00
README.md Merge pull request #5 from jmreicha/master 2018-09-17 12:40:34 -07:00
values.yaml #7 added an optional storageClass to the server-statefuset 2018-09-20 21:35:08 +02:00

README.md

Consul Helm Chart

This repository contains the official HashiCorp Helm chart for installing and configuring Consul on Kubernetes. This chart supports multiple use cases of Consul on Kubernetes depending on the values provided.

For full documentation on this Helm chart along with all the ways you can use Consul with Kubernetes, please see the Consul and Kubernetes documentation.

Prerequisites

To use the charts here, Helm must be installed in your Kubernetes cluster. Setting up Kubernetes and Helm and is outside the scope of this README. Please refer to the Kubernetes and Helm documentation.

The versions required are:

  • Helm 2.10+ - This is the earliest version of Helm tested. It is possible it works with earlier versions but this chart is untested for those versions.
  • Kubernetes 1.9+ - This is the earliest version of Kubernetes tested. It is possible that this chart works with earlier versions but it is untested. Other versions verified are Kubernetes 1.10, 1.11.

Usage

For now, we do not host a chart repository. To use the charts, you must download this repository and unpack it into a directory. Either download a tagged release or use git checkout to a tagged release. Assuming this repository was unpacked into the directory consul-helm, the chart can then be installed directly:

helm install ./consul-helm

Please see the many options supported in the values.yaml file. These are also fully documented directly on the Consul website.

Testing

The Helm chart ships with both unit and acceptance tests.

The unit tests don't require any active Kubernetes cluster and complete very quickly. These should be used for fast feedback during development. The acceptance tests require a Kubernetes cluster with a configured kubectl. Both require Bats and helm to be installed and available on the CLI. The unit tests also require the correct version of yq if running locally.

To run the unit tests:

bats ./test/unit

To run the acceptance tests:

bats ./test/acceptance

If the acceptance tests fail, deployed resources in the Kubernetes cluster may not be properly cleaned up. We recommend recycling the Kubernetes cluster to start from a clean slate.

Note: There is a Terraform configuration in the test/terraform/ directory that can be used to quickly bring up a GKE cluster and configure kubectl and helm locally. This can be used to quickly spin up a test cluster for acceptance tests. Unit tests do not require a running Kubernetes cluster.