diff --git a/documentation/migration-guide-0.1.1-to-0.2.0.md b/documentation/migration-guide-0.1.1-to-0.2.0.md new file mode 100644 index 00000000..3b604c12 --- /dev/null +++ b/documentation/migration-guide-0.1.1-to-0.2.0.md @@ -0,0 +1,32 @@ +# Migration guide from v0.1.1 to v0.2.0 + +### Added seed job agent +Now seed jobs are not built by master executors, but by dedicated agent deployed into Kubernetes. We disabled master executors for security reasons. + +### Apply Jenkins configuration via Groovy scripts instead of Jenkins jobs +We have removed hardcoded configuration by Jenkins jobs. + +In v0.1.1 jenkins-operator configuration was stored in `jenkins-operator-user-configuration-` +If you want to use v0.2.0 or newer you must simply write refer to old ConfigMap by modifying CR, for example: + +```yaml +apiVersion: jenkins.io/v1alpha2 +kind: Jenkins +metadata: + name: example +spec: + configurationAsCode: + configurations: + - name: jenkins-operator-user-configuration- + groovyScripts: + configurations: + - name: jenkins-operator-user-configuration- +``` + +Jenkins configuration jobs (Configure Seed Jobs, jenkins-operator-base-configuration, jenkins-operator-user-configuration) have been removed from Jenkins. + +In v0.1.1 you can see if configuration failed or successfully updated in Jenkins UI(job build logs). +Now, when Jenkins configuration jobs are removed, you must use this command to see if configuration was failed. +```bash +$ kubectl -n logs deployment/jenkins-operator +``` \ No newline at end of file