{"id":19359822,"url":"https://github.com/codacy/helm-ssm","last_synced_at":"2025-04-05T18:07:13.521Z","repository":{"id":40383957,"uuid":"183050151","full_name":"codacy/helm-ssm","owner":"codacy","description":"Injects values from AWS SSM parameters on the values.yaml file","archived":false,"fork":false,"pushed_at":"2025-01-13T16:23:49.000Z","size":185,"stargazers_count":70,"open_issues_count":14,"forks_count":41,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-29T17:07:37.499Z","etag":null,"topics":["amazon-web-services","aws","codacy","hacktoberfest","helm","helm-plugin","helm-ssm","helm3","injects-values","kubernetes","ssm"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codacy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-23T16:01:16.000Z","updated_at":"2025-01-13T16:23:53.000Z","dependencies_parsed_at":"2025-02-09T09:30:27.806Z","dependency_job_id":null,"html_url":"https://github.com/codacy/helm-ssm","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codacy%2Fhelm-ssm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codacy%2Fhelm-ssm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codacy%2Fhelm-ssm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codacy%2Fhelm-ssm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codacy","download_url":"https://codeload.github.com/codacy/helm-ssm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247378141,"owners_count":20929296,"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":["amazon-web-services","aws","codacy","hacktoberfest","helm","helm-plugin","helm-ssm","helm3","injects-values","kubernetes","ssm"],"created_at":"2024-11-10T07:16:16.224Z","updated_at":"2025-04-05T18:07:13.484Z","avatar_url":"https://github.com/codacy.png","language":"Go","readme":"# Helm SSM Plugin\n\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/d3cd080edd8644e085f2f8adfd43510c)](https://www.codacy.com?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=codacy/helm-ssm\u0026amp;utm_campaign=Badge_Grade)\n[![CircleCI](https://circleci.com/gh/codacy/helm-ssm.svg?style=svg)](https://circleci.com/gh/codacy/helm-ssm)\n\nThis is a **helm3** plugin to help developers inject values coming from AWS SSM\nparameters, on the `values.yaml` file. It also leverages the wonderful [sprig](http://masterminds.github.io/sprig/)\npackage, thus making all its functions available when parsing.\n\nSince **helm2 is deprecated** the current version of the plugin only supports helm3. The last version\nto support helm2 is [v2.2.1](https://github.com/codacy/helm-ssm/releases/tag/2.2.1). There will be\nno further patches or updates to this legacy version.\n\n## Usage\n\nLoads a template file,  and writes the output.\n\nSimply add placeholders like `{{ssm \"path\" \"option1=value1\" }}` in your\nfile, where you want it to be replaced by the plugin.\n\nCurrently the plugin supports the following options:\n\n- `region=eu-west-1` - to resolve that parameter in a specific region\n- `default=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.\n- `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.\n\n### Values file\n\n```yaml\nservice:\ningress:\n  enabled: false\n  hosts:\n    - service.{{ssm \"/exists/subdomain\" }}\n    - service1.{{ssm \"/empty/subdomain\" \"default=codacy.org\" }}\n    - service2.{{ssm \"/exists/subdomain\" \"default=codacy.org\" \"region=eu-west-1\" }}\n    - service3.{{ssm \"/subdomain\" \"default=codacy.org\" \"region=eu-west-1\" \"prefix=/empty\" }}\n    - service4.{{ssm \"/securestring\" }}\n\n```\n\nwhen you do not want a key to be defined, you can use a condition and an empty default value:\n\n```yaml\nservice:\ningress:\n  enabled: false\n  hosts:\n    {{- with $subdomain := (ssm \"/exists/subdomain\" \"default=\") }}{{ if $subdomain }}\n    - service.{{$subdomain}}\n    {{- end }}{{- end }}\n\n```\n\n### Command\n\n```sh\n$ helm ssm [flags]\n```\n\n### Flags\n\n```sh\n  -c, --clean                   clean all template commands from file\n  -d, --dry-run                 doesn't replace the file content\n  -h, --help                    help for ssm\n  -p, --profile string          aws profile to fetch the ssm parameters\n  -t, --tag-cleaned string      replace cleaned template commands with given string\n  -o, --target-dir string       dir to output content\n  -f, --values valueFilesList   specify values in a YAML file (can specify multiple) (default [])\n  -v, --verbose                 show the computed YAML values file/s\n```\n\n## Example\n\n[![asciicast](https://asciinema.org/a/c2zut95zzbiKyk5gJov67bxsP.svg)](https://asciinema.org/a/c2zut95zzbiKyk5gJov67bxsP?t=1)\n\n## Install\n\nChoose the latest version from the releases and install the\nappropriate version for your OS as indicated below.\n\n```sh\n$ helm plugin add https://github.com/codacy/helm-ssm\n```\n\n### Developer (From Source) Install\n\nIf you would like to handle the build yourself, instead of fetching a binary,\nthis is how we recommend doing it.\n\n- Make sure you have [Go](http://golang.org) installed.\n\n- Clone this project\n\n- In the project directory run\n```sh\n$ make install\n```\n\n## What is Codacy\n\n[Codacy](https://www.codacy.com/) 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.\n\n### Among Codacy’s features\n\n- Identify new Static Analysis issues\n- Commit and Pull Request Analysis with GitHub, BitBucket/Stash, GitLab (and also direct git repositories)\n- Auto-comments on Commits and Pull Requests\n- Integrations with Slack, HipChat, Jira, YouTrack\n- Track issues in Code Style, Security, Error Proneness, Performance, Unused Code and other categories\n\nCodacy also helps keep track of Code Coverage, Code Duplication, and Code Complexity.\n\nCodacy supports PHP, Python, Ruby, Java, JavaScript, and Scala, among others.\n\n## Free for Open Source\n\nCodacy is free for Open Source projects.\n\n## License\n\nhelm-ssm is available under the MIT license. See the LICENSE file for more info.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodacy%2Fhelm-ssm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodacy%2Fhelm-ssm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodacy%2Fhelm-ssm/lists"}