{"id":13647850,"url":"https://github.com/rimusz/helm-tiller","last_synced_at":"2025-04-22T06:32:10.582Z","repository":{"id":54884318,"uuid":"141905408","full_name":"rimusz/helm-tiller","owner":"rimusz","description":"Helm v2 Tiller plugin aka Tillerless Helm","archived":true,"fork":false,"pushed_at":"2020-04-11T10:15:28.000Z","size":119,"stargazers_count":254,"open_issues_count":2,"forks_count":58,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-17T02:28:51.820Z","etag":null,"topics":["helm","helm-plugin","helm-tiller","helm2","kubernetes","tiller","tillerless","tillerless-helm"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rimusz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-22T15:02:00.000Z","updated_at":"2025-02-16T06:17:33.000Z","dependencies_parsed_at":"2022-08-14T05:40:41.481Z","dependency_job_id":null,"html_url":"https://github.com/rimusz/helm-tiller","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rimusz%2Fhelm-tiller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rimusz%2Fhelm-tiller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rimusz%2Fhelm-tiller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rimusz%2Fhelm-tiller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rimusz","download_url":"https://codeload.github.com/rimusz/helm-tiller/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250183329,"owners_count":21388697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["helm","helm-plugin","helm-tiller","helm2","kubernetes","tiller","tillerless","tillerless-helm"],"created_at":"2024-08-02T01:03:48.173Z","updated_at":"2025-04-22T06:32:10.277Z","avatar_url":"https://github.com/rimusz.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Tillerless Helm v2 plugin\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![CircleCI](https://circleci.com/gh/rimusz/helm-tiller/tree/master.svg?style=svg)](https://circleci.com/gh/rimusz/helm-tiller/tree/master)\n[![Release](https://img.shields.io/github/release/rimusz/helm-tiller.svg?style=flat-square)](https://github.com/rimusz/helm-tiller/releases/latest)\n\n[Helm](https://helm.sh) v2 plugin for using [Tiller](https://docs.helm.sh/using_helm/#installing-tiller) locally and in your CI/CD pipelines.\n\nBlog post [Tillerless Helm v2](https://rimusz.net/tillerless-helm/) on why `Tillerless Helm` is needed and what it solves.\n\n## Migration to Helm v3\n\nHelm 3.0.0 has been [released](https://helm.sh/blog/helm-3-released/), check it out my blog post [How to migrate from Helm v2 to Helm v3](https://rimusz.net/how-to-migrate-from-helm-v2-to-helm-v3).\n\n## Installation\n\nInstall Helm client as per one of recommended [ways](https://docs.helm.sh/using_helm/#installing-the-helm-client).\n\n**Note:** Initialize helm with `helm init --client-only`, flag `--client-only` is a must as otherwise you will get `Tiller` installed in to Kubernetes cluster.\n\nThen install the latest plugin version:\n\n```console\nhelm plugin install https://github.com/rimusz/helm-tiller\n```\n\n## Usage\n\n**Note:** For a better security Tiller plugin comes with preset storage as `Secret`.\n\nUsage:\n\n```console\nhelm tiller install\nhelm tiller start [tiller_namespace]\nhelm tiller start-ci [tiller_namespace]\nhelm tiller stop\nhelm tiller run [tiller_namespace] -- [command] [args]\n\nAvailable Commands:\ninstall   Manually install/upgrade Tiller binary\nstart     Start Tiller and open new pre-set shell\nstart-ci  Start Tiller without opening new shell\nrun       Start Tiller and run arbitrary command within the environment\nstop      Stop Tiller\n```\n\nAvailable environment variables:\n\n- To silence plugin specific messages by setting `HELM_TILLER_SILENT=true`, only `helm` cli output will be printed.\n- To change default Tiller port by setting `HELM_TILLER_PORT=44140`, default is `44134`.\n- To change default Tiller probe port by setting `HELM_TILLER_PROBE_PORT=44141`, default is `44135` - requires Helm \u003e= 2.14.\n- To change Tiller storage to `configmap` by setting `HELM_TILLER_STORAGE=configmap`, default is `secret`.\n- To store Tiller logs in `$HOME/.helm/plugins/helm-tiller/logs` by setting `HELM_TILLER_LOGS=true`.\n- You can set a specific folder/file for Tiller logs by setting `HELM_TILLER_LOGS_DIR=/some_folder/tiller.logs`.\n- To change default Tiller maximum number of releases kept in release history by setting e.g. to 20 `HELM_TILLER_HISTORY_MAX=20`.\n- To not automatically create a namespace if it is missing by setting `CREATE_NAMESPACE_IF_MISSING=false`.\n\n### Tiller start examples\n\nStart Tiller with pre-set `bash` shell `HELM_HOST=127.0.0.1:44134`, it is handy to use locally:\n\n```console\nhelm tiller start\n```\n\nThe default working Tiller `namespace` is `kube-system`, you can set another one:\n\n```console\nhelm tiller start my_tiller_namespace\n```\n\n\u003e **Tip**: You can have many Tiller namespaces, e.g. one per team, just pass the name as an argument when you starting Tiller.\n\nIn CI pipelines you do not really need pre-set bash to be opened, so you can use:\n\n```console\nhelm tiller start-ci\nexport HELM_HOST=127.0.0.1:44134\n```\n\nThen your `helm` will know where to connect to Tiller and you do not need to make any changes in your CI pipelines.\n\nAnd when you done stop the Tiller:\n\n```console\nhelm tiller stop\n```\n\n### Tiller run examples\n\nAnother option for CI workflows.\n\nExamples use of `tiller run`, that starts/stops `tiller` before/after the specified command:\n\n```console\nhelm tiller run helm list\nhelm tiller run my-tiller-namespace -- helm list\nhelm tiller run my-tiller-namespace -- bash -c 'echo running helm; helm list'\n```\n\nHandy `bash` aliases for use `Tillerless` locally:\n\n```\nalias hh=\"helm tiller run helm\"\nalias hr=\"helm tiller run\"\nalias ht=\"helm tiller start\"\nalias hts=\"helm tiller stop\"\n```\n\nExamples of alias use:\n\n```console\n# helm tiller run helm list\nhh ls\n\n# helm tiller run my-tiller-namespace -- helm list\nhr my-tiller-namespace -- helm list\n\n# helm tiller run my-tiller-namespace -- bash -c 'echo running helm; helm list'\nhr my-tiller-namespace -- bash -c 'echo running helm; helm list'\n```\n\n### Terraform Tiller examples\nTo use tiller with [terraform-helm-provider](https://www.terraform.io/docs/providers/helm/index.html), use `helm tiller start-ci` and set the helm provider's host to point to the locally started tiller.\n\n```console\n$ helm tiller start-ci\n```\n\n```hcl\nprovider \"helm\" {\n  host = \"127.0.0.1:44134\"\n  install_tiller = false\n}\n```\n\nThis will greatly simplify your usage of `terraform-helm-provider` as there is no longer a need to create service accounts, and deploy tiller along with the problems that come with it.\n\n### Using Tiller with Minikube\nWhile using [Minikube](https://kubernetes.io/docs/setup/minikube/), it is important to stop, and restart tiller after a `minikube delete` and `minikube start`.\n\n```console\n$ minikube delete\n$ minikube start\n$ helm tiller stop\n$ helm tiller start\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frimusz%2Fhelm-tiller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frimusz%2Fhelm-tiller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frimusz%2Fhelm-tiller/lists"}