Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Plugin Information

View Jobcopy Builder on the plugin site for more information.

This plugin adds "Copy Job" as a build step. You can select how to retrieve choices, including the way to share choices among all jobs.

What's this?

This plugin provides a Copy Job build step:

  • It makes a new job from an existing job.
    • You can copy multiple jobs in one build execution with specifying multiple Copy Job build steps.
    • Can be applied to any type of jobs.
  • You specify following parameters.
    • From Job Name
      • Variable expressions can be used.
    • To Job Name
      • Variable expressions can be used.
    • Overwrite
      • Specifies whether to overwrite the destination job if it already exists.
  • Additional operations can be performed when copying.
    • Enable Job: Enabling the destination job if the source job is disabled.
    • Replace String: Replace strings in a job configuration.
      • Source and destination strings can contain variable expressions.
  • Additional operation can be extended by using Extension Points.


  • The job contains Copy Job build steps must run on the master node.


  1. You can add "Copy Job" build step.
  2. "Copy Job" performs additional operations. Replacing strings in the configuration, enabling a disabled job.
    • The job copied from
    • The job copied to. String "VERSION" is replaced, and the job is enabled.
  3. Replacing strings can be applied to any part of configurations, including that of plugins. This is a example that the branch field of Git plugin is replaced.
    • The job copied from.
    • The job copied to. String "VERSION" is replaced.

How does this work?

This plugin works as following:

  1. Reads the configuration xml (config.xml) of the copying job.
  2. Applies the operations to the configuration xml string.
  3. Create a new job with the processed configuration xml string.

Extension point

A new way to provide choices can be added with implementing JobcopyOperation, overriding the following method:

public String perform(String xmlString, String encoding, EnvVars env, PrintStream logger);

or, with extending AbstractXmlJobcopyOperation, overriding the following method:

abstract public Document perform(Document doc, EnvVars env, PrintStream logger);

Used with promoted builds

When used with Promoted Builds Plugin, the configurations of promotions are not copied for they are not stored in config.xml.
Do as followings:

  • Click "Advanced" in "copy Job"
  • Add "Additional File Sets", specify "promotions/*/config.xml" in "Files".


To report a bug or request an enhancement to this plugin please create a ticket in JIRA.

type key summary

Data cannot be retrieved due to an unexpected error.

View these issues in Jira

Change Log

Version 1.1.2 (Dec 22, 2013)

  • FIXED: Build results page shows wrong link for Copied To and Copied From (JENKINS-21080)

Version 1.1.1 (Aug 31, 2013)

  • Fixed a problem with overwriting multi-configuration projects.
    • combination filter was not removed even when it is removed in the source project.

Version 1.1.0 (Feb 27, 2013)

  • Added advanced configuration to copy additional files.
    • Useful for plugins that does not store configurations in config.xml of the job.
    • For example, you can copy configurations of Promoted Builds Plugin.

Version 1.0.1 (Feb 06, 2013)

  • Improved overwrite behavior
    • Version 1.0.0: delete the old job, and create a new job. Also builds are deleted.
    • Version 1.0.1 and later: update the configuration. Builds are preserved.
  • expand "From Job Name" field

Version 1.0.0 (Jan 14, 2013)

  • Initial release.
  • No labels