Jenkins Community Node icon

Jenkins Community Node

Jenkins Node

Actions16

Overview

The node integrates with Jenkins, a popular automation server used for continuous integration and delivery. Specifically, the Create Job operation under the Job Management resource allows users to create new Jenkins jobs by uploading job configuration data in XML format.

This operation is useful when automating Jenkins job creation as part of CI/CD pipelines or infrastructure provisioning workflows. For example, you can programmatically create a new build job in Jenkins from an n8n workflow by providing the job name and its XML configuration, enabling automated setup of build environments without manual intervention.

Properties

Name Meaning
Job Name The name of the Jenkins job to create.
Job Binary Input The binary input containing the job configuration XML data required to create the job.

Output

The output JSON contains a simple status confirmation indicating whether the job creation was successful. It looks like:

[
  {
    "status": "success"
  }
]

No binary data is output for this operation.

Dependencies

  • Requires connection to a Jenkins server with appropriate API access.
  • Needs an API authentication token or credentials configured in n8n to authenticate requests to Jenkins.
  • The Jenkins server URL must be provided via credentials.
  • The job configuration must be supplied as valid XML in binary form.

Troubleshooting

  • Missing Credentials Error: If no Jenkins credentials are found, the node will throw an error. Ensure that valid Jenkins API credentials are configured in n8n.
  • Invalid Job Configuration: If the XML binary input is missing or malformed, the request to create the job will fail. Verify that the binary input contains valid Jenkins job XML configuration.
  • HTTP Errors: Jenkins may return errors if the job name already exists or if permissions are insufficient. Check Jenkins logs and permissions.
  • Binary Data Assertion: The node asserts that the job configuration is provided as binary data; failure to provide binary input will cause an error.

Links and References

Discussion