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
Adam Reese fb8dd39268
Merge pull request #645 from adamreese/feat/kube-delete
9 years ago
_proto feat(helm, tiller): implement k8s portion of install 9 years ago
cmd Merge pull request #643 from technosophos/feat/install-k8s 9 years ago
docs feat(helm, tiller): implement k8s portion of install 9 years ago
pkg Merge pull request #645 from adamreese/feat/kube-delete 9 years ago
rootfs feat(Makefile): add a placeholder Dockerfile 9 years ago
scripts fix(local-cluster): use correct dns ip addr 9 years ago
.gitignore fix(gitignore): ignore .vimrc files 9 years ago
CONTRIBUTING.md docs(README): udate core docs pre-merge 9 years ago
LICENSE docs(README): udate core docs pre-merge 9 years ago
Makefile fix(Makefile): remove rogue line in Makefile 9 years ago
README.md fix(README): add features list 9 years ago
circle.yml fix(circleci): fix working directory 9 years ago
glide.lock feat(helm): add helm repo list command 9 years ago
glide.yaml fix(*): rewrite import paths 9 years ago
versioning.mk ref(Makefile): add default registry + "/"s 9 years ago

README.md

Kubernetes Helm

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

Features:

  • Helm now has both a client (helm) and a server (tiller). The server runs inside of Kubernetes, and manages your resources.
  • Helm's chart format has changed for the better:
    • Dependencies are immutable and stored inside of a chart's charts/ directory.
    • Charts are strongly versioned using SemVer 2
    • Charts can be loaded from directories or from chart archive files
    • Helm supports Go templates without requiring you to run generate or template commands.
    • Helm makes it easy to configure your releases -- and share the configuration with the rest of your team.
  • Helm chart repositories now use plain HTTP instead of Git/GitHub. There is no longer any GitHub dependency.
    • A chart server is a simple HTTP server
    • Charts are referenced by version
    • The helm serve command will run a local chart server, though you can easily use object storage (S3, GCS) or a regular web server.
    • And you can still load charts from a local directory.
  • The Helm workspace is gone. You can now work anywhere on your filesystem that you want to work.

Install

Helm is in its early stages of development. At this time there are no releases.

To install Helm from source, follow this process:

Make sure you have the prerequisites:

  • Go 1.6
  • A running Kubernetes cluster
  • kubectl properly configured to talk to your cluster
  • Glide 0.10 or greater
  1. Clone (or otherwise download) this repository
  2. Run make boostrap build

You will now have two binaries built:

  • bin/helm is the client
  • bin/tiller is the server

You can locally run Tiller, or you build a Docker image (make docker-build) and then deploy it (helm init -i IMAGE_NAME).

The documentation folder contains more information about the architecture and usage of Helm/Tiller.

The History of the Project

Kubernetes Helm is the merged result of Helm Classic and the Kubernetes port of GCS Deployment Manager. The project was jointly started by Google and Deis, though it is now part of the CNCF.