From e3732ae73417ea3371f1c4648620f95f79b99fb8 Mon Sep 17 00:00:00 2001 From: Mark Waite Date: Sun, 22 Dec 2024 18:16:07 -0700 Subject: [PATCH] Link from download pages to install guides, not pkg.jenkins.io The pkg.jenkins.io site is the download site, but it is not the best site for installation instructiosn for Linux packages. Users of the Linux packages do not use a download URL. They use a series of steps that are specific to their operating system and its package manager. The link to the download site is a link to installation steps listed on pkg.jenkins.io. The installation steps on www.jenkins.io are more thorough and include specific instructions for Fedora Linux that are not available on pkg.jenkins.io Adds Fedora Linux as a seperate link in the list of packages because it intentionally has separate instructions for its `dnf` package manager. Red Hat Enterprise Linux 10 is planned to include the `dnf` package manager when it releases in mid-2025. When it releases, we'll need to revisit the instructions. --- content/doc/book/installing/linux.adoc | 11 +++++++++++ content/download/index.html.haml | 22 ++++++++++++++++------ content/download/verify.adoc | 4 ++-- content/images/symbols/fedora.svg | 16 ++++++++++++++++ 4 files changed, 45 insertions(+), 8 deletions(-) create mode 100644 content/images/symbols/fedora.svg diff --git a/content/doc/book/installing/linux.adoc b/content/doc/book/installing/linux.adoc index 9dfe682f679d..4c6efab8a09f 100644 --- a/content/doc/book/installing/linux.adoc +++ b/content/doc/book/installing/linux.adoc @@ -28,6 +28,7 @@ On Debian and Debian-based distributions like Ubuntu you can install Jenkins thr [#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]. @@ -42,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]. @@ -114,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. @@ -131,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. @@ -211,8 +218,10 @@ 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. @@ -228,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. diff --git a/content/download/index.html.haml b/content/download/index.html.haml index 7a61380286cb..435b287f318e 100644 --- a/content/download/index.html.haml +++ b/content/download/index.html.haml @@ -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", @@ -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", diff --git a/content/download/verify.adoc b/content/download/verify.adoc index 1f277fba8323..1b3815a86ed0 100644 --- a/content/download/verify.adoc +++ b/content/download/verify.adoc @@ -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] ---- @@ -55,7 +55,7 @@ uid Jenkins Project 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 diff --git a/content/images/symbols/fedora.svg b/content/images/symbols/fedora.svg new file mode 100644 index 000000000000..e22731170af0 --- /dev/null +++ b/content/images/symbols/fedora.svg @@ -0,0 +1,16 @@ + + + + + + +