{"id":21539311,"url":"https://github.com/nextdoor/helm-create-tag-from-version-action","last_synced_at":"2025-08-25T07:33:53.595Z","repository":{"id":146805871,"uuid":"381710076","full_name":"Nextdoor/helm-create-tag-from-version-action","owner":"Nextdoor","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-30T21:54:26.000Z","size":9,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-07-01T01:41:54.614Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nextdoor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-30T13:23:21.000Z","updated_at":"2023-10-31T20:34:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"dbe793b6-5226-4328-977d-52ed39f856e6","html_url":"https://github.com/Nextdoor/helm-create-tag-from-version-action","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Nextdoor/helm-create-tag-from-version-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fhelm-create-tag-from-version-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fhelm-create-tag-from-version-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fhelm-create-tag-from-version-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fhelm-create-tag-from-version-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nextdoor","download_url":"https://codeload.github.com/Nextdoor/helm-create-tag-from-version-action/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nextdoor%2Fhelm-create-tag-from-version-action/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272024632,"owners_count":24860528,"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","status":"online","status_checked_at":"2025-08-25T02:00:12.092Z","response_time":1107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-11-24T04:14:43.131Z","updated_at":"2025-08-25T07:33:53.574Z","avatar_url":"https://github.com/Nextdoor.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `helm-create-tag-from-version-action`\n\n[docker-image-retag-action]: https://github.com/Nextdoor/docker-image-retag-action\n[helm-set-image-tag-action]: https://github.com/Nextdoor/helm-set-image-tag-action\n\nThis simple Github Action is designed to help you automatically create tags\nfrom your Helm Chart. You would run this action after you have updated your\nHelm Chart version (and committed the change) - and this chart would then\ncreate a tag named `{{ .Chart.Name }}-{{ .Chart.Version }}` for you.\n\n## Basic Flow\n\nThe idea behind the workflow below is that there is both \"application code\" and\n\"chart code\" in your repository - and these are fundamentally separate but\nrelated. A developer will usually iterate rapidly on the application code,\nwhile iterating less frequently on the chart code.\n\nBecause your Helm Chart is supposed to point at a specific (and already\nexisting) Docker Image tag, it is not easy to coordinate one git tag that\nhas both the updated chart values AND has already built/published the\nDocker image. Instead, we treat these two different sets of artifacts as\nindependent releases from within the same repository.\n\nThe developer is responsible for iterating on their application code, and\ncreating the tag that triggers the build/publishing of their release artifact\n(the application Docker image). From there, the CI system automatically updates\nthe Helm chart values, revs its version, and then publishes a new tag and\nGithub Release.\n\n1. Developer pushes their application code continually to `HEAD`\n2. Developer tags an application release `v1.2.3`\n3. CI system builds Docker artifact `myapp:v1.2.3`\n   (hint: see [Nextdoor/docker-image-retag-action][docker-image-retag-action])\n4. CI system updates `chart/values.yaml` and `chart/Chart.yaml` setting the\n   Chart version to `0.1.52`.\n   (hint: see [Nextdoor/helm-set-image-tag-action][helm-set-image-tag-action])\n5. This action then generates a new Github Tag pointing to `myapp-chart-0.1.52`\n   and also moves the `production` tag to the same commit.\n\n## Features\n\n### Release Cutting\n\nBy default, this action will also create a matching Github Release for your\ntag. This requires that you set the `GITHUB_TOKEN` environment variable and\nprovide that token with the right privileges.\n\n### Tag Moving\n\nIn addition to creating a new git tag, this action can also _move_ an existing\ntag to point to the current tag that was just created. This is useful if you\nhave a regular tag that you point developers or applications at (say `stable`\nor `production`) and you want to move that tag along with your releases.\n\n## Usage\n\n```yaml\n# .github/workflows/release.yml\nname: Release\non:\n  push:\n    branches:\n      - '!*'\n    tags:\n      - v*\njobs:\n  release:\n    runs-on: ubuntu-latest\n    steps:\n    - uses: actions/checkout@master\n      with:\n        fetch-depth: '0'\n\n    # ... insert your code here that handles automatically updating your Helm\n    # Chart version and values... or use something like our\n    # helm-set-image-tag-action.\n    - name: Update Helm Chart Values\n      uses: Nextdoor/helm-set-image-tag-action@main\n      with:\n        verbose: true\n        tag: ${{ github.ref }}\n        values: charts/app/values.yaml\n        keys: .image.tag\n        bump_level: patch\n        commit_branch: main\n\n    - name: Create Chart Release Tag\n      uses: Nextdoor/helm-create-tag-from-version-action@main\n      env:\n        GITHUB_TOKEN: ${{ github.token }}\n      with:\n        verbose: true\n        chart_dir: charts/app\n        create_release: true\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextdoor%2Fhelm-create-tag-from-version-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextdoor%2Fhelm-create-tag-from-version-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextdoor%2Fhelm-create-tag-from-version-action/lists"}