Jenkins Community Node icon

Jenkins Community Node

Jenkins Node

Actions16

Overview

This node integrates with Jenkins, a popular automation server used for continuous integration and delivery. Specifically, the "Get Job Config" operation under the "Job Management" resource retrieves the configuration XML of a specified Jenkins job.

Use cases include:

  • Fetching the current configuration of a Jenkins job to review or audit its settings.
  • Backing up job configurations before making changes.
  • Automating workflows that require reading job configurations programmatically.

For example, you might use this node to get the XML config of a build job named "MyApp_Build" to verify its parameters or pipeline script.

Properties

Name Meaning
Job Name The exact name of the Jenkins job whose configuration you want to retrieve (required).

Output

The output contains both JSON and binary data:

  • json: An object with a key "config.xml" containing the raw XML string of the job configuration.
  • binary: A binary representation of the same XML content, accessible under the key "config.xml". This allows downstream nodes to handle the config as a file if needed.

Example output structure:

{
  "json": {
    "config.xml": "<xml>...</xml>"
  },
  "binary": {
    "config.xml": {
      "data": "<Buffer ...>",
      "mimeType": "text/xml",
      "fileName": "config.xml"
    }
  }
}

Dependencies

  • Requires an API authentication credential for Jenkins (an API key or token).
  • Needs the Jenkins base URL configured in the credentials.
  • Uses HTTP requests authenticated via the provided Jenkins credentials.

Troubleshooting

  • No credentials found: Ensure you have configured valid Jenkins API credentials in n8n.
  • 404 Not Found: Verify the job name is correct and exists on the Jenkins server.
  • Permission denied or 403 errors: Check that the API token has sufficient permissions to read job configurations.
  • Invalid XML or empty response: Confirm the Jenkins server is reachable and the job is properly configured.

Links and References

Discussion