{"id":15045874,"url":"https://github.com/jenkinsci/release-plugin","last_synced_at":"2025-04-14T00:55:02.287Z","repository":{"id":544669,"uuid":"1163719","full_name":"jenkinsci/release-plugin","owner":"jenkinsci","description":"Jenkins release plugin","archived":false,"fork":false,"pushed_at":"2024-08-09T09:14:48.000Z","size":16345,"stargazers_count":24,"open_issues_count":6,"forks_count":51,"subscribers_count":99,"default_branch":"master","last_synced_at":"2025-03-27T14:55:33.005Z","etag":null,"topics":["adopt-this-plugin"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/release/","language":"Java","has_issues":false,"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/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG-old.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-12-13T05:50:47.000Z","updated_at":"2023-10-17T18:56:28.000Z","dependencies_parsed_at":"2024-09-25T01:59:05.563Z","dependency_job_id":"a6eea193-e42c-49f5-89ea-628138234b6a","html_url":"https://github.com/jenkinsci/release-plugin","commit_stats":null,"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Frelease-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Frelease-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Frelease-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Frelease-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/release-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248804783,"owners_count":21164131,"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":["adopt-this-plugin"],"created_at":"2024-09-24T20:52:23.965Z","updated_at":"2025-04-14T00:55:02.264Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Release \n\nThis plugin adds the ability to wrap your job with pre- and post- build\nsteps which are only executed when a manual release build is triggered.\n\nAdditional plugin integration\n\nSupports the [Dashboard\nView](https://plugins.jenkins.io/dashboard-view/) with the\nRecent Releases portlet and the [Promoted Builds\nPlugin](https://plugins.jenkins.io/promoted-builds/)\nwith the Release build condition.\n\n# Configure the job to enable releasing\n\nOn the job configuration page, enable the release build configuration\nunder the Build Wrapper heading and add your required release version\ntemplate string, release\n[parameters](https://plugins.jenkins.io/parameterized-trigger/),\npre and post build steps that you need to complete a release.\n\n### Release Version Template\n\nThe release version template was added in version 1.7 of the release\nplugin.  This parameter lets you define how the release plugin\nidentifies the release of the project.  This is done by building a\nparameter based template which is resolved at release time to a fully\nresolved string.  For instance, the template can be: Release:\n${releaseVersion}.  This will instruct the release plugin to use the\nvalue of the parameter name releaseVersion to come up with the fully\nidentifying string which will then be used as a description of the\nrelease build and as a tooltip on the release build icon on the\nhistorical build list.\n\n### Release Parameters\n\nThe release parameters let you define various parameters that are\npresented to the user when a release is requested.  The list of\navailable parameter types are the same as those available in the\nparameterized build option for Jenkins.\n\n### Build Steps\n\nThe build steps section is used to define arbitrary actions to run\nbefore and after the standard job build steps run. These are the same\nbuild steps offered as the build steps available in the free style job\ntype.\n\n![](docs/images/config.png)\n\nIn my experience, a release build typically requires pre-build steps of\nvalidating the project is releasable and bumping the version to the\nrelease version. After the build runs as usual, the post build steps are\nlabeling the codebase and bumping the version to the next development\nversion.\n\n# Executing a release\n\nTo run a release, click the Release icon from the job home page. This\nwill bring you to the release details page where you will be prompted to\nfill in any parameters that you have defined (or the default\nRELEASE\\_VERSION and DEVELOPMENT\\_VERSION if there were no parameters\ndefined).  As seen above, these values are then available at job\nexecution time in both the pre and post release steps as well as the\nnormal build steps. Finally, click the schedule release build and the\njob is scheduled to run immediately, now including the execution of the\npre and post build steps.\n\n![](docs/images/build.png)\n\n# Viewing results\n\nOnce the build is complete, the release plugin automatically locks the\nbuild, preventing it from being automatically deleted and adds a release\nicon denoting it as a release build.\n\n![](docs/images/results.png)\n\n# Supported Job Types\n\n The release plugin supports the Maven2 and Free Style Job type\n\n# Recent Releases Portlet\n\nThe release plugin contributes a recent releases portlet that can be\nused in a [Dashboard\nView](https://plugins.jenkins.io/dashboard-view/). \n\nThis portlet shows the 5 most recent release builds in normal mode with\na link that brings you to the build page and the version string.\n![](docs/images/normal-mode.PNG)  \nIn the maximized mode, it shows the 50 most recent builds with\nadditional detail.  Additionally, it offers an rss feed while in the\nmaximized mode so that you can get notified of all release builds or all\nfailing release builds.\n![](docs/images/maximized-mode.PNG)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Frelease-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Frelease-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Frelease-plugin/lists"}