{"id":22147365,"url":"https://github.com/hydeenoble/helm-subenv","last_synced_at":"2025-07-17T21:39:51.237Z","repository":{"id":38026885,"uuid":"382701910","full_name":"hydeenoble/helm-subenv","owner":"hydeenoble","description":"This Helm plugin allows you to substitute the environment variables specified in your helm values file with their respective values in the environment from within a CICD pipeline.","archived":false,"fork":false,"pushed_at":"2022-09-08T08:07:49.000Z","size":6205,"stargazers_count":23,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T19:42:38.648Z","etag":null,"topics":["env","environment-variables","helm","helm-plugin","helm-plugins","substitute","values"],"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/hydeenoble.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}},"created_at":"2021-07-03T20:12:37.000Z","updated_at":"2024-09-16T09:02:20.000Z","dependencies_parsed_at":"2022-08-29T17:13:33.737Z","dependency_job_id":null,"html_url":"https://github.com/hydeenoble/helm-subenv","commit_stats":null,"previous_names":["hydeenoble/helm-env"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/hydeenoble/helm-subenv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydeenoble%2Fhelm-subenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydeenoble%2Fhelm-subenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydeenoble%2Fhelm-subenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydeenoble%2Fhelm-subenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hydeenoble","download_url":"https://codeload.github.com/hydeenoble/helm-subenv/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydeenoble%2Fhelm-subenv/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265663428,"owners_count":23807468,"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":["env","environment-variables","helm","helm-plugin","helm-plugins","substitute","values"],"created_at":"2024-12-01T23:16:58.695Z","updated_at":"2025-07-17T21:39:51.209Z","avatar_url":"https://github.com/hydeenoble.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# helm-subenv\n[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)\n[![GitHub release](https://img.shields.io/github/v/release/hydeenoble/helm-subenv.svg)](https://github.com/hydeenoble/helm-subenv/releases)\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/helm-subenv)](https://artifacthub.io/packages/search?repo=helm-subenv)\n\nThis Helm plugin allows you to substitute the environment variables specified in your helm values file with their respective values in the environment from within a CICD pipeline.\n\n## Install\n\nThe installation itself is simple as:\n\n```bash\nhelm plugin install https://github.com/hydeenoble/helm-subenv.git\n```\nYou can install a specific release version:\n```bash\nhelm plugin install https://github.com/hydeenoble/helm-subenv.git --version \u003crelease version\u003e\n```\n\nTo use the plugin, you do not need any special dependencies. The installer will download the latest release with prebuilt binary from [GitHub releases](https://github.com/hydeenoble/helm-subenv/releases).\n\n## Usage\n\n### Single file usage\n```bash\nhelm subenv -f \u003cpath to values file\u003e\n```\n\n### Multiple files usage\n```bash\nhelm subenv -f \u003cpath to values file\u003e -f \u003cpath to values file\u003e -f \u003cpath to values file\u003e\n```\n\n### Directory usage\nThe plugin can also be used to recursively substitute environment variables in all the files in a specified directory.\n```bash\nhelm subenv -f \u003cpath to directory\u003e\n```\n\n### Mix files and directories\nYou can also decide to mix files and directories:\n```bash\nhelm subenv -f \u003cpath to values file\u003e -f \u003cpath to directory\u003e\n```\n\n## Example\nSample helm values file:\n```yaml\n# values.yaml\n\nimage:\n  repository: $REGISTRY/$IMAGE_NAME\n  tag: $IMAGE_TAG\n```\nEnvironment variables configured in your environment (this should most likely be configured with your CI environment): \n```txt\nREGISTRY =\u003e docker.com\nIMAGE_NAME =\u003e helm-subenv\nIMAGE_TAG =\u003e test\n```\nSubstitute Env:\n```bash\nhelm subenv -f values.yaml\n```\nResult: \n```yaml\nimage:\n  repository: docker.com/helm-subenv\n  tag: test\n```\n**Note:** If the value of the environment variable does not exist, it will be replaced with an empty string. For instance, from the above example, if `IMAGE_TAG` does not exist as an environment variable in the environment the result would have been: \n\n```yaml\nimage:\n  repository: docker.com/helm-subenv\n  tag:\n```\n\n## Uninstall\n```bash\nhelm plugin remove subenv\n```\n\n## Testing locally\nTo test locally, run the command below to build and run the binary: \n\u003e You need to have [Go](https://go.dev/) installed. Make sure to set `$GOPATH`\n```bash\ngo build -o subenv \u0026\u0026 ./subenv -f \u003c/path/to/values/file\u003e\n```\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydeenoble%2Fhelm-subenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhydeenoble%2Fhelm-subenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydeenoble%2Fhelm-subenv/lists"}