From d1df27bc14157267f1da12d5eb627fb041af8346 Mon Sep 17 00:00:00 2001
From: jack1142 <6032823+jack1142@users.noreply.github.com>
Date: Sun, 26 Dec 2021 21:50:22 +0100
Subject: [PATCH] Update supported OSes (add Alma Linux, RPi OS 11, drop EOL
OSes) (#5440)
* Drop Fedora 33
By the time we release, it's going to reach EOL.
* Drop Raspberry Pi OS 10, add support for 11
* Bring RPi OS 10 back
* Add Alma Linux 8
* Fix-up RHEL EOL dates
* Add '(Legacy)' to Raspberry Pi OS 10
* Drop CentOS 8
---
docs/install_guides/alma-linux-8.rst | 7 +++
docs/install_guides/centos-8.rst | 7 ---
docs/install_guides/fedora.rst | 2 +-
docs/install_guides/index.rst | 3 +-
docs/install_guides/raspberry-pi-os-10.rst | 26 ++++++++--
docs/install_guides/raspberry-pi-os-11.rst | 40 +++++++++++++++
docs/version_guarantees.rst | 57 +++++++++++-----------
7 files changed, 102 insertions(+), 40 deletions(-)
create mode 100644 docs/install_guides/alma-linux-8.rst
delete mode 100644 docs/install_guides/centos-8.rst
create mode 100644 docs/install_guides/raspberry-pi-os-11.rst
diff --git a/docs/install_guides/alma-linux-8.rst b/docs/install_guides/alma-linux-8.rst
new file mode 100644
index 000000000..bd867d1c8
--- /dev/null
+++ b/docs/install_guides/alma-linux-8.rst
@@ -0,0 +1,7 @@
+.. _install-alma-linux-8:
+
+====================================
+Installing Red on Alma Linux 8.4-8.x
+====================================
+
+.. include:: _includes/install-guide-rhel-derivatives.rst
diff --git a/docs/install_guides/centos-8.rst b/docs/install_guides/centos-8.rst
deleted file mode 100644
index dafba7fdf..000000000
--- a/docs/install_guides/centos-8.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-.. _install-centos-8:
-
-=============================
-Installing Red on CentOS 8.4+
-=============================
-
-.. include:: _includes/install-guide-rhel-derivatives.rst
diff --git a/docs/install_guides/fedora.rst b/docs/install_guides/fedora.rst
index 645697582..9358a62b3 100644
--- a/docs/install_guides/fedora.rst
+++ b/docs/install_guides/fedora.rst
@@ -10,7 +10,7 @@ Installing Red on Fedora Linux
Installing the pre-requirements
-------------------------------
-Fedora Linux 33 and above has all required packages available in official repositories. Install
+Fedora Linux 34 and above has all required packages available in official repositories. Install
them with dnf:
.. prompt:: bash
diff --git a/docs/install_guides/index.rst b/docs/install_guides/index.rst
index 0837a32db..22c11fa9f 100644
--- a/docs/install_guides/index.rst
+++ b/docs/install_guides/index.rst
@@ -13,9 +13,9 @@ we recommend **Ubuntu 20.04 LTS**.
windows
mac
+ alma-linux-8
arch
centos-7
- centos-8
centos-stream-8
debian-10
debian-11
@@ -24,6 +24,7 @@ we recommend **Ubuntu 20.04 LTS**.
opensuse-tumbleweed
oracle-linux-8
raspberry-pi-os-10
+ raspberry-pi-os-11
rhel-8
rocky-linux-8
ubuntu-1804
diff --git a/docs/install_guides/raspberry-pi-os-10.rst b/docs/install_guides/raspberry-pi-os-10.rst
index c8fc40750..c1337fe76 100644
--- a/docs/install_guides/raspberry-pi-os-10.rst
+++ b/docs/install_guides/raspberry-pi-os-10.rst
@@ -1,8 +1,28 @@
.. _install-raspberry-pi-os-10:
-=================================
-Installing Red on Raspberry Pi OS
-=================================
+====================================================
+Installing Red on Raspberry Pi OS (Legacy) 10 Buster
+====================================================
+
+.. note::
+
+ While we do provide support and install instructions for running Red
+ on Raspberry Pi OS (Legacy) 10 Buster, we highly recommend installing/upgrading to
+ the new version - Raspberry Pi OS 11 Bullseye.
+
+ If you're not sure what version you are using,
+ you can check your version of Raspberry Pi OS by running:
+
+ .. prompt:: bash
+
+ lsb_release -a
+
+ If you're running Bullseye already, read `install-raspberry-pi-os-11` document instead.
+
+ If you're using Buster, please consider upgrading to Bullseye if possible.
+ You can read
+ `the post about Bullseye release from Raspberry Pi Foundation `__
+ to learn how you can install/upgrade to the new version.
.. include:: _includes/linux-preamble.rst
diff --git a/docs/install_guides/raspberry-pi-os-11.rst b/docs/install_guides/raspberry-pi-os-11.rst
new file mode 100644
index 000000000..92f4eaac0
--- /dev/null
+++ b/docs/install_guides/raspberry-pi-os-11.rst
@@ -0,0 +1,40 @@
+.. _install-raspberry-pi-os-11:
+
+=============================================
+Installing Red on Raspberry Pi OS 11 Bullseye
+=============================================
+
+.. note::
+
+ This guide can only be used with Raspberry Pi OS 11 Bullseye,
+ it will not work with any older (e.g. Raspberry Pi OS 10 Buster)
+ or newer (e.g. Raspberry Pi OS 12 Bookworm) releases.
+ You can check your version of Raspberry Pi OS by running:
+
+ .. prompt:: bash
+
+ lsb_release -a
+
+ If you're not running Bullseye, you should read
+ `the post about Bullseye release from Raspberry Pi Foundation `__
+ to learn how you can install/upgrade to the new version.
+
+.. include:: _includes/linux-preamble.rst
+
+-------------------------------
+Installing the pre-requirements
+-------------------------------
+
+Raspberry Pi OS "Bullseye" has all required packages available in official repositories. Install them
+with apt:
+
+.. prompt:: bash
+
+ sudo apt update
+ sudo apt -y install python3 python3-dev python3-venv python3-pip git openjdk-11-jre-headless build-essential nano
+
+.. Include common instructions:
+
+.. include:: _includes/create-env-with-venv.rst
+
+.. include:: _includes/install-and-setup-red-unix.rst
diff --git a/docs/version_guarantees.rst b/docs/version_guarantees.rst
index fabdc1024..40e960cd5 100644
--- a/docs/version_guarantees.rst
+++ b/docs/version_guarantees.rst
@@ -30,34 +30,35 @@ their end-of-life date.
We recommend to always use the latest OS version supported by Red.
-========================= ============================================================
-Operating system version Ideally supported until
-========================= ============================================================
-Windows 10 `End/Retirement Date `__
-Windows 11 `Retirement Date `__
-macOS 10.15 (Catalina) ~2022-10
-macOS 11 (Big Sur) ~2023-10
-macOS 12 (Monterey) ~2024-10
-Arch Linux forever (support is only provided for an up-to-date system)
-CentOS 7 2024-06-30 (`end of Maintenance Updates `__)
-CentOS 8.4+ 2021-12-31 (`end of Maintenance Updates `__)
-CentOS Stream 8 2024-05-31 (`end of Maintenance Updates `__)
-Debian 10 Buster 2022-08-14 (`End of life `__)
-Debian 11 Bullseye ~2024-09 (`End of life `__)
-Fedora Linux 33 2021-11-16 (`End of Life `__)
-Fedora Linux 34 2022-05-17 (`End of Life `__)
-Fedora Linux 35 ~2022-11 (`End of Life `__)
-openSUSE Leap 15.2 2021-12-31 (`end of maintenance life cycle `__)
-openSUSE Leap 15.3 2022-11-30 (`end of maintenance life cycle `__)
-openSUSE Tumbleweed forever (support is only provided for an up-to-date system)
-Oracle Linux 8 2029-07-31 (`End of Premier Support `__)
-Raspberry Pi OS 10 **Unknown**
-RHEL 8.4 2023-05-30 (`End of Extended Update Support `__)
-Rocky Linux 8 2029-05-31 (`end-of-life `__)
-Ubuntu 18.04 LTS 2023-04-30 (`End of Standard Support `__)
-Ubuntu 20.04 LTS 2025-04-30 (`End of Standard Support `__)
-Ubuntu 21.10 2022-07-31 (`End of Standard Support `__)
-========================= ============================================================
+================================ ============================================================
+Operating system version Ideally supported until
+================================ ============================================================
+Windows 10 `End/Retirement Date `__
+Windows 11 `Retirement Date `__
+macOS 10.15 (Catalina) ~2022-10
+macOS 11 (Big Sur) ~2023-10
+macOS 12 (Monterey) ~2024-10
+Alma Linux 8 2029-05-31 (`How long will CloudLinux support AlmaLinux? `__)
+Arch Linux forever (support is only provided for an up-to-date system)
+CentOS 7 2024-06-30 (`end of Maintenance Updates `__)
+CentOS Stream 8 2024-05-31 (`end of Maintenance Updates `__)
+Debian 10 Buster 2022-08-14 (`End of life `__)
+Debian 11 Bullseye ~2024-09 (`End of life `__)
+Fedora Linux 34 2022-05-17 (`End of Life `__)
+Fedora Linux 35 ~2022-11 (`End of Life `__)
+openSUSE Leap 15.2 2021-12-31 (`end of maintenance life cycle `__)
+openSUSE Leap 15.3 2022-11-30 (`end of maintenance life cycle `__)
+openSUSE Tumbleweed forever (support is only provided for an up-to-date system)
+Oracle Linux 8 2029-07-31 (`End of Premier Support `__)
+Raspberry Pi OS (Legacy) 10 2022-08-14 (`End of life for Debian 10 `__)
+Raspberry Pi OS 11 ~2023-12 (approximate date of release of Raspberry Pi OS 12)
+RHEL 8 (latest) 2029-05-31 (`End of Maintenance Support `__)
+RHEL 8.4 2023-05-30 (`End of Extended Update Support `__)
+Rocky Linux 8 2029-05-31 (`end-of-life `__)
+Ubuntu 18.04 LTS 2023-04-30 (`End of Standard Support `__)
+Ubuntu 20.04 LTS 2025-04-30 (`End of Standard Support `__)
+Ubuntu 21.10 2022-07-31 (`End of Standard Support `__)
+================================ ============================================================
====================
Developer Guarantees