The Kubernetes Package Manager
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Go to file
Matt Butcher 386dc920f8
Merge pull request #2140 from lcharkiewicz/get-script-fix
8 years ago
_proto feat(proto): add deprecated field 8 years ago
cmd ref/installer: pass arguments in options struct to installer apis 8 years ago
docs document toYaml syntax in --set for annotations 8 years ago
pkg ref(helmpath): simplify path building of helmpath 8 years ago
rootfs set $HOME in tiller container to /tmp 8 years ago
scripts Add checking installed helm version before downloading latest release 8 years ago
.gitignore Ignore .idea folder for anyone using Intellij's GO IDE. 8 years ago
.travis.yml feat(ci): add travis configuration 8 years ago
CONTRIBUTING.md docs(CONTRIBUTING): switch to CNCF CLA 8 years ago
LICENSE fix(LICENSE): add copyright year and authors 8 years ago
Makefile Add script to clean homedir out of docs 8 years ago
OWNERS docs(OWNERS): initial add of owners file 8 years ago
README.md docs(README): update downloads to 2.2.2. 8 years ago
circle.yml chore(*): bump go1.7.4 8 years ago
code-of-conduct.md docs(code-of-conduct): redirect to official CNCF CoC 8 years ago
glide.lock feat(tiller): update to Sprig 2.10. 8 years ago
glide.yaml feat(tiller): update to Sprig 2.10. 8 years ago
versioning.mk feat(*): add git tree state to binaries 8 years ago

README.md

Kubernetes Helm

CircleCI Go Report Card

Helm is a tool for managing Kubernetes charts. Charts are packages of pre-configured Kubernetes resources.

Use Helm to...

  • Find and use popular software packaged as Kubernetes charts
  • Share your own applications as Kubernetes charts
  • Create reproducible builds of your Kubernetes applications
  • Intelligently manage your Kubernetes manifest files
  • Manage releases of Helm packages

Helm in a Handbasket

Helm is a tool that streamlines installing and managing Kubernetes applications. Think of it like apt/yum/homebrew for Kubernetes.

  • Helm has two parts: a client (helm) and a server (tiller)
  • Tiller runs inside of your Kubernetes cluster, and manages releases (installations) of your charts.
  • Helm runs on your laptop, CI/CD, or wherever you want it to run.
  • Charts are Helm packages that contain at least two things:
    • A description of the package (Chart.yaml)
    • One or more templates, which contain Kubernetes manifest files
  • Charts can be stored on disk, or fetched from remote chart repositories (like Debian or RedHat packages)

Install

Binary downloads of the Helm client can be found at the following links:

Unpack the helm binary and add it to your PATH and you are good to go! macOS/homebrew users can also use brew install kubernetes-helm.

To rapidly get Helm up and running, start with the Quick Start Guide.

See the installation guide for more options, including installing pre-releases.

Docs

Get started with the Quick Start guide or plunge into the complete documentation

Roadmap

The Helm roadmap is currently located on the wiki.

Community, discussion, contribution, and support

You can reach the Helm community and developers via the following channels:

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.