From e357d8678c47ab39e5dbcf5d5cdc0d4cfdd607e4 Mon Sep 17 00:00:00 2001
From: Cristian Calin <6627509+cristicalin@users.noreply.github.com>
Date: Fri, 14 May 2021 10:06:05 +0300
Subject: [PATCH] update README about supported OSes (#7608)

---
 README.md           |  2 ++
 docs/amazonlinux.md | 15 +++++++++++++++
 2 files changed, 17 insertions(+)
 create mode 100644 docs/amazonlinux.md

diff --git a/README.md b/README.md
index 2d5dc6168..133076304 100644
--- a/README.md
+++ b/README.md
@@ -122,6 +122,8 @@ vagrant up
 - **Fedora CoreOS** (experimental: see [fcos Note](docs/fcos.md))
 - **openSUSE** Leap 15.x/Tumbleweed
 - **Oracle Linux** 7, 8 (experimental: [centos 8 notes](docs/centos8.md) apply)
+- **Alma Linux** 8 (experimental: [centos 8 notes](docs/centos8.md) apply)
+- **Amazon Linux 2** (experimental: see [amazon linux notes](docs/amazonlinux.md)
 
 Note: Upstart/SysV init based OS types are not supported.
 
diff --git a/docs/amazonlinux.md b/docs/amazonlinux.md
new file mode 100644
index 000000000..a411e9c98
--- /dev/null
+++ b/docs/amazonlinux.md
@@ -0,0 +1,15 @@
+# Amazon Linux 2
+
+Amazon Linux is supported with docker,containerd and cri-o runtimes.
+
+**Note:** that Amazon Linux is not currently covered in kubespray CI and
+support for it is currently considered experimental.
+
+Amazon Linux 2, while derrived from the Redhat OS family, does not keep in
+sync with RHEL upstream like CentOS/AlmaLinux/Oracle Linux. In order to use
+Amazon Linux as the ansible host for your kubespray deployments you need to
+manually install `python3` and deploy ansible and kubespray dependencies in
+a python virtual environment or use the official kubespray containers.
+
+There are no special considerations for using Amazon Linux as the target OS
+for Kubespray deployments.