[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 · 2003878 · 2003878
1 parent 219db45
commit 2003878
Show file tree

Hide file tree

Showing 11 changed files with 29 additions and 226 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/gateway/changelog.md b/app/gateway/changelog.md
@@ -3,91 +3,6 @@ title: Kong Gateway Changelog
 no_version: true
 ---
 
-<<<<<<< HEAD
-<!-- vale off -->
-
-## 2.8.1.3
-**Release Date** 2022/08/05
-
-### Features
-
-#### Enterprise
-
-* Added GCP integration support for the secrets manager. GCP is now available as a vault backend.
-
-#### Plugins
-
-* [AWS Lambda](/hub/kong-inc/aws-lambda/) (`aws-lambda`)
-   * Added support for cross-account lambda function invocation based on AWS roles.
-
-### Fixes
-
-#### Enterprise
-* Fixed an issue with excessive log file disk utilization on control planes.
-* Fixed an issue with keyring encryption, where keyring was not decrypting keys after a soft reload.
-* The router now detects static route collisions inside the current workspace, as well as with other workspaces.
-* When using a custom plugin in a hybrid mode deployment, the control plane now detects compatibility issues and stops sending the plugin configuration to data planes that can't use it. The control plane continues sending the custom plugin configuration to compatible data planes.
-* Optimized the Kong PDK function `kong.response.get_source()`.
-
-#### Kong Manager
-* Fixed an issue with admin creation.
-Previously, when an admin was created with no roles, the admin would have access to the first workspace listed alphabetically.
-* Fixed several issues with SNI listing.
-Previously, the SNI list was empty after sorting by the SSL certificate ID field. In 2.8.1.1, the SSL certificate ID field in the SNI list was empty.
-
-#### Plugins
-
-* [Mocking](/hub/kong-inc/mocking) (`mocking`)
-  * Fixed an issue where the plugin didn't accept empty values in examples.
-
-* [ACME](/hub/kong-inc/acme) (`acme`)
-  * The `domains` plugin parameter can now be left empty.
-  When `domains` is empty, all TLDs are allowed.
-  Previously, the parameter was labelled as optional, but leaving it empty meant that the plugin retrieved no certificates at all.
-
-* [Response Transformer Advanced](/hub/kong-inc/response-transformer-advanced/) (`response-transformer-advanced`)
-  * Fixed an issue with nested array parsing.
-
-* [Rate Limiting Advanced](/hub/kong-inc/rate-limiting-advanced) (`rate-limiting-advanced`)
-  * Fixed an issue with `cluster` strategy timestamp precision in Cassandra.
-
-## 2.8.1.2
-**Release Date** 2022/07/15
-
-### Fixes
-
-#### Enterprise
-
-* Fixed an issue in hybrid mode where, if a service was set to `enabled: false` and that service had a route with an enabled plugin, any new data planes would receive empty configuration.
-* Fixed a timer leak that occurred when `worker_consistency` was set to `eventual` in `kong.conf`.
-This issue caused timers to be exhausted and failed to start any other timers used by Kong Gateway, resulting in a `too many pending timers` error.
-* Fixed memory leaks coming from `lua-resty-lock`.
-
-#### Kong Manager and Dev Portal
-
-* Fixed an issue where Kong Manager did not display all Dev Portal developers in the organization.
-* Fixed an issue that prevented developer role assignments from displaying in Kong Manager.
-When viewing a role under the Permissions tab in the Dev Portal section, the list of developers wouldn't update when a new developer was added.
-Kong Manager was constructing the wrong URL when retrieving Dev Portal assignees.
-* Fixed empty string handling in Kong Manager. Previously, Kong Manager was handling empty strings as `""` instead of a null value.
-* Improved Kong Manager styling by fixing an issue where content didn't fit on object detail pages.
-* Fixed an issue that sometimes prevented clicking Kong Manager links and buttons in Safari.
-* Fixed an issue where users were being navigated to the object detail page after clicking on the "Copy ID" button from the object list.
-
-#### Plugins
-
-* [Rate Limiting](/hub/kong-inc/rate-limiting) (`rate-limiting`) and [Response Rate Limiting](/hub/kong-inc/response-ratelimiting) (`response-ratelimiting`)
-  * Fixed a PostgreSQL deadlock issue that occurred when the `cluster` policy was used with two or more metrics (for example, `second` and `day`.)
-
-* [HTTP Log](/hub/kong-inc/http-log) (`http-log`)
-  * Log output is now restricted to the workspace the plugin is running in. Previously,
-  the plugin could log requests from outside of its workspace.
-
-* [Mocking](/hub/kong-inc/mocking) (`mocking`)
-  * 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
 
@@ -117,7 +32,6 @@ 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)

diff --git a/src/gateway/install-and-run/docker.md b/src/gateway/install-and-run/docker.md
@@ -2,16 +2,6 @@
 title: Install Kong Gateway on Docker
 ---
 
