Jenkins : Configuration as Code Plugin

Plugin information

Plugin Information

View Configuration as Code on the plugin site for more information.

Configuration as Code plugin has been designed as an opinionated way to configure Jenkins based on human-readable declarative configuration files.

 For more information consult the plugin's README.


Changelog

Post 1.0: see jenkinsci/configuration-as-code-plugin/releases

1.0 (12.09.2018)

  • Continued to improve documentation
  • Shade snakeyaml
  • Warning on the export feature - "It can be used for inspiration writing your own, be aware export can be partial, or fail for some components."

1.0-rc3 (06.09.2018)

  • Continued to improve documentation
  • Fixed exporting issues 
  • Added suggestion to install configuration-as-code-support if not installed as an error message
  • Descriptors pointed by ManagementLink as RootElements are now discovered
  • Only setters which have a matching getter are now considered
  • Fixed upper-bound dependencies issue
  • Simpler role-strategy plugin implementation relying on BaseConfigurator

1.0-rc2 (23.08.2018)

  • Introduced functionality to replace existing configuration via UI.
  • Re-introduced support for 'latest' version when installing plugins.
  • Continued to improve documentation

1.0-rc1 (10.08.2018)

First release candidate. WARNING: Lots of functionality and integrations with other plugins was moved to a separate plugin for the first official RC. Please install: configuration-as-code-support plugin from the update center

  • Continued improving documentation

BREAKING CHANGES:

  • Most people need to install the new configuration-as-code-support plugin (Also in Vers. 1.0-rc1) to make things work (unless you are using a bare minimum of supported features)
  • If you have set the value:
configuration-as-code:
  deprecation: warn

then you must change deprecation: to deprecated

  • Plugin now throws NullPointer Exceptions for any empty values in Yaml. Discussion about which ones need fixing and how, are still ongoing in the Gitter channel.
  • Plugin now throws NullPointerException if values like passwords or private keys are not enclosed in quotes
  • The syntax for authorizationStrategy has changed a lot. Try something like:
authorizationStrategy:
  globalMatrix:
    grantedPermissions:
      - Overall/Read:anonymous
      - Job/Read:anonymous
      - View/Read:anonymous
      - Overall/Administer:authenticated

0.11-alpha (02.08.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

0.10-alpha (11.07.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

0.9-alpha (26.06.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

0.8-alpha (06.06.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

  • Security issues fixed
    • Export now requires ADMINISTER permission
    • Credentials are not logged in plain text anymore
  • Continued to improve documentation
  • Fixed non-fatal error on initialization when Credentials Plugin is not installed 

  • Added support of loading CasC definition from WAR file bundles

0.7-alpha (30.05.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

  • Added preliminary plugin installation syntax
  • Continued to improve documentation by new examples
  • Added the ability to set the docker secrets directory via SECRETS environment variable
  • Allow default value for secrets

0.6-alpha (18.05.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

0.5-alpha (07.05.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

0.4-alpha (18.04.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

0.3-alpha (05.04.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

0.2-alpha (21.03.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.


0.1-alpha (23.02.2018)

Alpha version of the Configuration as Code Plugin. Use only in test instances.

  • Initial release
  • Configure (some) plugins via yaml file
  • Reload configuration from yaml file - manual step, available under `Manage Jenkins` → `Configuration as Code`
  • Support for seed job creation 
  • Support for build agents configuration