[pve-devel] [PATCH docs] pct: add section for supported distributions

[Thomas Lamprecht]

On 13.10.21 12:59, Oguz Bektas wrote:
> adds a simple section with a list of officially supported templates
> 
> Signed-off-by: Oguz Bektas <o.bektas at proxmox.com>
> ---
>  pct.adoc | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++-----
>  1 file changed, 70 insertions(+), 6 deletions(-)
> 
> diff --git a/pct.adoc b/pct.adoc
> index d01e6d7..1415f67 100644
> --- a/pct.adoc
> +++ b/pct.adoc
> @@ -84,13 +84,77 @@ Technology Overview
>  
>  * Modern Linux kernels
>  
> -* Image based deployment (templates)
> +* Image based deployment (xref:pct_supported_distributions[templates])
>  
>  * Uses {pve} xref:chapter_storage[storage library]
>  
>  * Container setup from host (network, DNS, storage, etc.)
>  
>  
> +[[pct_supported_distributions]]
> +Supported Distributions
> +~~~~~~~~~~~~~~~~~~~~~~~
> +
> +List of officially supported distributions can be found below.
> +
> +Templates for the following distributions are available through our
> +repositories. You can use xref:pct_container_images[pveam] tool or the
> +Graphical User Interface to download them.
> +
> +Alma Linux
> +^^^^^^^^^^
> +* Almalinux 8
> +

I'd throw Alma and Rocky into the section with CentOS, i.e.

CentOS, AlmaLinux, Rocky Linux
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

(AlmaLinux is spelled without a space)

> +Alpine Linux
> +^^^^^^^^^^^^

Can we add a small sentence describing the distro in short to readers and linking
to the project page here and for the other distro sections?

E.g., the quote from the alpine linux site:

"Alpine Linux is a security-oriented, lightweight Linux distribution based on musl libc and busybox."
-- https://alpinelinux.org/

> +* Alpine 3.12
> +* Alpine 3.13
> +* Alpine 3.14


Hmm, I'd maybe avoid the list of exact release, tends to be outdated to fast
for some.

Maybe we can link to the respective upstream release pages?

E.g.,
- https://alpinelinux.org/releases/
- https://wiki.ubuntu.com/Releases
- https://fedoraproject.org/wiki/Releases
- ...

> +
> +Archlinux
> +^^^^^^^^^
> +* Archlinux Base (20210420)
> +
> +CentOS
> +^^^^^^
> +* CentOS 7
> +* CentOS 8
> +
> +Debian
> +^^^^^^
> +* Debian 10 (Buster)
> +* Debian 11 (Bullseye)
> +
> +Devuan
> +^^^^^^
> +* Devuan 3.0
> +
> +Fedora
> +^^^^^^
> +* Fedora 33
> +* Fedora 34
> +
> +Gentoo
> +^^^^^^
> +* Gentoo Current (20200310)
> +
> +OpenSUSE
> +^^^^^^^^
> +* OpenSUSE 15.3
> +
> +Rocky Linux
> +^^^^^^^^^^^
> +* Rocky Linux 8
> +
> +Ubuntu
> +^^^^^^
> +* Ubuntu 16.04 (Xenial Xerus)
> +* Ubuntu 18.04 (Bionic Beaver)
> +* Ubuntu 20.04 (Focal Fossa)
> +* Ubuntu 21.04 (Hirsute Hippo)
> +* Ubuntu 21.10 (Impish Indri)
> +
> +
>  [[pct_container_images]]
>  Container Images
>  ----------------
> @@ -98,11 +162,11 @@ Container Images
>  Container images, sometimes also referred to as ``templates'' or
>  ``appliances'', are `tar` archives which contain everything to run a container.
>  
> -{pve} itself provides a variety of basic templates for the most common Linux
> -distributions. They can be downloaded using the GUI or the `pveam` (short for
> -{pve} Appliance Manager) command line utility.
> -Additionally, https://www.turnkeylinux.org/[TurnKey Linux] container templates
> -are also available to download.
> +{pve} itself provides a variety of basic templates for the
> +xref:pct_supported_distributions[most common Linuxdistributions].  They can be

"Linux distributions" needs a space in-between I'd figure?

> +downloaded using the GUI or the `pveam` (short for {pve} Appliance Manager)
> +command line utility.  Additionally, https://www.turnkeylinux.org/[TurnKey
> +Linux] container templates are also available to download.
>  
>  The list of available templates is updated daily through the 'pve-daily-update'
>  timer. You can also trigger an update manually by executing:
>