salesforce/helm-starter

A helm plugin for managing chart starters.

helm-starter

A helm3 plugin for managing helm starters. Helm starters are used by the helm create command to customize the default chart. For example, an Istio starter can create VirtualService and DestinationRule objects, in addition to the standard Service and Deployment objects.

Example helm starters:

• https://github.com/salesforce/helm-starter-istio
• https://github.com/sitewards/helm-chart
• https://github.com/cloud104/helm-starter

Installation

> helm plugin install https://github.com/salesforce/helm-starter.git

Usage

• helm starter fetch GITURL [VERSION]: Clones a bare helm starter repo into $HELM_HOME/starters
• helm starter list: Lists all the starters in $HELM_HOME/starters
• helm starter update NAME [VERSION]: Refresh an installed Helm starter or update to a specific version
• helm starter delete NAME: Delete name from $HELM_HOME/starters
• helm starter inspect NAME: Print out a starter's readme
• helm starter --help: print help

To use a starter, run:

> helm create NAME --starter STARTERNAME

Example

> helm starter fetch https://github.com/salesforce/helm-starter-istio.git
> helm create banana-service --starter helm-starter-istio

helm-starter's Issues

Error ex

After installing the starter on this system:

SO: Windows 10 Pro 21H2
Docker Desktop 4.12.0 (85629)
Docker Engine v20.10.17
Kubernetes v1.25.0
> helm version 
version.BuildInfo{Version:"v3.8.2", GitCommit:"6e3701edea09e5d55a8ca2aae03a68917630e91b", GitTreeState:"clean", GoVersion:"go1.17.5"}

with these commands:

helm plugin install https://github.com/salesforce/helm-starter.git

> helm plugin list
NAME    VERSION DESCRIPTION
starter 1.0.0   This plugin fetches, lists, and deletes helm starters from github.

I have these errors:

> helm starter --help
Error: fork/exec C:\Users\<myuser>\AppData\Roaming\helm\plugins\helm-starter.git/starter.sh: %1 is not a valid Win32 application

> helm starter list
Error: fork/exec C:\Users\<myuser>\AppData\Roaming\helm\plugins\helm-starter.git/starter.sh: %1 is not a valid Win32 application.

Can helm repo use for helm-starter?

helm starter list just lists the current directory

From looking at the code, it seems like HELM_PATH_STARTER is not set
I'm really not sure what is supposed to be setting it.

 ☎  ~  …  halkeye-helm-charts  %    helm starter list
+ PASSTHRU=()
+ [[ 1 -gt 0 ]]
+ key=list
+ case $key in
+ PASSTHRU+=("$1")
+ shift
+ [[ 0 -gt 0 ]]
+ set -- list
+ '[' '' == TRUE ']'
+ COMMAND=list
+ '[' list == fetch ']'
+ '[' list == list ']'
+ ls -A1

helm version
version.BuildInfo{Version:"v3.3.1", GitCommit:"249e5215cde0c3fa72e27eb7a30e8d55c9696144", GitTreeState:"clean", GoVersion:"go1.14.7"}

I'm sorta seeing it working if i use helm2, so if its not upgraded to support helm 3, i'd suggest writing something in the readme to say that.