Skip to content

Commit

Permalink
Link from download pages to install guides (#7776)
Browse files Browse the repository at this point in the history
  • Loading branch information
MarkEWaite authored Dec 23, 2024
1 parent 2a98617 commit 7cd5b73
Show file tree
Hide file tree
Showing 4 changed files with 53 additions and 18 deletions.
29 changes: 19 additions & 10 deletions content/doc/book/installing/linux.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -17,19 +17,18 @@ Jenkins installers are available for several Linux distributions.

* <<Debian/Ubuntu>>
* <<Fedora>>
* <<red-hat-centos,Red Hat/Alma/Rocky>>
* <<red-hat-centos,Red Hat Enterprise Linux and derivatives>>

include::doc/book/installing/_installation_requirements.adoc[]

== Debian/Ubuntu

On Debian and Debian-based distributions like Ubuntu you can install Jenkins through `apt`.

NOTE: With the release of link:https://www.debian.org/News/2023/20230610[Debian 12], OpenJDK 11 is *no longer* included.
It has been replaced with link:https://openjdk.org/projects/jdk/17/[OpenJDK 17], which is reflected in the instructions below.

[#debian-stable]
=== Long Term Support release

[#long-term-support-release]
A link:/download/lts/[LTS (Long-Term Support) release] is chosen every 12 weeks from the stream of regular releases as the stable release for that time period.
It can be installed from the link:https://pkg.jenkins.io/debian-stable/[`debian-stable` apt repository].

Expand All @@ -44,8 +43,10 @@ sudo apt-get update
sudo apt-get install jenkins
----

[#debian-weekly]
=== Weekly release

[#weekly-release]
A new release is produced weekly to deliver bug fixes and features to users and plugin developers.
It can be installed from the link:https://pkg.jenkins.io/debian/[`debian` apt repository].

Expand All @@ -61,7 +62,7 @@ sudo apt-get install jenkins
----

Beginning with Jenkins 2.335 and Jenkins 2.332.1, the package is configured with `systemd` rather than the older System V `init`.
See the link:https://www.digitalocean.com/community/tutorials/how-to-use-systemctl-to-manage-systemd-services-and-units[DigitalOcean community `systemd` tutorial] to better understand the benefits of `systemd` and the `systemctl` command.
More information is available in link:/doc/book/system-administration/systemd-services/["Managing systemd services"].

The package installation will:

Expand Down Expand Up @@ -99,9 +100,9 @@ Update the Debian apt repositories, install OpenJDK 17, and check the installati
sudo apt update
sudo apt install fontconfig openjdk-17-jre
java -version
openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment (build 17.0.8+7-Debian-1deb12u1)
OpenJDK 64-Bit Server VM (build 17.0.8+7-Debian-1deb12u1, mixed mode, sharing)
openjdk version "17.0.13" 2024-10-15
OpenJDK Runtime Environment (build 17.0.13+11-Debian-2)
OpenJDK 64-Bit Server VM (build 17.0.13+11-Debian-2, mixed mode, sharing)
----

[NOTE]
Expand All @@ -116,8 +117,10 @@ Simple software management tasks like install, search and remove are easier with

You can install Jenkins through `dnf`. You need to add the Jenkins repository from the Jenkins website to the package manager first.

[#fedora-stable]
=== Long Term Support release

[#long-term-support-release-2]
A link:/download/lts/[LTS (Long-Term Support) release] is chosen every 12 weeks from the stream of regular releases as the stable release for that time period.
It can be installed from the link:https://pkg.jenkins.io/redhat-stable/[`redhat-stable`] yum repository.

Expand All @@ -133,8 +136,10 @@ sudo dnf install jenkins
sudo systemctl daemon-reload
----

[#fedora-weekly]
=== Weekly release

[#weekly-release-2]
A new release is produced weekly to deliver bug fixes and features to users and plugin developers.
It can be installed from the link:https://pkg.jenkins.io/redhat/[`redhat`] yum repository.

Expand Down Expand Up @@ -204,17 +209,19 @@ firewall-cmd --reload
====

[#red-hat-centos]
== Red Hat/Alma/Rocky
== Red Hat Enterprise Linux and derivatives

You can install Jenkins through `yum` on Red Hat Enterprise Linux, Alma Linux, Rocky Linux, Oracle Linux, and other Red Hat based distributions.
You can install Jenkins through `yum` on Red Hat Enterprise Linux, AlmaLinux, Rocky Linux, Oracle Linux, CentOS, and other Red Hat based distributions.

.How To Install Jenkins on Rocky Linux 9
video::2-L0WohfsqY[youtube, width=640, height=360]

You need to choose either the Jenkins Long Term Support release or the Jenkins weekly release.

[#red-hat-stable]
=== Long Term Support release

[#long-term-support-release-3]
A link:/download/lts/[LTS (Long-Term Support) release] is chosen every 12 weeks from the stream of regular releases as the stable release for that time period.
It can be installed from the link:https://pkg.jenkins.io/redhat-stable/[`redhat-stable`] yum repository.

Expand All @@ -230,8 +237,10 @@ sudo yum install jenkins
sudo systemctl daemon-reload
----

[#red-hat-weekly]
=== Weekly release

[#weekly-release-3]
A new release is produced weekly to deliver bug fixes and features to users and plugin developers.
It can be installed from the link:https://pkg.jenkins.io/redhat/[`redhat`] yum repository.

Expand Down
22 changes: 16 additions & 6 deletions content/download/index.html.haml
Original file line number Diff line number Diff line change
Expand Up @@ -78,13 +78,18 @@ title: Download and deploy
},
{
"image": "ubuntu",
"href": "https://pkg.jenkins.io/debian-stable/",
"href": "/doc/book/installing/linux/#debianubuntu",
"title": "Ubuntu/Debian"
},
{
"image": "redhat",
"href": "https://pkg.jenkins.io/redhat-stable/",
"title": "Red Hat/Fedora/Alma/Rocky/CentOS"
"href": "/doc/book/installing/linux/#red-hat-centos",
"title": "Red Hat Enterprise Linux and derivatives"
},
{
"image": "fedora",
"href": "/doc/book/installing/linux/#fedora",
"title": "Fedora"
},
{
"image": "windows",
Expand Down Expand Up @@ -135,13 +140,18 @@ title: Download and deploy
},
{
"image": "ubuntu",
"href": "https://pkg.jenkins.io/debian/",
"href": "/doc/book/installing/linux/#debian-weekly",
"title": "Ubuntu/Debian"
},
{
"image": "redhat",
"href": "https://pkg.jenkins.io/redhat/",
"title": "Red Hat/Fedora/Alma/Rocky/CentOS"
"href": "/doc/book/installing/linux/#red-hat-weekly",
"title": "Red Hat Enterprise Linux and derivatives"
},
{
"image": "fedora",
"href": "/doc/book/installing/linux/#fedora-weekly",
"title": "Fedora"
},
{
"image": "windows",
Expand Down
4 changes: 2 additions & 2 deletions content/download/verify.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Refer to link:https://www.ghacks.net/2018/04/16/how-to-verify-digital-signatures

=== Linux Package Repositories

The long term support Linux package repositories for link:https://pkg.jenkins.io/debian-stable/[Debian/Ubuntu] and link:https://pkg.jenkins.io/redhat-stable/[Red Hat/Fedora/Alma/Rocky/CentOS] have used the following GPG key since Jenkins 2.387.2:
The long term support Linux package repositories for link:/doc/book/installing/linux/#debian-stable[Debian/Ubuntu], link:/doc/book/installing/linux/#red-hat-stable[Red Hat Enterprise Linux (and derivatives)], and link:/doc/book/installing/linux/#fedora-stable[Fedora Linux] have used the following GPG key since Jenkins 2.387.2:

[source]
----
Expand All @@ -55,7 +55,7 @@ uid Jenkins Project <[email protected]>
sub rsa4096 2023-03-27 [E] [expires: 2026-03-26]
----

The weekly Linux package repositories for link:https://pkg.jenkins.io/debian/[Debian/Ubuntu] and link:https://pkg.jenkins.io/redhat/[Red Hat/Fedora/Alma/Rocky/CentOS] have used the same GPG key since Jenkins 2.397 (March 2023).
The weekly Linux package repositories for link:/doc/book/installing/linux/#debian-weekly[Debian/Ubuntu], link:/doc/book/installing/linux/#red-hat-weekly[Red Hat Enterprise Linux (and derivatives)], and link:/doc/book/installing/linux/#fedora-weekly[Fedora Linux] have used the same GPG key since Jenkins 2.397 (March 2023).

== Verifying Plugin Downloads

Expand Down
16 changes: 16 additions & 0 deletions content/images/symbols/fedora.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 7cd5b73

Please sign in to comment.