Jenkins

Learn about configurations >

• bundle-site | string

  Site to download deb packages from when installing jenkins from bundle. If this configuration is not set, the jenkins deb package needs to be manually copied over to the charm files/ dir before deployment and named jenkins.deb.

• extra_packages | string

  Space separated list of extra deb packages to install.

• install_keys | string

  List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.

• install_sources | string

  List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.

• jnlp-port | int

  Default: 48484

  TCP port on which to listen for incoming connections from slaves. Set to 0 for a random port, or to -1 to disable JNLP entirely.

• master-executors | int

  Default: 1

  Number of executors to configure for jenkins master.

• no-proxy | string

  If a proxy is configured but some hosts should not go through the proxy, set the hostnames here. Ignored if any of the proxy settings above are not set. Separated by commas. "" is the wild card host name(such as ".jenkins.io" or "www*.jenkins-ci.org").

• package_status | string

  Default: install

  The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".

• password | string

  Admin user password, will be auto-generated if not set. Can be retrieved via the get-admin-credentials action. This is used to manage slave nodes so please don't change in Jenkins.

• plugins | string

  Space separated list of plugins to install

• plugins-auto-update | boolean

  This option enables auto update for plugins. The routine will check for new versions available based on Update Center's info, will update them through jenkins and safe-restart once completed.

• plugins-auto-update-interval | int

  Default: 1440

  Interval which the auto-update will try to run (in minutes).

• plugins-check-certificate | string

  Default: yes

  Set to no to allow downloading from an invalid https site.

• plugins-site | string

  Default: https://updates.jenkins-ci.org/latest/

  Site to download plugin .hpi files from.

• proxy-hostname | string

  If a proxy is required for Jenkins to download plugins and updates, set its hostname or IP address here, e.g. "proxy.example.tld" or "10.0.0.1".

• proxy-password | string

  If a proxy is required for Jenkins to download plugins and updates and authentication is also required, set the password here. Ignored if proxy-hostname and proxy-password are not both also set.

• proxy-port | int

  Default: 3128

  If a proxy is required for Jenkins to download plugins and updates, set its port number here. Ignored if proxy-hostname is not also set.

• proxy-username | string

  If a proxy is required for Jenkins to download plugins and updates and authentication is also required, set the username here. Ignored if proxy-hostname is not also set.

• public-url | string

  Public url of Jenkins frontend, including the hostname and prefix. This is used by Jenkins whenever generating full links.

• release | string

  Default: lts

  Source of Jenkins, options include: - lts: use the most recent Jenkins LTS release. - trunk: use the most recent Jenkins release. - bundle: use a bundled deb package. The bundle-site configuration should be set or the jenkins deb package needs to be manually copied over to the charm files/ dir before deployment and named jenkins.deb. It can be downloaded from http://pkg.jenkins-ci.org/debian/ - http(s)://...: http(s) link to a retrievable jenkins deb

• remove-unlisted-plugins | string

  Default: no

  Set this to yes to remove any plugins not listed in plugins from the installation.

• tools | string

  Default: git gcc make bzr

  Tooling to deploy alongside jenkins

• update-center | string

  Configure a custom Update Center instead of getting plugins from updates.jenkins-ci.org. Provide the whole path to update-center.json file. Example: https://your-domain.com/current/update-center.json

• update-center-ca | string

  CA certificate for the update-center. This is required when setting update-center because jenkins won't be able to validate your custom Update Center without it.

• username | string

  Default: admin

  Admin user username - used to manage slave nodes so please don't change in Jenkins.