Configuration as Code Plugin

Plugin information

 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.

• Continued to improve documentation
• Support reading Vault secrets from a file (https://github.com/jenkinsci/configuration-as-code-plugin/pull/364)
• Introduced support for token-based access to Vault (https://github.com/jenkinsci/configuration-as-code-plugin/pull/388) 
• Introduce Configurable for the component which directly manages CasC ()
• Allow configuring see-job with an external file or URL for JobDSL script (https://github.com/jenkinsci/configuration-as-code-plugin/pull/365)
• The download path for the plugin is computed correctly now (https://github.com/jenkinsci/configuration-as-code-plugin/pull/365)
• Upgraded Snake Yaml dependency (https://github.com/jenkinsci/configuration-as-code-plugin/pull/383)
• Fixed documentation generation (https://github.com/jenkinsci/configuration-as-code-plugin/pull/394)
• Fixed support for "latest" as the plugin version number (https://github.com/jenkinsci/configuration-as-code-plugin/pull/403)
• Introduced a simple mechanism to exclude some irrelevant attributes (https://github.com/jenkinsci/configuration-as-code-plugin/pull/404)
• Fixed Export Configuration error "This web page is not available" (https://github.com/jenkinsci/configuration-as-code-plugin/issues/324)

0.10-alpha (11.07.2018)

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

• Continued to improve documentation
• Split tests and plugin into two separate maven modules
• Fixed a bug when configuring the maven tool (https://github.com/jenkinsci/configuration-as-code-plugin/issues/170)
• Fixed errors when exporting configuration
• Added CLI integration (https://github.com/jenkinsci/configuration-as-code-plugin/commit/e6dd10631cc6bdc7457187bf9562d8c2a9dc9967)
• Added REST endpoints to apply and check configuration (https://github.com/jenkinsci/configuration-as-code-plugin/commit/dbe88b67dc80535153fe2cca3f57531e427e84fa)
• ....many other smaller things.

0.9-alpha (26.06.2018)

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

• Continued to improve documentation
• FindBugs issues fixed

• Introduced « version » in CasC YAML file (https://github.com/jenkinsci/configuration-as-code-plugin/pull/284/files)

  • also, include plugin self-configuration feature (https://github.com/jenkinsci/configuration-as-code-plugin/commit/80ff5a7d581c67f024fa38e4d248a762ea1b33b7)
• Job DSL made an optional dependency (https://github.com/jenkinsci/configuration-as-code-plugin/pull/289)
• Plugin installation fixes (https://github.com/jenkinsci/configuration-as-code-plugin/pull/270)

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.

• Documentation improvements (more demos & fixes in existing files, available in plugin repository)

• Support (global) node properties, including environment variables (https://github.com/jenkinsci/configuration-as-code-plugin/pull/183)

0.4-alpha (18.04.2018)

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

• Documentation improvements (more demos & fixes in extisting files, available in plugin repository)
• Annotate API methods in the Configurator extension point (https://github.com/jenkinsci/configuration-as-code-plugin/pull/165)

0.3-alpha (05.04.2018)

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

• Documentation improvements (more demos & fixes in extisting files, available in plugin repository)
• Replace array list with set in a recursive call (https://github.com/jenkinsci/configuration-as-code-plugin/pull/135)
• Reading docker secret from a file includes newline - WIP (https://github.com/jenkinsci/configuration-as-code-plugin/issues/163)

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