jenkinsci
/
configuration-as-code-plugin
mirror of https://github.com/jenkinsci/configuration-as-code-plugin.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
configuration-as-code-plugin/docs/RELEASE_NOTES.md

1.4 KiB
Raw Blame History

Configuration as Code Plugin Releases

Alpha Version

0.1-alpha version of Configuration as Code Plugin has a number of issues that may break your Jenkins instance - details below. DO NOT USE in production environment, only for test.

Features available:

  • Configure (some) plugins via yaml file
  • Reload configuration from yaml file - manual step, available under Manage Jenkins➡️ Configuration as Code
  • Vault support - details in README
  • seed job creation - details in README
  • build agents configuration
  • github OAuth support
  • Matrix (and Matrix Project) Authorization Strategy support

Limitations:

  • Location of yaml file with configuration MUST be provided via environment variable CASC_JENKINS_CONFIG - can be location on disk readable from Jenkins perspective
  • plugins has to be installed manually (and it must happen before you try to configure them)

How to use it

  1. Add experimental plugins repository (link)
  2. Prepare jenkins.yaml and store the location in CASC_JENKINS_CONFIG environment variable
  3. Install Configuration as Code plugin (& all the others plugins you want to use)
  4. When installed plugin will look for configuration file and configure Jenkins accordingly
  5. To change the configuration go to Manage Jenkins➡️ Configuration as Code and hit "Reload" button