{"id":15288351,"url":"https://github.com/jreleaser/release-action","last_synced_at":"2026-03-16T20:01:25.003Z","repository":{"id":45565097,"uuid":"352099563","full_name":"jreleaser/release-action","owner":"jreleaser","description":":octocat: GitHub Action for JReleaser","archived":false,"fork":false,"pushed_at":"2024-12-21T17:32:53.000Z","size":71,"stargazers_count":38,"open_issues_count":2,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-10T04:25:51.797Z","etag":null,"topics":["actions","github-actions","gradle","java","jreleaser","maven"],"latest_commit_sha":null,"homepage":"https://jreleaser.org","language":"Java","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/jreleaser.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"patreon":"aalmiray","github":"aalmiray"}},"created_at":"2021-03-27T14:54:45.000Z","updated_at":"2025-03-29T03:46:54.000Z","dependencies_parsed_at":"2023-01-11T17:22:49.129Z","dependency_job_id":"776ebf18-acbe-4441-899d-43847d47a255","html_url":"https://github.com/jreleaser/release-action","commit_stats":{"total_commits":41,"total_committers":3,"mean_commits":"13.666666666666666","dds":0.1707317073170732,"last_synced_commit":"f69e545b05f149483cecb2fb81866247992694b8"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreleaser%2Frelease-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreleaser%2Frelease-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreleaser%2Frelease-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreleaser%2Frelease-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jreleaser","download_url":"https://codeload.github.com/jreleaser/release-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248674658,"owners_count":21143760,"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":["actions","github-actions","gradle","java","jreleaser","maven"],"created_at":"2024-09-30T15:47:51.267Z","updated_at":"2026-03-16T20:01:24.985Z","avatar_url":"https://github.com/jreleaser.png","language":"Java","funding_links":["https://patreon.com/aalmiray","https://github.com/sponsors/aalmiray"],"categories":[],"sub_categories":[],"readme":"= JReleaser\n:linkattrs:\n:project-owner: jreleaser\n:project-name:  release-action\n\nimage:https://github.com/{project-owner}/{project-name}/workflows/Test/badge.svg[\"Build Status\", link=\"https://github.com/{project-owner}/{project-name}/actions\"]\nimage:https://img.shields.io/github/v/release/{project-owner}/{project-name}[\"GitHub release\", link=\"https://github.com/jreleaser/release-action/releases\"]\nimage:https://img.shields.io/twitter/follow/{project-owner}?style=social[\"Twitter Follow\", link=\"https://twitter.com/jreleaser\"]\n\nThis action executes a link:https://jreleaser.org[JReleaser] workflow.\n\n== Usage\n\n=== Workflow\n\n[source,yaml]\n----\nname: Release\n\non:\n  workflow_dispatch:\n\njobs:\n  release:\n    name: Release\n    runs-on: ubuntu-latest\n\n    steps:\n      - name: Checkout\n        uses: actions/checkout@v6\n        with:\n          fetch-depth: 0\n\n      # Configure build steps as you'd normally do\n\n      - name: Setup Java\n        uses: actions/setup-java@v5\n        with:\n          java-version: 21\n          distribution: 'zulu'\n          cache: maven\n\n      # Build the artifacts\n\n      - name: Build\n        run: ./mvnw -B -ntp verify\n\n      # Create a release\n\n      - name: Run JReleaser\n        uses: jreleaser/release-action@v2\n        env:\n          JRELEASER_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n      # Persist logs\n\n      - name: JReleaser release output\n        if: always()\n        uses: actions/upload-artifact@v4\n        with:\n          name: jreleaser-release\n          path: |\n            out/jreleaser/trace.log\n            out/jreleaser/output.properties\n----\n\nWARNING: Note the `fetch-depth: 0` option on the `Checkout` workflow step. It is required for JReleaser to work properly.\nWithout that, JReleaser might fail or behave incorrectly.\n\nThe last step executes a `full-release` with the default `jreleaser.yml` configuration that's expected to be located at\nthe root of the repository.\n\nIMPORTANT: This action requires Java 11+ to download and execute JReleaser. The action will setup a suitable Java runtime\nautomatically. If you would like to use a different Java version/distribution then set the value of `setup-java` to `false`\nand make sure you have a previous step with `actions/setup-java` setup as needed.\n\n== Customizing\n\n== Inputs\n\nFollowing inputs can be used as `step.with` keys\n\n[%header,cols=\"\u003c2,\u003c,\u003c2,\u003c3\",width=\"100%\"]\n|===\n| Name              | Type    | Default                 | Description\n| version           | String  | latest                  | The JReleaser version to use. +\nShould match any of the link:https://github.com/jreleaser/jreleaser/releases[published releases]. +\nYou may use `latest` to pull the latest stable release or +\n`early-access` to pull the latest snapshot.\n| arguments         | String  | full-release            | The JReleaser command to run.\n| working-directory | String  | ${{ github.workspace }} | The directory to change into. +\nDefaults to the directory the calling workflow runs in.\n| setup-java        | boolean | true                    | Automatically setup a Java runtime. +\nJava runtime defaults to Zulu 17.\n| java-opts         | boolean |                         | Additional JVM parameters for running JReleaser\n|===\n\n== Environment Variables\n\nFollowing environment variables can be used as `step.env` keys\n\n[%header,width=\"100%\"]\n|===\n| Name                   | Description\n| JRELEASER_GITHUB_TOKEN | link:https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token[GITHUB_TOKEN]\nas provided by `secrets`\n|===\n\n== Caution\n\nThe default `GITHUB_TOKEN` from `secrets` is link:https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token#about-the-github_token-secret[limited]\nto the repository that contains your workflow.\n\nPushing to other repositories such as Homebrew tap requires additional permissions, you must create a custom\nlink:https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/[Personal Access Token] with\n`repo` permissions and link:https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets[add it as a secret in the repository].\nIf you create a secret named `GH_PAT`, the step will look like this\n\n[source,yaml]\n----\n      - name: Run JReleaser\n        uses: jreleaser/release-action@v2\n        env:\n          JRELEASER_GITHUB_TOKEN: ${{ secrets.GH_PAT }}\n----\n\nIf you'd rather have separate tokens for each additional repository and keep the original `GITHUB_TOKEN` intact then\nyou may apply the `GH_PAT` token as follows\n\n[source,yaml]\n----\n      - name: Run JReleaser\n        uses: jreleaser/release-action@v2\n        env:\n          JRELEASER_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n          JRELEASER_HOMEBREW_GITHUB_TOKEN: ${{ secrets.GH_PAT }}\n----\n\nAdditional environment variables may be needed depending on your specific setup, such as those needed for signing files\nwith GPG or announcing a release via Twitter. Review the docs at link:https://jreleaser.org[] to find more about these\nvariables and how to set them up.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjreleaser%2Frelease-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjreleaser%2Frelease-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjreleaser%2Frelease-action/lists"}