{"id":15045292,"url":"https://github.com/jenkinsci/parameterized-trigger-plugin","last_synced_at":"2026-02-25T07:57:40.582Z","repository":{"id":1231299,"uuid":"1163688","full_name":"jenkinsci/parameterized-trigger-plugin","owner":"jenkinsci","description":"Jenkins parameterized-trigger plugin","archived":false,"fork":false,"pushed_at":"2026-01-01T20:16:51.000Z","size":1280,"stargazers_count":77,"open_issues_count":171,"forks_count":176,"subscribers_count":99,"default_branch":"master","last_synced_at":"2026-02-05T10:27:03.542Z","etag":null,"topics":["jenkins","jenkins-builder","jenkins-plugin","jenkins-trigger"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/parameterized-trigger","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"spawngrid/cowboy_session","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"community_bridge":"jenkins","custom":["https://www.jenkins.io/donate/#why-donate"]}},"created_at":"2010-12-13T05:48:13.000Z","updated_at":"2026-01-01T20:16:48.000Z","dependencies_parsed_at":"2023-07-05T17:15:44.492Z","dependency_job_id":"9b264700-43dc-4495-bfe4-37cf379fd72a","html_url":"https://github.com/jenkinsci/parameterized-trigger-plugin","commit_stats":{"total_commits":694,"total_committers":81,"mean_commits":8.567901234567902,"dds":0.8170028818443804,"last_synced_commit":"ff0efe579ff1ddc60adff01af24f6df2587944d0"},"previous_names":[],"tags_count":67,"template":false,"template_full_name":null,"purl":"pkg:github/jenkinsci/parameterized-trigger-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fparameterized-trigger-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fparameterized-trigger-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fparameterized-trigger-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fparameterized-trigger-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/parameterized-trigger-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fparameterized-trigger-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29815020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T05:36:42.804Z","status":"ssl_error","status_checked_at":"2026-02-25T05:36:31.934Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["jenkins","jenkins-builder","jenkins-plugin","jenkins-trigger"],"created_at":"2024-09-24T20:51:41.755Z","updated_at":"2026-02-25T07:57:40.551Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","funding_links":["https://funding.communitybridge.org/projects/jenkins","https://www.jenkins.io/donate/#why-donate"],"categories":[],"sub_categories":[],"readme":"# Parameterized Trigger Plugin\n\n[![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/parameterized-trigger.svg)](https://plugins.jenkins.io/parameterized-trigger)\n[![GitHub release](https://img.shields.io/github/release/jenkinsci/parameterized-trigger-plugin.svg?label=changelog)](https://github.com/jenkinsci/parameterized-trigger-plugin/releases/latest)\n[![Jenkins Plugin Installs](https://img.shields.io/jenkins/plugin/i/parameterized-trigger.svg?color=blue)](https://plugins.jenkins.io/parameterized-trigger)\n\nThis plugin lets you trigger new builds when your build has completed,\nwith various ways of specifying parameters for the new build.\n\nThese new builds appear as \"Subprojects\" in the Jenkins UI when you\nare looking at a project that triggers them.\n\nYou can add multiple configurations: each has a list of projects to trigger, a condition for when to trigger them\n(based on the result of the current build), and a parameters section.\n\nThere is also a Parameterized Remote Trigger Plugin in case you want to trigger a build on a different/remote Jenkins Controller.\n\nThe parameters section can contain a combination of one or more of the following:\n\n-   a set of predefined properties\n-   properties from a properties file read from the workspace of the triggering build\n-   the parameters of the current build\n-   **Subversion revision**: makes sure the triggered projects are built with the same revision(s) of the triggering build.\n    You still have to make sure those projects are actually configured to checkout the right Subversion URLs.\n-   **Restrict matrix execution to a subset**: allows you to specify the same combination filter expression as you use in the matrix project configuration and further restricts the subset of the downstream matrix builds to be run.\n\nThe parameter section is itself pluggable, and other plugins can contribute other sources of parameters.\n\nThis triggering mechanism can be used both as a post-build step or as a build step, in which case you can also block for the completion of the triggered builds.\nThis lets you create a \"function call\" like semantics.\n\n| WARNING: You must define the parameter in downstream jobs via the _This project is parameterized_ property. For example, if _job1_ passes `ABC=123` to _job2_ then in _job2_ mark the job as _This project is parameterized_ and add a parameter named `ABC`. See [this advisory](https://jenkins.io/blog/2016/05/11/security-update/) for more information |\n| --- |\n\n #### Usage as a Build step\n\nWhen using the _Trigger/Call builds on another project_ item.\nIf the trigger is configured with the \"Block until the triggered projects finish their builds\" enabled, the following Environment variables are made available for further build steps.\n\nEnv variables for future build steps:\n\n-   `LAST_TRIGGERED_JOB_NAME` - Last project started\n-   `TRIGGERED_BUILD_NUMBER_\u003cproject name\u003e` - Last build numbertriggered\" (since 2.17)\n-   `TRIGGERED_JOB_NAMES` - Comma separated list of all triggered projects\n-   `TRIGGERED_BUILD_NUMBERS_\u003cproject name\u003e` - Comma separated list of build numbers triggered\n-   `TRIGGERED_BUILD_RESULT_\u003cproject name\u003e` - Last triggered build result of project\n-   `TRIGGERED_BUILD_RESULT_\u003cproject name\u003e*RUN*\u003cbuild number\u003e` - Result of triggered build for build number\n-   `TRIGGERED_BUILD_RUN_COUNT_\u003cproject name\u003e` - Number of builds triggered for the project\n\nFrom 2.17 onwards: All Project names have characters not a-zA-Z or 0-9 replaced by\n`_(multiple characters are condensed into a single)`.\n\nNote that with the BuildStep a variable can be used for the project name, I.E. `${projectName}`.\n\n## Use of the plugin in a Matrix job\n\n### Post build task\n\nWhen using the trigger parameterized build as a post build task for a matrix job the triggering will be be done once when all of the different matrix configurations have completed.\nIn this case some of the Environment variables may not be resolvable as passing them to downstream jobs will fail.\nYou also cannot use a variable for the downstream project name.\nIf this functionality is needed, the BuildStep must be used.\n\nEnvironment variables that should be available are the the default shell ones (`\u003cyourserver:port\u003e/env-vars.html`) and ones defined as Parameters.\nVariables added by the other plugins as a buildwrappers may not be available.\n\n### Build step\n\nWhen using the trigger parameterized build as a build step it will be called for every different configuration,\nso if triggering another project with no parameters it will be done the same number of times as you have configurations,\npossible causing the triggered job to run more than once.\n\nHowever this also allows you to trigger other jobs with parameters relating to the current configuration,\ni.e. triggering a build on the same node with the same JDK.\n\n## Plugins contributing additional parameter types to this plugin\n\n* Git Plugin\n* NodeLabel Parameter Plugin\n\n## Backward compatibility with version 2.22\n\n-   Since Parameterized Trigger 2.23, there are cases that Parameterized Trigger fails to trigger downstream builds that can be successfully triggered with Parameterized Trigger \\\u003c= 2.22.\n    -   This is caused by the new behavior introduced in Parameterized Trigger 2.23.\n        It gets to pass parameter values not directly to the downstream build, but to parameter definitions of downstream projects.\n        This enables parameter definitions to perform its specific process, for example, selecting nodes with NodeLabel Parameter Plugin.\n-   Example: There is a project with a choice parameter with choices A, B, C.\n    When you triggered that project with parameter value D, it fails with following output in the upstream:\n\n```\n    java.lang.IllegalArgumentException: Illegal choice: D at\n    hudson.model.ChoiceParameterDefinition.checkValue(ChoiceParameterDefinition.java:72)\n```\n\n-   This is the intended behavior.\n    -   As those failures are ones designed by parameter definitions.\n        For example, the choice parameter is designed to not accept unexpected values.\n    -   The same behavior is visible builds are triggered those with the Jenkins CLI or the remote access API.\n-   It is recommended to fix your project configuration to have parameter definitions not fail.\n    -   For example, use EnvInject Plugin to process values or use Extensible Choice Parameter Plugin which provides a choice parameter accepting edited values.\n\n### Workaround\n\nSet the `hudson.plugins.parameterizedtrigger.ProjectSpecificParametersActionFactory.compatibility_mode` Java system property to `true` to restore the old behavior.\nRefer to the [\"Jenkins features controlled by system properties\"](https://www.jenkins.io/doc/book/managing/system-properties/) for detailed instructions on Java system properties in Jenkins.\n\n## Report an issue\n\nPlease report issues and enhancements through the [Jenkins issue tracker](https://www.jenkins.io/participate/report-issue/redirect/#15592).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fparameterized-trigger-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Fparameterized-trigger-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fparameterized-trigger-plugin/lists"}