{ "componentChunkName": "component---src-templates-plugin-docs-tsx", "path": "/plugins/scm-jenkins-plugin/docs/latest/en/testing/", "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.2.x","languages":["en","de"]},{"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.2.x/en/configuration/"}},{"frontmatter":{"title":"Interaction with other Plugins","subtitle":null,"partiallyActive":null},"fields":{"slug":"/plugins/scm-jenkins-plugin/docs/3.2.x/en/ci-status/"}},{"frontmatter":{"title":"Permissions","subtitle":null,"partiallyActive":null},"fields":{"slug":"/plugins/scm-jenkins-plugin/docs/3.2.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"},{"fieldValue":"3.2.x"}]},"languages":{"group":[{"fieldValue":"de"},{"fieldValue":"en"}]},"markdownRemark":{"html":"

In order to get a running Jenkins instance, you can use Docker and the prepared Jenkins environment:

\n
mvn generate-resources\ndocker-compose up
\n

Log into Jenkins using credentials “scmadmin/scmadmin”.\nThen, click the user on the top right and choose “Configure” in the left menu.\nThere, you can create a new API Token clicking “Add new token”.\nDo so and copy the generated hash.\nThis will be referenced in the following as “API token”.

\n

This Jenkins instance has a job configured to pull from http://172.18.0.1:8081/scm/repo/scmadmin/git.\nYou can create this repository in a running instance of SCM-Manager using curl:

\n
curl -u scmadmin:scmadmin --data '{\n  \"contact\": \"zaphod.beeblebrox@hitchhiker.com\",\n  \"name\": \"git\",\n  \"archived\": false,\n  \"defaultBranch\": \"branch\",\n  \"type\": \"git\"\n}' --header \"Content-Type: application/vnd.scmm-repository+json\" http://localhost:8081/scm/api/v2/repositories/
\n

Repository-specific configuration

\n

Set the Jenkins for this repository using curl as follows (please insert your API token you generated above):

\n
curl -u scmadmin:scmadmin --data '{\n    \"apiToken\":\"<API Token>\",\n    \"branches\":[\"main\"],\n    \"project\":\"scm\",\n    \"token\":\"SOME_TOKEN\",\n    \"url\":\"http://localhost:8082/\",\n    \"username\":\"scmadmin\",\n    \"csrf\":false\n    }' --header \"Content-Type: application/json\" -X PUT http://localhost:8081/scm/api/v2/config/jenkins/scmadmin/git
\n

You can now clone the repository:

\n
git clone http://scmadmin@localhost:8081/scm/repo/scmadmin/git
\n

Whenever you change something on the main branch, a build should be triggered in Jenkins.

\n

Global configuration

\n

Disable the repository-specific configuration and create a global one:

\n
curl -u scmadmin:scmadmin --data '{\n    \"disableRepositoryConfiguration\":true,\n    \"disableMercurialTrigger\":false,\n    \"disableGitTrigger\":false,\n    \"url\":\"http://localhost:8082/\"\n    }' --header \"Content-Type: application/json\" -X PUT http://localhost:8081/scm/api/v2/config/jenkins
\n

Whenever you change something on the main branch, a build should be triggered in Jenkins.

","description":"In order to get a running Jenkins instance, you can use Docker and the prepared Jenkins environment: Log into Jenkins using credentials “scmadmin/scmadmin…","tableOfContents":"","frontmatter":{"title":"Testing with Jenkins","subtitle":null,"description":null,"keywords":null,"displayToc":null,"image":null}}},"pageContext":{"name":"scm-jenkins-plugin","slug":"/plugins/scm-jenkins-plugin/docs/3.2.x/en/testing/","version":"3.2.x","latestVersion":"3.2.x","latestPageVersion":"3.2.x","language":"en","canonicalPath":"/plugins/scm-jenkins-plugin/docs/latest/en/testing/","latestRootPath":"/plugins/scm-jenkins-plugin/docs/3.2.x/en/"}}, "staticQueryHashes": ["1973669194","2742214048","2956773653","2957019495","698804963"]}