{
    "componentChunkName": "component---src-templates-plugin-docs-tsx",
    "path": "/plugins/scm-jenkins-plugin/docs/3.1.x/en/configuration/",
    "result": {"data":{"plugin":{"name":"scm-jenkins-plugin","displayName":"Jenkins","description":"Pings your Jenkins CI server when a new commit is pushed to SCM-Manager","author":"Cloudogu GmbH","documentation":[{"version":"3.1.x","languages":["de","en"]},{"version":"3.0.x","languages":["de","en"]},{"version":"2.4.x","languages":["de","en"]},{"version":"2.3.x","languages":["de","en"]},{"version":"2.2.x","languages":["de","en"]},{"version":"2.1.x","languages":["de","en"]}]},"navigation":{"nodes":[{"section":"First steps","entries":[{"frontmatter":{"title":"Configuration","subtitle":null,"partiallyActive":null},"fields":{"slug":"/plugins/scm-jenkins-plugin/docs/3.1.x/en/configuration/"}},{"frontmatter":{"title":"Interaction with other Plugins","subtitle":null,"partiallyActive":null},"fields":{"slug":"/plugins/scm-jenkins-plugin/docs/3.1.x/en/ci-status/"}},{"frontmatter":{"title":"Permissions","subtitle":null,"partiallyActive":null},"fields":{"slug":"/plugins/scm-jenkins-plugin/docs/3.1.x/en/permissions/"}}]}]},"versions":{"group":[{"fieldValue":"2.1.x"},{"fieldValue":"2.2.x"},{"fieldValue":"2.3.x"},{"fieldValue":"2.4.x"},{"fieldValue":"3.0.x"},{"fieldValue":"3.1.x"}]},"languages":{"group":[{"fieldValue":"de"},{"fieldValue":"en"}]},"markdownRemark":{"html":"<p>There are two quite different configurations for the SCM-Jenkins-plugin.</p>\n<h3 id=\"global-configuration\" style=\"position:relative;\"><a href=\"#global-configuration\" aria-label=\"global configuration permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Global configuration</h3>\n<p>In the global configuration you can set the Jenkins instance url and configure the VCS triggers.</p>\n<p>The git trigger requires version 1.1.14 or above of the jenkins git plugin.\nThe mercurial trigger requires version 1.38 or above of the jenkins mercurial plugin.</p>\n<p>The event trigger requires the installation of the <a href=\"https://plugins.jenkins.io/scm-manager/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">jenkins SCM-Manager plugin</a> in jenkins.\nThis informs Jenkins about changes to branches, tags or pull requests.</p>\n<p>Depending on your Jenkins configuration, you may have to set a username and a valid API token for this user, too.\nThis is only required for SVN commit trigger requests if CSRF protection is activated on the Jenkins CI server.</p>\n<p>Additionally, for git a \"notifyCommit access tokens\" is needed.\nThis can be created in the global security configuration in Jenkins.</p>\n<p>Finally, it is possible to disable the repository specific configuration or to disable event triggers for specific\nrepository types.</p>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 590px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 91.21621621621621%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAASCAYAAABb0P4QAAAACXBIWXMAAAsTAAALEwEAmpwYAAACKklEQVQ4y52STW4UMRCF52yIAAdgzZ1YIRIlGzasQWLHDQIkIUGwISJRYCaZmW63/9uueqjsnt9khISlT2XX9Lx6VfaIiNA2M+iu3YiC0QrgDOZ0DyDjbN7j3ZXH+yvHH64dIrEdieDNWGHW9ribB7SaSpxMHZRmPLQW2Y/XBi9Pp3j1TfH+Dw2f2Y5AAXnyBvnPAWhyhDw+LJFvj0DjQ/Q3+4g3+yVWDpB+vwbmb5HdDNl0azWKoEG4eA59/Ajm8xPoT3uF7vhxwZ0+Rfj6DP5sRTzfAy5fwOoxlHZw3nMiAjOk5QQ1PYe6O0F7ewJ1d4pm8gWh+w7ESyD+HOIKDpL7BRMjGheRiZiZwcx2xAx0jqBMgrIZrUmwAZCxF3gHAPqU4L0vvS4F5RRjgHMG3lkE7wqyL3gLpgwwbQJCSgmdsSAiHlTtSHYhBFhrSzXnHHLOZcpD1crWGYND4+Omw0RAY8Lgxi9Z/GmXqCxx2DYNjDErhw8JOu+ljfvvb9th30NrjRgjD7k6w+C9VCntSusSqTwDLu2TjIB57VnXvXzja/GVQ0nOWwWlDVrVlX2jusKsaUuUnAw/y+0SL1nU4LqqQxFXnYa2FjFTqS31lmCAgSyO1ygiNa7dMnOpbn1An6l+TDtYFyRev7hNQRnuQ4PfBW1dzoag/DhrGrSqzlHaru3yThb3UnXKedNhTBkxpRIT8T/b1pkwT7mKbzvEf6xpyriOqYhvC/4FNfdxb9QCpEMAAAAASUVORK5CYII='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"Jenkins Global Configuration\"\n        title=\"Jenkins Global Configuration\"\n        src=\"/static/b623c04e830a34661f6f0cdcb0a724c1/fcda8/global-config.png\"\n        srcset=\"/static/b623c04e830a34661f6f0cdcb0a724c1/12f09/global-config.png 148w,\n/static/b623c04e830a34661f6f0cdcb0a724c1/e4a3f/global-config.png 295w,\n/static/b623c04e830a34661f6f0cdcb0a724c1/fcda8/global-config.png 590w,\n/static/b623c04e830a34661f6f0cdcb0a724c1/efc66/global-config.png 885w,\n/static/b623c04e830a34661f6f0cdcb0a724c1/2bef9/global-config.png 1024w\"\n        sizes=\"(max-width: 590px) 100vw, 590px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n        decoding=\"async\"\n      />\n    </span></p>\n<h4 id=\"repository-configuration\" style=\"position:relative;\"><a href=\"#repository-configuration\" aria-label=\"repository configuration permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Repository Configuration</h4>\n<p>With the repository configuration, build jobs for single repositories can be controlled.\nJust the Jenkins instance url and some kind of credentials are required.\nFor authentication, you may have to use an authentication token (for example for git the \"notifyCommit access token\")\nand/or a username with an api token.</p>\n<p>You can filter the build job triggers by branches, so only build jobs of selected branches will be triggered on a repository push.</p>\n<p>If the Jenkins build job is parametrized you may also send parameters with each request.\nThe parameters consist of name and value pairs. The name must match the parameter name in the Jenkins build job exactly (case sensitiv).\nThe values may be absolute or relative values. Absolute values are for example <code class=\"language-text\">Trillian</code> as string parameter or <code class=\"language-text\">true</code> as boolean parameter.\nThe relative values can be used through an expression language from the repository push context (repository, commits).\nIt could be used like <code class=\"language-text\">${repository.id}</code> for the repository id or <code class=\"language-text\">${commit.author.mail}</code> to get the mail address from the committer.</p>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 590px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 120.27027027027026%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAYCAYAAAD6S912AAAACXBIWXMAAAsTAAALEwEAmpwYAAAClklEQVQ4y41Vy24TMRTtTwNCovAJsAUhNXxCNyxQ9zxEK5CQKBQWNEpECcn4bY8f9yB7PJOZNG2xdHRtxT5z77mPHBARtDaQUkIpVWyGMQb5NyJUu0Veva2rP+iDlBKWyyXm8zkWiwWurq6wXq8LeX2J3dWTfd54HF9aHP8y9Hpu0CbqCLkQYIyhaZrinRACPoTh8S5SJTy5FHj6aYVnXzg9P5ewsRAS1ozj72aD1XqDdcMgtYGPCSHRjYiZM7SAEaMwesKmAc8aGoMQUxEkEiGmivG+IgGQSpePJ4DyR4gyIRE2OVzGwYWEsQ6JKiHtIaYtYU6cFAIpJapy6IOSZetgWw/nA3yMNdw0hJ2Kx7gWsvUBXBl476nqXQm1LonI6JOSwTmHlALOufxop0IAGyKU85WrDzklMCGLFjITF1100UcoVc5ZX21sJ8EQPhBCAOMi262HWUOWPcqup+77qfoxRgl7nCAi+BDBpEbbtlPChovi4W1lEkYZHs4xQiuVJaNa7J2GmUwZeydhj+LtqGOoW5Vw0lIoXXAXlNYw1m47qWZqyLK1rtSfdW70cKTfhBCFrG39uDWnIUerkYysgfQrAU4B0WHvin47ceqmeJg3R+cc99+t8Pi0weEZK3j0scGDt3/w8P0Kh6dswJMzhnsfNnj5lU08nBCeLB2OLjRmFwpH3xVmef9D49VPU9CfZ/XOi28SbxZ2P2EubC85SPMyOYrNYZIHku9sD4S9cxHjpAzjiwnoNpR+zj1q2g7WT+ETDRiXzbSXrSvIl7pJg8Few6i49xLmUujnWhunnXAbbvYQQFYnd6PLF/eM/H1/Ur1yVOXbZrkWbKz2TjIiiBixCnH4b7nm4f+u/m4TI377UJzYJfwHCctPpXScmi4AAAAASUVORK5CYII='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"Jenkins Repository Configuration\"\n        title=\"Jenkins Repository Configuration\"\n        src=\"/static/72b0dd5f6a149b81d9832f19e39b39aa/fcda8/repo-config.png\"\n        srcset=\"/static/72b0dd5f6a149b81d9832f19e39b39aa/12f09/repo-config.png 148w,\n/static/72b0dd5f6a149b81d9832f19e39b39aa/e4a3f/repo-config.png 295w,\n/static/72b0dd5f6a149b81d9832f19e39b39aa/fcda8/repo-config.png 590w,\n/static/72b0dd5f6a149b81d9832f19e39b39aa/efc66/repo-config.png 885w,\n/static/72b0dd5f6a149b81d9832f19e39b39aa/2bef9/repo-config.png 1024w\"\n        sizes=\"(max-width: 590px) 100vw, 590px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n        decoding=\"async\"\n      />\n    </span></p>","description":"There are two quite different configurations for the SCM-Jenkins-plugin. Global configuration In the global configuration you can set the Jenkins instance url…","tableOfContents":"<ul>\n<li>\n<p><a href=\"#global-configuration\">Global configuration</a></p>\n<ul>\n<li><a href=\"#repository-configuration\">Repository Configuration</a></li>\n</ul>\n</li>\n</ul>","frontmatter":{"title":"Configuration","subtitle":null,"description":null,"keywords":null,"displayToc":null,"image":null}}},"pageContext":{"name":"scm-jenkins-plugin","slug":"/plugins/scm-jenkins-plugin/docs/3.1.x/en/configuration/","version":"3.1.x","latestVersion":"3.1.x","latestPageVersion":"3.1.x","language":"en","canonicalPath":"/plugins/scm-jenkins-plugin/docs/latest/en/configuration/","latestRootPath":"/plugins/scm-jenkins-plugin/docs/3.1.x/en/"}},
    "staticQueryHashes": ["1973669194","2742214048","2956773653","2957019495","698804963"]}