Skip to content

Latest commit

 

History

History
87 lines (57 loc) · 3.3 KB

README.md

File metadata and controls

87 lines (57 loc) · 3.3 KB
Raw

habitat-operator

Installs habitat-operator to manage Habitat services in a Kubernetes cluster.

Introduction

This chart bootstraps a habitat-operator deployment in a Kubernetes cluster using the Helm package manager.

Prerequisites

Note: If you have Kubernetes and Helm installed, skip to [this section](#Installing the Chart).

See Habitat Operator's README.

RBAC

If role-based access control (RBAC) is enabled in your cluster, you may need to give Tiller (the server-side component of Helm) additional permissions. If RBAC is not enabled, be sure to set rbacEnable to false when installing the chart.

  1. Create a ServiceAccount for Tiller in the kube-system namespace
$ kubectl -n kube-system create sa tiller
  1. Create a ClusterRoleBinding for Tiller
$ kubectl create clusterrolebinding tiller --clusterrole cluster-admin --serviceaccount=kube-system:tiller
  1. Install Tiller, specifying the new ServiceAccount
$ helm init --service-account tiller

Installing the Chart

To install the chart with the release name my-release:

$ helm repo add habitat https://habitat-sh.github.io/habitat-operator/helm/charts/stable/
$ helm install --name my-release habitat/habitat-operator

The command deploys habitat-operator on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Uninstalling the Chart

To uninstall/delete the my-release deployment:

$ helm delete my-release

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following table lists the configurable parameters of the habitat-operator chart and their default values.

Parameter Description Default
image.repository Image docker.io/habitat/habitat-operator
image.tag Image tag The latest release tag (e.g v0.8.1)
image.pullPolicy Image pull policy IfNotPresent
nodeSelector Node labels for pod assignment {}
rbacEnable If true, create & use RBAC resources true
resources Pod resource requests & limits {}
operatorNamespaced If this operator should run scoped to Single namespace false
namespace Namespace this operator should run inside habitat-operator

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install --name my-release habitat/habitat-operator --set sendAnalytics=true

Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,

$ helm install --name my-release habitat/habitat-operator -f values.yaml

Tip: You can use the default values.yaml

Hosting

The Helm chart repository is managed on the gh-pages branch and instructions for repository management can be found here.