[DOCU-2329] Linux OS support and deprecation (#4000)

* create one topic for all supported and deprecated linux OSes * remove centos from 3.0 doc and set up redirect * add links to support tables; move deprecation notices to changelog; remove link blocks * remove unused 'os_version' * add note to install doc; fix typo * group linux distibutions into their own section * update smoke test
Kong · Aug 17, 2022 · 0477480 · 0477480
1 parent c3b25f3
commit 0477480
Show file tree

Hide file tree

Showing 15 changed files with 349 additions and 144 deletions.
diff --git a/app/_data/docs_nav_gateway_3.0.x.yml b/app/_data/docs_nav_gateway_3.0.x.yml
@@ -16,8 +16,9 @@ items:
 
   - title: Install and Run
     icon: /assets/images/icons/documentation/icn-deployment-color.svg
-    url: /install-and-run/
     items:
+      - text: Installation Options
+        url: /install-and-run/
       - text: Kubernetes
         url: /install-and-run/kubernetes
       - text: Helm
@@ -26,18 +27,20 @@ items:
         url: /install-and-run/openshift
       - text: Docker
         url: /install-and-run/docker
-      - text: Amazon Linux
-        url: /install-and-run/amazon-linux
-      - text: CentOS
-        url: /install-and-run/centos
+      - text: Linux
+        items:
+          - text: Supported Distributions
+            url: /install-and-run/os-support
+          - text: Amazon Linux
+            url: /install-and-run/amazon-linux
+          - text: Debian
+            url: /install-and-run/debian
+          - text: RHEL
+            url: /install-and-run/rhel
+          - text: Ubuntu
+            url: /install-and-run/ubuntu
       - text: macOS
         url: /install-and-run/macos
-      - text: Debian
-        url: /install-and-run/debian
-      - text: RHEL
-        url: /install-and-run/rhel
-      - text: Ubuntu
-        url: /install-and-run/ubuntu
       - text: Migrating from OSS to EE
         url: /install-and-run/migrate-ce-to-ke
       - text: Upgrade Kong Gateway

diff --git a/app/_data/tables/os_support.yml b/app/_data/tables/os_support.yml
@@ -0,0 +1,196 @@
+-
+  name: Amazon Linux 1
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: 2.8.x
+  oss: true
+  oss_versions:
+    first_version: 0.10.x
+    last_version: 2.8.x
+  status: deprecated
+  deprecation_date: December 31, 2020
+  eol_link: https://aws.amazon.com/blogs/aws/update-on-amazon-linux-ami-end-of-life
+-
+  name: Amazon Linux 2
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 2.0.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
+-
+  name: CentOS 6
+  enterprise: true
+  enterprise_versions:
+    first_version: null
+    last_version: 2.3.x
+  oss: true
+  oss_versions:
+    first_version: 0.10.x
+    last_version: 2.3.x
+  status: deprecated
+  deprecation_date: November 30, 2020
+  eol_link: https://endoflife.software/operating-systems/linux/centos
+-
+  name: CentOS 7
+  enterprise: true
+  enterprise_versions:
+    first_version: 2.1.x
+    last_version: 2.8.x
+  oss: true
+  oss_versions:
+    first_version: 0.10.x
+    last_version: 2.7.x
+  status: deprecated
+  deprecation_date: December 31, 2021
+  eol_link: https://www.centos.org/centos-linux-eol/
+
+-
+  name: CentOS 8
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: 2.8.x
+  oss: true
+  oss_versions:
+    first_version: 1.4.x
+    last_version: 2.7.x
+  status: deprecated
+  deprecation_date: December 31, 2021
+  eol_link: https://www.centos.org/centos-linux-eol/
+-
+  name: Debian 8 (Jessie)
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: 2.8.x
+  oss: true
+  oss_versions:
+    first_version: 0.2.x
+    last_version: 2.8.x
+  status: deprecated
+  deprecation_date: June 30th, 2020
+  eol_link: https://www.debian.org/News/2020/20200709
+-
+  name: Debian 9 (Stretch)
+  enterprise: true
+  enterprise_versions:
+    first_version: 2.1.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 0.11.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
+-
+  name: Debian 10 (Buster)
+  enterprise: true
+  enterprise_versions:
+    first_version: 2.7.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 1.4.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
+-
+  name: Debian 11 (Bullseye)
+  enterprise: true
+  enterprise_versions:
+    first_version: 2.7.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 1.4.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
+-
+  name: RHEL 6
+  enterprise: false
+  enterprise_versions:
+    first_version: null
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 0.14.x
+    last_version: 1.5.x
+  status: deprecated
+  deprecation_date: November 30, 2020
+  eol_link: https://access.redhat.com/support/policy/updates/errata
+-
+  name: RHEL 7
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 0.14.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
+-
+  name: RHEL 8
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 1.4.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
+-
+  name: Ubuntu 16.04 (Xenial)
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: 2.8.x
+  oss: true
+  oss_versions:
+    first_version: 0.10.x
+    last_version: 2.8.x
+  status: deprecated
+  deprecation_date: April 2021
+  eol_link: https://wiki.ubuntu.com/Releases
+-
+  name: Ubuntu 18.04 (Bionic)
+  enterprise: true
+  enterprise_versions:
+    first_version: 1.5.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 0.14.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
+-
+  name: Ubuntu 20.04 (Focal)
+  enterprise: true
+  enterprise_versions:
+    first_version: 2.1.x
+    last_version: null
+  oss: true
+  oss_versions:
+    first_version: 2.1.x
+    last_version: null
+  status: active
+  deprecation_date: null
+  eol_link: null
diff --git a/app/_redirects b/app/_redirects
@@ -1,3 +1,7 @@
+# DEPRECATED OS
+/gateway/3.0.x/install-and-run/centos    /gateway/latest/install-and-run/os-support
+/gateway/latest/install-and-run/centos   /gateway/latest/install-and-run/os-support
+
 # FREE TRIALS, GENERAL LICENSING
 /free-trial/guide/                    https://konghq.com/install
 /konnect-platform/plans/              https://konghq.com/pricing/

diff --git a/app/gateway/changelog.md b/app/gateway/changelog.md
@@ -3,6 +3,7 @@ title: Kong Gateway Changelog
 no_version: true
 ---
 
+<<<<<<< HEAD
 <!-- vale off -->
 
 ## 2.8.1.3
@@ -86,6 +87,37 @@ Kong Manager was constructing the wrong URL when retrieving Dev Portal assignees
   * Fixed an issue where `204` responses were not handled correctly and you would see the following error:
 `"No examples exist in API specification for this resource"`.
   * `204` response specs now support empty content elements.
+=======
+## 3.0.0.0
+**Release Date** TBD
+
+### Deprecated
+
+* **Amazon Linux 1**: Support for running Kong Gateway on Amazon Linux 1 is now deprecated, as the
+[Amazon Linux (1) AMI has ended standard support as of December 31, 2020](https://aws.amazon.com/blogs/aws/update-on-amazon-linux-ami-end-of-life).
+Starting with Kong Gateway 3.0.0.0, Kong is not building new Amazon Linux 1
+images or packages, and Kong will not test package installation on Amazon Linux 1.
+
+    If you need to install Kong Gateway on Amazon Linux 1, see the documentation for
+    [previous versions](/gateway/2.8.x/install-and-run/amazon-linux/).
+
+* **Debian 8**: Support for running Kong Gateway on Debian 8 ("Jessie") is now deprecated, as
+[Debian 8 ("Jessie") has reached End of Life (EOL)](https://www.debian.org/News/2020/20200709).
+Starting with Kong Gateway 3.0.0.0, Kong is not building new Debian 8
+("Jessie") images or packages, and Kong will not test package installation on
+Debian 8 ("Jessie").
+
+    If you need to install Kong Gateway on Debian 8 ("Jessie"), see the documentation for
+    [previous versions](/gateway/2.8.x/install-and-run/debian/).
+
+* **Ubuntu 16.04**: Support for running Kong Gateway on Ubuntu 16.04 ("Xenial") is now deprecated,
+as [Standard Support for Ubuntu 16.04 has ended as of April, 2021](https://wiki.ubuntu.com/Releases).
+Starting with Kong Gateway 3.0.0.0, Kong is not building new Ubuntu 16.04
+images or packages, and Kong will not test package installation on Ubuntu 16.04.
+
+    If you need to install Kong Gateway on Ubuntu 16.04, see the documentation for
+    [previous versions](/gateway/2.8.x/install-and-run/ubuntu/).
+>>>>>>> e077d05fc0 ([DOCU-2329] Linux OS support and deprecation (#4000))
 
 ## 2.8.1.1
 **Release Date** 2022/05/27

diff --git a/src/gateway/install-and-run/amazon-linux.md b/src/gateway/install-and-run/amazon-linux.md
@@ -2,34 +2,14 @@
 title: Install Kong Gateway on Amazon Linux
 ---
 
-{:.important}
-> **Deprecation notice**: Support for running Kong Gateway on
-Amazon Linux 1 is now deprecated, as [The Amazon Linux (1) AMI has ended standard support as of December 31, 2020](https://aws.amazon.com/blogs/aws/update-on-amazon-linux-ami-end-of-life).
-Starting with Kong Gateway 3.0.0.0, Kong is neither building new Amazon Linux 1 images nor packages. Nor will Kong test package installation on Amazon Linux 1.
-> If you need to install Kong Gateway on Amazon Linux 1, see the documentation for
-[previous versions](/gateway/2.8.x/install-and-run/amazon-linux/).
-
-<!-- Banner with links to latest downloads -->
-<!-- The install-link and install-listing-link classes are used for tracking, do not remove -->
-
-{:.install-banner}
-> Download the latest {{page.kong_version}} packages for
-> Amazon Linux:
-> * **Kong Gateway**: [**Amazon Linux 2**]({{site.links.download }}/gateway-2.x-amazonlinux-2/Packages/k/kong-enterprise-edition-{{page.kong_versions[page.version-index].ee-version}}.amzn2.noarch.rpm){:.install-link} (version {{page.kong_versions[page.version-index].ee-version}})
-> * **Kong Gateway (OSS)**: [**Amazon Linux 2**]({{ site.links.download }}/gateway-2.x-amazonlinux-2/Packages/k/kong-{{page.kong_versions[page.version-index].ce-version}}.aws.amd64.rpm){:.install-link} (version {{page.kong_versions[page.version-index].ce-version}})
-> <br><br>
->
-> <span class="install-subtitle">View the list of all 2.x packages for
-> [Amazon Linux 2]({{ site.links.download }}/gateway-2.x-amazonlinux-2/Packages/k/){:.install-listing-link}  </span>
-
 The {{site.base_gateway}} software is governed by the
 [Kong Software License Agreement](https://konghq.com/kongsoftwarelicense/).
 Kong is licensed under an
 [Apache 2.0 license](https://github.com/Kong/kong/blob/master/LICENSE).
 
 ## Prerequisites
 
-* A supported system with root or [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
+* A [supported system](/gateway/{{page.kong_version}}/install-and-run/os-support) with root or [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
 * (Enterprise only) A `license.json` file from Kong.
 
 ## Download and Install

diff --git a/src/gateway/install-and-run/centos.md b/src/gateway/install-and-run/centos.md
@@ -34,7 +34,7 @@ Kong is licensed under an
 
 ## Prerequisites
 
-* A supported system with root or [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
+* A [supported system](/gateway/{{page.kong_version}}/install-and-run/os-support) with root or [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
 * (Enterprise only) A `license.json` file from Kong.
 
 ## Download and Install

diff --git a/src/gateway/install-and-run/debian.md b/src/gateway/install-and-run/debian.md
@@ -2,45 +2,14 @@
 title: Install Kong Gateway on Debian
 ---
 
-{:.important}
-> **Deprecation notice**: Support for running Kong Gateway on
-Debian 8 ("Jessie") is now deprecated, as [Debian 8 ("Jessie") has reached End of Life (EOL)](https://www.debian.org/News/2020/20200709).
-Starting with Kong Gateway 3.0.0.0, Kong is neither building new Debian 8 ("Jessie") images nor packages. Nor will Kong test package installation on Debian 8 ("Jessie").
-> If you need to install Kong Gateway on Debian 8 ("Jessie"), see the documentation for
-[previous versions](/gateway/2.8.x/install-and-run/debian/).
-> <br><br>
-> Kong Gateway Enterprise subscriptions can still use Debian 8 ("Jessie") in 2.8, but support
-for Debian 8 ("Jessie") is planned to be removed in 3.0.
-
-{:.install-banner}
-> Download the latest {{page.kong_version}} package for Debian:
->
-> * **Kong Gateway**:
-> [**9 Stretch**]({{ site.links.download }}/gateway-2.x-debian-stretch/pool/all/k/kong-enterprise-edition/kong-enterprise-edition_{{page.kong_versions[page.version-index].ee-version}}_all.deb){:.install-link},
-> [**10 Buster**]({{ site.links.download }}/gateway-2.x-debian-buster/pool/all/k/kong-enterprise-edition/kong-enterprise-edition_{{page.kong_versions[page.version-index].ee-version}}_all.deb){:.install-link},
-> or [**11 Bullseye**]({{ site.links.download }}/gateway-2.x-debian-bullseye/pool/all/k/kong-enterprise-edition/kong-enterprise-edition_{{page.kong_versions[page.version-index].ee-version}}_all.deb){:.install-link}
-> (latest version: {{page.kong_versions[page.version-index].ee-version}})
-> * **Kong Gateway (OSS)**:
-> [**9 Stretch**]({{ site.links.download }}/gateway-2.x-debian-stretch/pool/all/k/kong/kong_{{page.kong_versions[page.version-index].ce-version}}_amd64.deb){:.install-link},
-> [**10 Buster**]({{ site.links.download }}/gateway-2.x-debian-buster/pool/all/k/kong/kong_{{page.kong_versions[page.version-index].ce-version}}_amd64.deb){:.install-link},
-> or [**11 Bullseye**]({{ site.links.download }}/gateway-2.x-debian-bullseye/pool/all/k/kong/kong_{{page.kong_versions[page.version-index].ce-version}}_amd64.deb){:.install-link}
-> (latest version: {{page.kong_versions[page.version-index].ce-version}})
->
-> <br>
-> <span class="install-subtitle">View the list of all 2.x packages for
-> [9 Stretch]({{ site.links.download }}/gateway-2.x-debian-stretch/pool/all/k/){:.install-listing-link},
-> [10 Buster]({{ site.links.download }}/gateway-2.x-debian-buster/pool/all/k/){:.install-listing-link}, or
-> [11 Bullseye]({{ site.links.download }}/gateway-2.x-debian-bullseye/pool/all/k/){:.install-listing-link}
->  </span>
-
 The {{site.base_gateway}} software is governed by the
 [Kong Software License Agreement](https://konghq.com/kongsoftwarelicense/).
 {{site.ce_product_name}} is licensed under an
 [Apache 2.0 license](https://github.com/Kong/kong/blob/master/LICENSE).
 
 ## Prerequisites
 
-* A supported system with root or [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
+* A [supported system](/gateway/{{page.kong_version}}/install-and-run/os-support) with root or [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
 * The following tools are installed:
   * [`curl`](https://curl.se/)
   * [`lsb-release`](https://packages.debian.org/lsb-release)