Skip to content

Document how to use the Experimental update center from JCasC and Docker images #3068

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
oleg-nenashev merged 2 commits into from
Apr 16, 2020
Merged

Document how to use the Experimental update center from JCasC and Docker images #3068

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8ba2ea6
Document how to use the Experimental update center from JCasC and Doc…
oleg-nenashev Apr 15, 2020
f38ae12
Apply suggestions from code review
oleg-nenashev Apr 16, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions content/doc/developer/publishing/releasing-experimental-updates.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,33 @@ 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.
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

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 preinstalling plugins from the Experimental update center.
See the documentation and examples link:https://github.com/jenkinsci/docker#preinstalling-plugins[here].