{"id":16539532,"url":"https://github.com/rickstaa/action-update-semver","last_synced_at":"2025-10-28T14:31:17.236Z","repository":{"id":37030108,"uuid":"328673086","full_name":"rickstaa/action-update-semver","owner":"rickstaa","description":"Updates major/minor release tags on a tag push.","archived":false,"fork":false,"pushed_at":"2024-05-23T14:01:47.000Z","size":122,"stargazers_count":2,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-09-12T23:57:58.880Z","etag":null,"topics":["continious-integration","docker","gh-action","github-action-docker","github-actions","semver","versioning"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/update-semver","language":"Shell","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/rickstaa.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["rickstaa"]}},"created_at":"2021-01-11T13:29:28.000Z","updated_at":"2023-11-06T14:20:10.000Z","dependencies_parsed_at":"2023-01-20T10:49:06.312Z","dependency_job_id":null,"html_url":"https://github.com/rickstaa/action-update-semver","commit_stats":{"total_commits":25,"total_committers":3,"mean_commits":8.333333333333334,"dds":0.28,"last_synced_commit":"9fcdfc657d247b140bfe4fc7cf3c95fae38c3d7a"},"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickstaa%2Faction-update-semver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickstaa%2Faction-update-semver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickstaa%2Faction-update-semver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickstaa%2Faction-update-semver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rickstaa","download_url":"https://codeload.github.com/rickstaa/action-update-semver/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219859409,"owners_count":16556036,"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":["continious-integration","docker","gh-action","github-action-docker","github-actions","semver","versioning"],"created_at":"2024-10-11T18:49:31.058Z","updated_at":"2025-10-28T14:31:16.926Z","avatar_url":"https://github.com/rickstaa.png","language":"Shell","funding_links":["https://github.com/sponsors/rickstaa"],"categories":[],"sub_categories":[],"readme":"# GitHub Action: Update major/minor semver\n\n[![Docker Image CI](https://github.com/rickstaa/action-update-semver/workflows/Docker%20Image%20CI/badge.svg)](https://github.com/rickstaa/action-update-semver/actions)\n[![Code quality CI](https://github.com/rickstaa/action-update-semver/workflows/Code%20quality%20CI/badge.svg)](https://github.com/rickstaa/action-update-semver/actions?query=workflow%3A%22Code+quality+CI%22)\n[![Release](https://github.com/rickstaa/action-update-semver/workflows/release/badge.svg)](https://github.com/rickstaa/action-update-semver/actions?query=workflow%3Arelease)\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/rickstaa/action-update-semver?logo=github\u0026sort=semver)](https://github.com/rickstaa/action-update-semver/releases)\n\nThis GitHub Action simplifies the process of updating major/minor release tags on a tag push. For example, it automatically updates both `v1` and `v1.2` tags when releasing version `v1.2.3`. Additionally, it provides the option to move the patch version up to the latest commit, making it convenient for use with tools like [auto-changelog](https://www.npmjs.com/package/auto-changelog) to automatically generate changelogs for your releases.\n\nIt's designed to seamlessly integrate with GitHub Actions. For more details on versioning your action, refer to [GitHub Actions documentation](https://help.github.com/en/articles/about-actions#versioning-your-action).\n\n## Inputs\n\n### `tag`\n\n**Optional**. Specifies the existing tag to update from. Defaults to `$GITHUB_REF`.\n\n### `message`\n\n**Optional**. Custom tag message. Default: `Release $TAG`.\n\n### `major_version_tag_only`\n\n**Optional**. Creates only major version tags. Default: `false`.\n\n### `move_patch_tag`\n\n**Optional**. Moves the existing tag to the latest commit inside the GitHub Action. Default: `false`. Note that this only works when you explicitly specify a tag to prevent unexpected changes.\n\n### `github_token`\n\n**Optional**. Only required for checkout@v1 action; otherwise, it's not necessary if you use checkout@v2 or higher.\n\n### `gpg_private_key`\n\n**Optional**. Specifies the GPG private key to sign the tag with. Default: `\"\"`.\n\n### `gpg_passphrase`\n\n**Optional**. Specifies the GPG passphrase to sign the tag with. Default: `\"\"`.\n\n## Example Usage\n\n### General example\n\n```yaml\nname: Update Semver\non:\n  push:\n    branches-ignore:\n      - \"**\"\n    tags:\n      - \"v*.*.*\"\njobs:\n  update-semver:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: rickstaa/action-update-semver@v1\n        with:\n          major_version_tag_only: true # (optional, default is \"false\")\n```\n\nCertainly! Here's a refined version of your documentation:\n\n### Signing Tags with GPG\n\nTo sign tags with GPG, follow these steps:\n\n#### 1. Generate a GPG Key\n\nFirst, [generate a GPG key](https://docs.github.com/en/github/authenticating-to-github/generating-a-new-gpg-key). Once generated, export the GPG private key in ASCII armored format to your clipboard using one of the following commands based on your operating system:\n\n- **macOS:**\n\n  ```shell\n  gpg --armor --export-secret-key joe@foo.bar | pbcopy\n  ```\n\n- **Ubuntu (GNU base64):**\n\n  ```shell\n  gpg --armor --export-secret-key joe@foo.bar -w0 | xclip -selection clipboard\n  ```\n\n- **Arch:**\n\n  ```shell\n  gpg --armor --export-secret-key joe@foo.bar | xclip -selection clipboard -i\n  ```\n\n- **FreeBSD (BSD base64):**\n\n  ```shell\n  gpg --armor --export-s[.github/workflows/update_semver.yml](.github/workflows/update_semver.yml)e your GPG passphrase.\n  ```\n\n#### 3. Update Workflow YAML\n\nModify your workflow YAML file to include the GPG private key and passphrase in the `gpg_private_key` and `gpg_passphrase` inputs:\n\n```yaml\nname: Update Semver\non:\n  push:\n    branches-ignore:\n      - \"**\"\n    tags:\n      - \"v*.*.*\"\njobs:\n  update-semver:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: rickstaa/action-update-semver@v1\n        with:\n          gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}\n          gpg_passphrase: ${{ secrets.PASSPHRASE }}\n          major_version_tag_only: true # (optional, default is \"false\")\n```\n\nThis workflow will now sign tags using the specified GPG key during tag creation.\n\n## Contributing\n\nFeel free to open an issue if you have ideas on how to improve this GitHub Action or if you want to report a bug! All contributions are welcome. :rocket: Please consult the [contribution guidelines](CONTRIBUTING.md) for more information.\n\n## Acknowledgment\n\nThis action is based on [@haya14busa's](https://github.com/haya14busa/) [update-major-minor-semver](https://github.com/marketplace/actions/update-major-minor-semver).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frickstaa%2Faction-update-semver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frickstaa%2Faction-update-semver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frickstaa%2Faction-update-semver/lists"}