The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

Debian Pbuilder

debianPbuilder: Build Debian packages in a pbuilder environment

  • additionalBuildResults : String (optional)

    When running a build in the chroot environment, there are occasionally files that you must retrieve from the chroot that are not part of the normal build. For example, some files that you may need to get back would include test results, auto-generated files, etc.

    Set this variable in order to get the files back from the chroot build environment.

    The files that are retrieved will also automatically be archived as well with the other build results.

    This must be a comma-separated list; spaces are allowed.

  • architecture : String (optional)

    The architecture to build this as.

    If the project is using the Matrix Build plugin, leave this blank (the architectures to build for are defined by the 'architecture' environment variable).

    This is mostly to support Pipeline, however it can be used as a normal parameter as well.

  • artifactoryRepoName : String (optional)

    If you are generating a spec file for use with Artifactory, this defines the repository that you would like to upload it to.

  • binariesDir : String (optional)

    The directory in the workspace to put the built binaries in. If not set, a random temp directory will be made. This is generally useful if you build multiple packages at once and/or need a stable location to find all of the binaries that have been built.

  • bindMounts : String (optional)

    Additional directories to mount in the pbuilder chroot. Corresponds to the BINDMOUNTS variable in pbuilderrc.

  • buildAsTag : boolean (optional)

    Set this to mark this as building a tag. When a build comes from a tag, the deb version does not get incremented(i.e. it is exactly as set in the debian/changelog file). If using SVN, this plugin automatically looks at the SVN_URL_1 environment variable to see if the string "tags/" exists. If it does, the build will act as though this parameter is set. If using Git, this plugin automatically looks at the GIT_BRANCH environment variable to see if the string "tags/" exists. If it does, the build will act as though this parameter is set. Alternatively, you can also set the environment variable DEB_PBUILDER_BUILDING_TAG to either true or false.

  • components : String (optional)

    The components to build with. By default, pbuilder sets this to 'main'. If you're building an Ubuntu package, you may need to set this to "main restricted universe multiverse"

    The setting guessComponents must be false for this setting to be honored.

  • debianDirLocation : String (optional)

    The location of the debian/ directory, relative to workspace root

    This may also be set globally

  • distribution : String (optional)

    The distribution to build for. By default, this checks the distribution that is set in debian/changelog. If the version in the changelog is UNRELEASED, it attempts to use the currently running distribution if this parameter is NULL or a 0-length string.

  • extraPackages : String (optional)

    Extra packages to install in the chroot environment. Corresponds to EXTRAPACKAGES in the pbuilder configuration

  • generateArtifactorySpecFile : boolean (optional)

    Generate a spec file to be used with Artifactory in order to upload files. By default, this will generate the file with the .deb, .tar* and .gz files for uploading.

    This will generate a spec file in the workspace called artifactory-spec-debian-pbuilder/debian-pbuilder.spec which you can then use to upload the binaries to Artifactory. This is intended to be used in conjunction with the Artifactory Jenkins plugin.

  • guessComponents : boolean (optional)

    If set to true, automatically try to guess the components. This means that if we think we are building an Ubuntu package on Debian, our components will be automatically set to "main restricted universe multiverse"

  • keyring : String (optional)

    The keyring to build with. By default, we will attempt to figure out if we are building a Debian package on Ubuntu, and if we think that we are this will be set to /usr/share/keyrings/debian-archive-keyring.gpg. This file is part of the debian-archive-keyring package. If you need to use a custom keyring, put it in here. If for some reason the auto-detection is not working properly, set this to the string 'disabled' and no keyring settings for pbuilder will be set.

  • mirrorSite : String (optional)

    The mirror site to use. If this is not set or a 0-length string, then the default mirror site for this distribution will be used. The default mirror site is defined in /etc/pbuilderrc

  • numberCores : int (optional)

    The number of cores to use when building. By default, this is 1. Set to -1 in order to use as many cores as possible when building. In order for this to take effect, you need to make sure that your debian/rules is setup properly. See this post.

  • otherMirror : String (optional)

    The extra mirror to use. Corresponds to OTHERMIRROR configuration option in pbuilder

  • pbuilderType : String (optional)
  • pristineTarName : String (optional)

    If this field set, and if source/format indicates that this is a quilt package, we will attempt to checkout the given original tar file.

Was this page helpful?

Please submit your feedback about this page through this quick form.

Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?


See existing feedback here.