{"id":18122025,"url":"https://github.com/sstarcher/helm-release","last_synced_at":"2025-04-14T20:20:29.707Z","repository":{"id":57521688,"uuid":"126866112","full_name":"sstarcher/helm-release","owner":"sstarcher","description":"Helm Plugin for automatic versioning of helm charts","archived":false,"fork":false,"pushed_at":"2020-05-26T15:43:16.000Z","size":1356,"stargazers_count":69,"open_issues_count":3,"forks_count":16,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-28T08:35:38.304Z","etag":null,"topics":["cicd","helm-charts","helm-plugin","jenkins","kubernetes"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sstarcher.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":"2018-03-26T17:38:58.000Z","updated_at":"2025-02-24T15:45:07.000Z","dependencies_parsed_at":"2022-09-26T18:10:34.510Z","dependency_job_id":null,"html_url":"https://github.com/sstarcher/helm-release","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstarcher%2Fhelm-release","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstarcher%2Fhelm-release/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstarcher%2Fhelm-release/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstarcher%2Fhelm-release/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sstarcher","download_url":"https://codeload.github.com/sstarcher/helm-release/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248952345,"owners_count":21188427,"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":["cicd","helm-charts","helm-plugin","jenkins","kubernetes"],"created_at":"2024-11-01T06:17:31.953Z","updated_at":"2025-04-14T20:20:29.682Z","avatar_url":"https://github.com/sstarcher.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Helm Release\n\n[![CircleCI](https://circleci.com/gh/sstarcher/helm-release.svg?style=shield)](https://circleci.com/gh/sstarcher/helm-release)\n[![GitHub release](https://img.shields.io/github/release/sstarcher/helm-release.svg)](https://github.com/sstarcher/helm-release/releases)\n\nProvides simple semantic versioning based from previous git tags.\n\nThis allows you to run a single command and package the next version of your chart.  This project allows you to combine your Dockerfile and Helm Chart in a single repository and automatically version the Helm chart on a build.\n\n## Install\n\nYou can install a specific release version:\n\n    $ helm plugin install https://github.com/sstarcher/helm-release\n\n## Usage\n\n* helm release CHART - Would determine the next tag for the chart and update the Chart.yaml and values.yaml image.tag\n* helm release CHART -t 12345 - Would update Chart.yaml and modify values.yaml images.tag to equal 12345\n* helm release CHART --print-computed-version - Would determine the next tag and print it to STDOUT\n* helm release CHART --skip-application-version - Would determine the next tag for the chart and update the Chart.yaml.\n\n# Source\n\nHelm Release supports different release logic for difference sources\n\n### Helm\n\nWhen using the `--source helm` you must specify `--bump` of major, minor, or patch.\n\n### Git\n#### Release Logic\n\nTo describe the release naming process we will use the following nomenclature.\n* LAST_TAG - finds the previous tag from the git history using `git describe --tags`\n* NEXT_TAG - uses LAST_TAG and increments the patch by 1\n* COMMITS - finds the total number of commits using `git describe --tags`\n* TAG - is used when COMMITS has a value of 0 as in the current commit has been specifically tagged\n* SHA - uses a short git sha using `git rev-parse --short HEAD` with the `g` prefix removed\n* BRANCH - finds the current branch name using `git rev-parse --abbrev-ref HEAD`\n  * overridden using BRANCH_NAME environment variable\n  * always converted to lowercase\n  * strips any characters that don't match - https://semver.org/#spec-item-9\n  * We prefix BRANCH with `0.` to ensure it's the lowest version\n\nThe default version for a branch is `NEXT_TAG-0.BRANCH-COMMITS+SHA`\n\n#### Tags\n\nWhen COMMITS is equal to 0 we assume the intent is to do a release of the current commit and the version will be the tag itself `TAG+SHA`\n\n*NOTE* Tags should be annotated tags and not lightweight tags.  Tags created in the Github UI will be lightweight tags by default.\n\n\n#### Master branch\n\nThe master branch is treated differently from the default and will be `NEXT_TAG-COMMITS+SHA`\n\n#### Integrated Support for Jenkins and PR branches\n\nJenkins uses the environment variable BRANCH_NAME with the value of the PR example `PR-97`.  This will result in a release version of `NEXT_TAG-0.pr-97-COMMITS+SHA`\n\n## Install without internet\n\n* Grab the tar file for your system from the [releases](https://github.com/sstarcher/helm-release/releases)\n```\n  $ eval $(helm env) # Get helm environment variable for plugin location $HELM_PLUGINS\n  $ mkdir /Users/sstarcher/Library/helm/plugins/helm-release\n  $ tar -xvf DOWNLOADED_TAR_GZ -C /Users/sstarcher/Library/helm/plugins/helm-release\n```\n\n## Uninstall\n\n    $ helm plugin remove release\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsstarcher%2Fhelm-release","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsstarcher%2Fhelm-release","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsstarcher%2Fhelm-release/lists"}