Skip to content

Latest commit

 

History

History
69 lines (51 loc) · 2.75 KB

README.md

File metadata and controls

69 lines (51 loc) · 2.75 KB
Raw

The Tiller-RBAC Plugin

This Helm plugin allows you to add an RBAC profile to a Tiller in a Kubernetes namespace. An RBAC Profile is a Helm chart that consists of a Kubernetes Role and RoleBinding definition. This plugin is designed to help the team of operators that set up multiple Tillers in their cluster (one Tiller per namespace) ensure that a Tiller is locked down to specific actions on specific Kubernetes resources in a given namespace.

Usage

$ helm tiller-rbac [flags] RBAC_PROFILE

Flags

 --namespace string   namespace of Tiller to apply profile (default "default")

Install

$ helm plugin install https://github.com/michelleN/helm-tiller-rbac

The above will fetch the latest binary release of helm tiller-rbac and install it.

Developer (From Source) Install

If you would like to handle the build yourself, instead of fetching a binary, this is how recommend doing it.

First, set up your environment:

  • You need to have Go installed. Make sure to set $GOPATH
  • If you don't have Glide installed, the instructions below will install it into $GOPATH/bin for you.

Clone this repo into your $GOPATH using git. You can use the command You can use go get -d github.com/michelleN/helm-tiller-rbac for that.

$ cd $GOPATH/src/github.com/michelleN/helm-tiller-rbac
$ make bootstrap build
$ SKIP_BIN_INSTALL=1 helm plugin install $GOPATH/src/github.com/michelleN/helm-tiller-rbac

That last command will skip fetching the binary install and use the one you built.

Example Workflow

First, you'll need to set up Tiller in the namespace you want.

$ kubectl create namespace dev-team
# install tiller in a namespace like this:
$ helm init --tiller-namespace dev-team

Then, use the tiller-rbac plugin to apply the example dev-team RBAC profile in this repo.

$ helm tiller-rbac --namespace dev-team example-profiles/dev-team/
serviceaccount "dev-team-rbac-profile" created
rolebinding "dev-team-tiller-binding" created
role "dev-team" created

Congrats! Your Tiller in the dev-team namespace is secured with the dev-team-rbac-profile service account
You can verify your Tiller config by running this command
	$ kubectl -n dev-team get deployment tiller-deploy -o json

You should now have a Tiller in the dev-team namespace that is only allowed to do the things specified in example-profiles/dev-team/templates/role-tiller.yaml

Contributing

Contribute to this project by opening up a pull request. Be sure to sign your commits, as this project uses the DCO. You can sign your commits by adding the -s flag to your commit.

Example

$ git commit -s -m "just signing my cute commits. <info emoji>"