This is a helm3 plugin to help developers inject values coming from AWS SSM
parameters, on the values.yaml
file. It also leverages the wonderful sprig
package, thus making all its functions available when parsing.
Since helm2 is deprecated the current version of the plugin only supports helm3. The last version to support helm2 is v2.2.1. There will be no further patches or updates to this legacy version.
Loads a template file, and writes the output.
Simply add placeholders like {{ssm "path" "option1=value1" }}
in your
file, where you want it to be replaced by the plugin.
Currently the plugin supports the following options:
region=eu-west-1
- to resolve that parameter in a specific regiondefault=some-value
- to give a default string value when the ssm parameter is optional. The plugin will throw an error when values are not defined and do not have a default.prefix=/something
- you can use this to specify a given prefix for a parameter without affecting the path. It will be concatenated with the path before resolving.
service:
ingress:
enabled: false
hosts:
- service.{{ssm "/exists/subdomain" }}
- service1.{{ssm "/empty/subdomain" "default=codacy.org" }}
- service2.{{ssm "/exists/subdomain" "default=codacy.org" "region=eu-west-1" }}
- service3.{{ssm "/subdomain" "default=codacy.org" "region=eu-west-1" "prefix=/empty" }}
- service4.{{ssm "/securestring" }}
when you do not want a key to be defined, use a with using a default empty value in the go templates:
service:
ingress:
enabled: false
hosts:
{{- with $subdomain := (ssm "/exists/subdomain" "default=") }}{{ if $subdomain }}
- service.{{$subdomain}}
{{- end }}{{- end }}
$ helm ssm [flags]
-d, --dry-run does not replace the file content
-h, --help help for ssm
-p, --profile string aws profile to fetch the ssm parameters
-o, --target-dir string dir to output content
-f, --values valueFilesList specify values in a YAML file (can specify multiple) (default [])
-v, --verbose show the computed YAML values file/s
Choose the latest version from the releases and install the appropriate version for your OS as indicated below.
$ helm plugin add https://github.com/codacy/helm-ssm
If you would like to handle the build yourself, instead of fetching a binary, this is how we recommend doing it.
-
Make sure you have Go installed.
-
Clone this project
-
In the project directory run
$ make install
Codacy is an Automated Code Review Tool that monitors your technical debt, helps you improve your code quality, teaches best practices to your developers, and helps you save time in Code Reviews.
- Identify new Static Analysis issues
- Commit and Pull Request Analysis with GitHub, BitBucket/Stash, GitLab (and also direct git repositories)
- Auto-comments on Commits and Pull Requests
- Integrations with Slack, HipChat, Jira, YouTrack
- Track issues in Code Style, Security, Error Proneness, Performance, Unused Code and other categories
Codacy also helps keep track of Code Coverage, Code Duplication, and Code Complexity.
Codacy supports PHP, Python, Ruby, Java, JavaScript, and Scala, among others.
Codacy is free for Open Source projects.
helm-ssm is available under the MIT license. See the LICENSE file for more info.