npm-helm
Helm helper module for nodejs
Usage
Like usual:
npm install @digitalroute/npm-helm --save-devAnd add the following parts to your package.json (you may already have a config section, so add it inside there if you already have it.)
"config": {
"helm": {
"name": "<name-of-service>",
"repository": "<helm-repo-name>",
"namespace": "<kubernetes-namespace>",
"imageRepository": "<docker-registry-for-image>",
"binary": "<helm-binary-to-use>"
},
},
"scripts": {
"helm": "npm-helm",
"helm-install": "npm-helm docker-build package install",
},Configuration
You can put sensible defaults in your package.json file and then override where apropriate with environment variables, like in CI/CD pipelines or for local development. The package.json means inside the helm configuration.
| Environment variable | package.json | Default | Description |
|---|---|---|---|
| NPM_HELM_NAME | name | undefined | Name of service (mandatory) |
| NPM_HELM_REPOSITORY | repository | undefined | Helm repository (mandatory) |
| NPM_HELM_NAMESPACE | namespace | undefined | Kubernetes namespace (mandatory) |
| NPM_HELM_BINARY | binary | helm | Which helm binary to use, typically helm or helm3 |
| NPM_HELM_VERBOSE | verbose | false | Use verbose flags where possible when running helm or other things |
| NPM_HELM_DEBUG | debug | false | Turn on set -x for bash to get some shell debug |
| NPM_HELM_CONTEXT_ANY | contextAny | false | If set to true npm-helm will ignore kubernetes context |
| NPM_HELM_RELEASE_PREFIX | releasePrefix | undefined | Set a prefix for the installed helm chart, like prefix-name |
| NPM_HELM_VALUES | values | undefined | Add a values file to helm install/upgrade |
| NPM_HELM_CI | ci | false | If set to true it will treat things like it is doing a proper release |
| NPM_HELM_VERSION | version | false | Override the version inside package.json if needed |
| NPM_HELM_IMAGE_REPOSITORY | imageRepository | undefined | Override the docker image repository |
| NPM_HELM_BUILD_ID | buildId | undefined | Override the build id |
| NPM_HELM_PUSH_DOCKER_TAG | pushDockerTag | false | Push the original docker tag created, not the calculated version |
