From e0cb590a3f427a13f2c40abac8948382dfb8d01a Mon Sep 17 00:00:00 2001 From: Dmitry Tantsur Date: Wed, 3 Feb 2021 12:25:36 +0100 Subject: [PATCH] docs: explain OS support in terms of two tiers 1st tier are OS that we're pretty confident in, 2nd tier are supported OS that have some problems or are tested indirectly. Change-Id: I01d87177bc6137daa2616b34572303a4185ac914 --- doc/source/install/index.rst | 35 ++++++++++++++++++++++++++++------- 1 file changed, 28 insertions(+), 7 deletions(-) diff --git a/doc/source/install/index.rst b/doc/source/install/index.rst index fb5178372..bad3693d9 100644 --- a/doc/source/install/index.rst +++ b/doc/source/install/index.rst @@ -9,16 +9,37 @@ Introduction This document will guide you through installing the Bare Metal Service (ironic) using Bifrost. -Requirements -============ +Supported operating systems +=========================== -Supported operating systems: +1st tier support (fully tested in the CI, no known or potential issues): + +* CentOS Stream 8 +* Ubuntu 20.04 "Focal" +* Debian 9 "Buster" + +2nd tier support (limited testing or known issues): + +* Ubuntu 18.04 "Bionic" + + Tested in the Bifrost CI, but no longer tested in the ironic upstream CI. + +* RHEL 8 and regular CentOS 8 + + Only tested indirectly via CentOS Stream 8. + +* openSUSE Leap 15.2 + + Tested in the CI but has frequent issues. -* Ubuntu 18.04, 20.04 -* CentOS 8 Stream (normal CentOS 8 and RHEL 8 should work but are not tested) -* openSUSE Leap 15.2 (15.1 is supported but not recommended) * Fedora 32 (30 is supported but not recommended) -* Debian Buster + + Only the latest Fedora is tested in the CI. + +.. note:: + Operating systems evolve and so does the support for them, even on stable + branches. This especially concerns Fedora, which is evolving faster than + other distributions. Bifrost structure =================