-<!-- Banner with links to latest downloads -->
-<!-- The install-link and install-listing-link classes are used for tracking, do not remove -->
-
-{:.install-banner}
-> See the list of Docker tags and pull the Docker image:
-> * [**Kong Gateway**](https://hub.docker.com/r/kong/kong-gateway/tags){:.install-listing-link}
-> * [**Kong Gateway (OSS)**](https://hub.docker.com/_/kong){:.install-listing-link}
->
-> (latest {{site.base_gateway}} version: {{page.kong_versions[page.version-index].ee-version}})
-
 {{site.base_gateway}} supports both PostgreSQL 9.5+ and Cassandra 3.11.* as its
 datastore. This guide provides steps to configure PostgreSQL.
 
@@ -217,7 +207,7 @@ docker run -d --name kong-gateway \
     * [`KONG_ADMIN_GUI_URL`](/gateway/{{page.kong_version}}/reference/configuration/#admin_gui_url):
     (Enterprise only) The URL for accessing Kong Manager, preceded by a protocol
     (for example, `http://`).
-    * `KONG_LICENSE_DATA`: (Enterprise only) If you have a license file and have saved it 
+    * `KONG_LICENSE_DATA`: (Enterprise only) If you have a license file and have saved it
     as an environment variable, this parameter pulls the license from your environment.
 
 1. Verify your installation:
@@ -405,7 +395,7 @@ docker run -d --name kong-dbless \
     * [`KONG_ADMIN_GUI_URL`](/gateway/{{page.kong_version}}/reference/configuration/#admin_gui_url):
     (Enterprise only) The URL for accessing Kong Manager, preceded by a protocol
     (for example, `http://`).
-    * `KONG_LICENSE_DATA`: (Enterprise only) If you have a license file and have saved it 
+    * `KONG_LICENSE_DATA`: (Enterprise only) If you have a license file and have saved it
     as an environment variable, this parameter pulls the license from your environment.
 
 1. Verify that {{site.base_gateway}} is running:

diff --git a/src/gateway/install-and-run/index.md b/src/gateway/install-and-run/index.md
@@ -25,10 +25,12 @@ disable_image_expand: true
     <div class="install-text">OpenShift</div>
   </a>
 
+  {% if_version lte:2.8.x %}
   <a href="/gateway/{{page.kong_version}}/install-and-run/centos" class="docs-grid-install-block no-description">
     <img class="install-icon" src="https://doc-assets.konghq.com/install-logos/centos.gif" alt="" />
     <div class="install-text">CentOS</div>
   </a>
+  {% endif_version %}
 
   <a href="/gateway/{{page.kong_version}}/install-and-run/ubuntu" class="docs-grid-install-block no-description">
     <img class="install-icon" src="https://doc-assets.konghq.com/install-logos/ubuntu.png" alt="" />
@@ -59,6 +61,11 @@ disable_image_expand: true
   </a>
 </div>
 
+{:.note}
+> **Note**: For installation on a Linux OS, review the list of
+[supported and deprecated OSes](/gateway/{{page.kong_version}}/install-and-run/os-support)
+before installing {{site.base_gateway}}.
+
 ## Deployment options
 
 {% include_cached /md/gateway/deployment-options.md kong_version=page.kong_version %}

diff --git a/src/gateway/install-and-run/macos.md b/src/gateway/install-and-run/macos.md
@@ -2,21 +2,13 @@
 title: Install Kong Gateway on macOS
 badge: oss
 ---
-<!-- Banner with links to latest downloads -->
-<!-- The install-link and install-listing-link classes are used for tracking, do not remove -->
-
-{:.install-banner}
-> See the MacOS
-> [**Homebrew formula**]({{ site.repos.homebrew }}){:.install-listing-link}
->
-> (latest version: {{page.kong_versions[page.version-index].ce-version}})
 
 {{site.ce_product_name}} is licensed under an
 [Apache 2.0 license](https://github.com/Kong/kong/blob/master/LICENSE).
 
 ## Prerequisites
 
-You have a supported system with root or [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
+You have [root-equivalent](/gateway/{{page.kong_version}}/plan-and-deploy/kong-user) access.
 
 ## Download and install
 

diff --git a/src/gateway/install-and-run/rhel.md b/src/gateway/install-and-run/rhel.md
@@ -2,34 +2,14 @@
 title: Install Kong Gateway on RHEL
 ---
 
-<!-- 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}} package for RHEL:
-> * **Kong Gateway**:
-> [**RHEL 7**]({{ site.links.download }}/gateway-2.x-rhel-7/Packages/k/kong-enterprise-edition-{{page.kong_versions[page.version-index].ee-version}}.rhel7.noarch.rpm){:.install-link} or
-> [**RHEL 8**]({{ site.links.download }}/gateway-2.x-rhel-8/Packages/k/kong-enterprise-edition-{{page.kong_versions[page.version-index].ee-version}}.rhel8.noarch.rpm){:.install-link}
-> (latest version: {{page.kong_versions[page.version-index].ee-version}})
-> * **Kong Gateway (OSS)**:
-> [**RHEL 7**]({{ site.links.download }}/gateway-2.x-rhel-7/Packages/k/kong-{{page.kong_versions[page.version-index].ce-version}}.rhel7.amd64.rpm){:.install-link} or
-> [**RHEL 8**]({{ site.links.download }}/gateway-2.x-rhel-8/Packages/k/kong-{{page.kong_versions[page.version-index].ce-version}}.rhel8.amd64.rpm){:.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
-> [**RHEL 7**]({{ site.links.download }}/gateway-2.x-rhel-7/Packages/k/){:.install-listing-link} or
-> [**RHEL 8**]({{ site.links.download }}/gateway-2.x-rhel-8/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