From 8ba2ea6d4536f89ec8506e828a097eaae829bd4a Mon Sep 17 00:00:00 2001 From: Oleg Nenashev Date: Wed, 15 Apr 2020 23:18:09 +0200 Subject: [PATCH 1/2] Document how to use the Experimental update center from JCasC and Docker images --- .../releasing-experimental-updates.adoc | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/content/doc/developer/publishing/releasing-experimental-updates.adoc b/content/doc/developer/publishing/releasing-experimental-updates.adoc index 0edf1280a070..af5b96a89770 100644 --- a/content/doc/developer/publishing/releasing-experimental-updates.adoc +++ b/content/doc/developer/publishing/releasing-experimental-updates.adoc @@ -18,8 +18,32 @@ Other version strings like `proto`, `rc`, and `unstable` **will appear** in the == Using the Experimental Update Center +Experimental Update Center is not enabled by default in Jenkins, additional steps are needed to enable it in Jenkins. + +=== From the Web interface + Users who are interested in downloading experimental plugin releases can go to _Plugin Manager_, then to the _Advanced_ tab, and configure the update center URL `\https://updates.jenkins.io/experimental/update-center.json`. Submit, and then select _Check Now_. Experimental plugin updates will be marked as such on the _Available_ and _Updates_ tabs of the _Plugin Manager_. Once you install the beta plugins that you wanted, you can switch back to the default `\https://updates.jenkins.io/update-center.json` update center URL. + +=== In Jenkins Configuration-as-Code plugin + +plugin:configuration-as-code[Jenkins Configuration-as-Code plugin] allows configuring update centers in configuration YAMLs. +Once configured, it will be possible to install experimenta plugins and versions from the _Plugin Manager_ Web UI. + +```yml +jenkins: + updateCenter: + sites: + - id: "default" + url: "https://updates.jenkins.io/update-center.json" + - id: "experimental" + url: "https://updates.jenkins.io/experimental/update-center.json" +``` + +=== In official Docker images + +Official link:https://github.com/jenkinsci/docker[Jenkins master Docker image] includes plugin management scripts which allow to preinstall plugins from the Experimental update center. +See the documentation and examples link:https://github.com/jenkinsci/docker#preinstalling-plugins[here]. From f38ae1294427f11a0f43d5c84effd168ecbf1630 Mon Sep 17 00:00:00 2001 From: Oleg Nenashev Date: Thu, 16 Apr 2020 17:02:19 +0200 Subject: [PATCH 2/2] Apply suggestions from code review Co-Authored-By: Daniel Beck <1831569+daniel-beck@users.noreply.github.com> --- .../developer/publishing/releasing-experimental-updates.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/doc/developer/publishing/releasing-experimental-updates.adoc b/content/doc/developer/publishing/releasing-experimental-updates.adoc index af5b96a89770..63a1e4b21aef 100644 --- a/content/doc/developer/publishing/releasing-experimental-updates.adoc +++ b/content/doc/developer/publishing/releasing-experimental-updates.adoc @@ -27,6 +27,7 @@ Submit, and then select _Check Now_. Experimental plugin updates will be marked as such on the _Available_ and _Updates_ tabs of the _Plugin Manager_. Once you install the beta plugins that you wanted, you can switch back to the default `\https://updates.jenkins.io/update-center.json` update center URL. +The experimental update center only offers the latest version of each plugin, even if it is incompatible with your version of Jenkins. === In Jenkins Configuration-as-Code plugin @@ -45,5 +46,5 @@ jenkins: === In official Docker images -Official link:https://github.com/jenkinsci/docker[Jenkins master Docker image] includes plugin management scripts which allow to preinstall plugins from the Experimental update center. +Official link:https://github.com/jenkinsci/docker[Jenkins master Docker image] includes plugin management scripts which allow preinstalling plugins from the Experimental update center. See the documentation and examples link:https://github.com/jenkinsci/docker#preinstalling-plugins[here].