{"id":22914112,"url":"https://github.com/suse/helm-certgen","last_synced_at":"2026-03-06T05:34:36.335Z","repository":{"id":137158769,"uuid":"91601893","full_name":"SUSE/helm-certgen","owner":"SUSE","description":"Helm plugin for generation of TLS certificates","archived":false,"fork":false,"pushed_at":"2017-08-03T21:26:40.000Z","size":20845,"stargazers_count":17,"open_issues_count":2,"forks_count":10,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-26T18:54:37.065Z","etag":null,"topics":["helm","helm-charts","helm-plugin","k8s","kubernetes","tls","tls-certificate"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/SUSE.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-17T17:17:30.000Z","updated_at":"2024-02-06T08:06:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"86fd26f7-9e8b-4bbc-ad2a-f6d3015dd96f","html_url":"https://github.com/SUSE/helm-certgen","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fhelm-certgen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fhelm-certgen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fhelm-certgen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fhelm-certgen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SUSE","download_url":"https://codeload.github.com/SUSE/helm-certgen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253749435,"owners_count":21958120,"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-charts","helm-plugin","k8s","kubernetes","tls","tls-certificate"],"created_at":"2024-12-14T05:13:23.861Z","updated_at":"2026-03-06T05:34:36.290Z","avatar_url":"https://github.com/SUSE.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# helm-certgen\n\n[![Build Status](https://travis-ci.org/SUSE/helm-certgen.svg?branch=master)](https://travis-ci.org/SUSE/helm-certgen)\n\nThis repository is for `certgen` plugin for [Kubernetes Helm](https://github.com/kubernetes/helm) CLI. This plugin enables TLS certificate generation for helm charts. \n\nTo use the helm-certgen plugin, the helm charts should have a cert.yaml file which outlines the requirements for certificates (the CSR details, alias names etc.,). The plugin will use these information to generate the certificates and place them as a Kubernetes secret in the appropriate namespace.\n\nMore details about what happens behind the scene can be found @ [how certgen plugin works](docs/how-it-works.md) \n\nSince the plugin uses Kubernetes certificate API, we suggest that you use it against a Kubernetes version 1.6.4 or above.\n\nIf you are using Minikube then please follow the [minikube configuration](docs/minikube-configuration.md) guide to make sure that your minikube is setup correctly for approving CSR and issuing the certificates.\n\n## Installing the plugin\nDownload the released version of the plugin for your operating system from the [https://github.com/SUSE/helm-certgen/releases](https://github.com/SUSE/helm-certgen/releases) page. After downloading the package files, extract the archieve locally and then run the helm plugin install command on that path.\n\n```\nhelm plugin install /tmp/certgen-darwin-amd64-1-0-0-1501786067-53c4719\n```\nIf you would like to build the plugin yourself locally follow the instructions from this @ [readme](docs/build-plugin.md) \n\n## Using Plugin\nTo understand how to use the plugin, we will try to deploy sample/go-demo-app using this plugin and helm cli.\n\nMore details on how sample/go-demo-app can be found @ [sample/go-demo-app](sample/go-demo-app/README.md) \n\n### Deploying the application\n\nTo start with, make sure you have helm API (tiller) enabled on your Kubernetes cluster (using `helm init`). Also, make sure you have installed the `certgen` plugin as per [these instructions](#installing-certgen-plugin).\n\nNow let's generate the certificates. For this, we can run the following command:\n```\ncd $GOPATH/src/github.com/SUSE/helm-certgen\nhelm certgen generate sample/go-demo-app --namespace sample-go-demo-app\n```\n\nThis invokes the certgen plugin with `generate` command and provides the path of the of chart directory along with the namespace in which to deploy this chart. Once we do this, the certificates will be generated, and a secret will be created in the specified namespace.\n\nNow we should be able to deploy the application with the help of helm CLI\n```\nhelm install sample/go-demo-app --namespace sample-go-demo-app\n```\nOnce the application goes to running state, you should be able to invoke the application API.\n\nRemember to follow the steps in the minikube configuration guide to make sure that you have correct /etc/hosts entries and also the CA cert is added to your trust store.\n\n## Contribute\n\nThis project is still under active development, so you'll likely encounter [issues](https://github.com/SUSE/helm-certgen/issue).\n\nPlease participate by filing issues or contributing a pull request!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuse%2Fhelm-certgen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuse%2Fhelm-certgen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuse%2Fhelm-certgen/lists"}