Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Merged
merged 7 commits into from
Jun 16, 2022
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions app/_data/docs_nav_gateway_3.0.x.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,18 +26,18 @@ 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: macOS
url: /install-and-run/macos
- 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: Supported Linux OSes
lena-larionova marked this conversation as resolved.
Show resolved Hide resolved
url: /install-and-run/os-support
- text: Migrating from OSS to EE
url: /install-and-run/migrate-ce-to-ke
- text: Upgrade Kong Gateway
Expand Down
196 changes: 196 additions & 0 deletions app/_data/tables/os_support.yml
Original file line number Diff line number Diff line change
@@ -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
4 changes: 4 additions & 0 deletions app/_redirects
Original file line number Diff line number Diff line change
@@ -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/
Expand Down
29 changes: 29 additions & 0 deletions app/gateway/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,35 @@ title: Kong Gateway Changelog
no_version: true
---

## 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
lena-larionova marked this conversation as resolved.
Show resolved Hide resolved
[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/).

## 2.8.1.0
**Release Date** 2022/04/07
Expand Down
22 changes: 1 addition & 21 deletions src/gateway/install-and-run/amazon-linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion src/gateway/install-and-run/centos.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
33 changes: 1 addition & 32 deletions src/gateway/install-and-run/debian.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
14 changes: 2 additions & 12 deletions src/gateway/install-and-run/docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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:
Expand Down Expand Up @@ -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:
Expand Down
Loading