diff --git a/docs/operations/images.md b/docs/operations/images.md index 25ca0a5b76..15dd74facb 100644 --- a/docs/operations/images.md +++ b/docs/operations/images.md @@ -36,18 +36,18 @@ The following table provides the support status for various distros with regards | Distro | Experimental | Stable | Deprecated | Removed | | ------------ | -----------: | -----: | ---------: | ------: | | [Amazon Linux 2](#amazon-linux-2) | 1.10 | 1.18 | - | - | -| [CentOS 7](#centos-7) | - | 1.5 | - | - | -| [CentOS 8](#centos-8) | 1.15 | - | - | - | -| [CoreOS](#coreos) | 1.6 | 1.9 | 1.17 | 1.18 | -| [Debian 8](#debian-8-jessie) | - | 1.5 | 1.17 | 1.18 | -| [Debian 9](#debian-9-stretch) | 1.8 | 1.10 | - | - | +| [CentOS 7](#centos-7) | - | 1.5 | 1.21 | - | +| [CentOS 8](#centos-8) | 1.15 | - | 1.21 | - | +| CoreOS | 1.6 | 1.9 | 1.17 | 1.18 | +| Debian 8 | - | 1.5 | 1.17 | 1.18 | +| [Debian 9](#debian-9-stretch) | 1.8 | 1.10 | 1.21 | - | | [Debian 10](#debian-10-buster) | 1.13 | 1.17 | - | - | | [Flatcar](#flatcar) | 1.15.1 | 1.17 | - | - | | [Kope.io](#kopeio) | - | - | 1.18 | - | -| [RHEL 7](#rhel-7) | - | 1.5 | - | - | +| [RHEL 7](#rhel-7) | - | 1.5 | 1.21 | - | | [RHEL 8](#rhel-8) | 1.15 | 1.18 | - | - | -| [Ubuntu 16.04](#ubuntu-1604-xenial) | 1.5 | 1.10 | 1.17 | 1.20 | -| [Ubuntu 18.04](#ubuntu-1804-bionic) | 1.10 | 1.16 | - | - | +| Ubuntu 16.04 | 1.5 | 1.10 | 1.17 | 1.20 | +| [Ubuntu 18.04](#ubuntu-1804-bionic) | 1.10 | 1.16 | 1.21 | - | | [Ubuntu 20.04](#ubuntu-2004-focal) | 1.16.2 | 1.18 | - | - | ## Supported Distros @@ -67,55 +67,6 @@ aws ec2 describe-images --region us-east-1 --output table \ --filters "Name=name,Values=amzn2-ami-hvm-2*-x86_64-gp2" ``` -### CentOS 7 - -CentOS 7 is based on Kernel version **3.10** which has a considerable number of known bugs that affect it and may be noticed in production clusters: - -* [kubernetes/kubernetes#56903](https://github.com/kubernetes/kubernetes/issues/56903) -* [kubernetes/kubernetes#67577](https://github.com/kubernetes/kubernetes/issues/67577) - -The minimum supported version is **7.4**. Available images can be listed using: - -```bash -aws ec2 describe-images --region us-east-1 --output table \ - --owners 125523088429 \ - --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ - --filters "Name=name,Values=CentOS 7.*x86_64" -``` - -### CentOS 8 - -CentOS 8 is based on Kernel version **4.18** which fixes some of the bugs present in RHEL/CentOS 7 and effects are less visible. - -One notable change is the addition of `iptables` NFT, which is the only iptables backend available. This may not be supported by some CNI plugins and should be used with care. - -Available images can be listed using: - -```bash -aws ec2 describe-images --region us-east-1 --output table \ - --owners 125523088429 \ - --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ - --filters "Name=name,Values=CentOS 8.*x86_64" -``` - -### Debian 9 (Stretch) - -Debian 9 is based on Kernel version **4.9** which has a number of known bugs that affect it and which may be noticed with larger clusters: - -This release is **EOL**, which means that the Debian Security Team no longer handles security fixes. That is now the responsibility/purview of the LTS team, which is a group of volunteers who are paid by donations to Debian LTS. - -* [kubernetes/kubernetes#56903](https://github.com/kubernetes/kubernetes/issues/56903) -* [kubernetes/kubernetes#67577](https://github.com/kubernetes/kubernetes/issues/67577) - -Available images can be listed using: - -```bash -aws ec2 describe-images --region us-east-1 --output table \ - --owners 379101102735 \ - --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ - --filters "Name=name,Values=debian-stretch-hvm-x86_64-gp2-*" -``` - ### Debian 10 (Buster) Debian 10 is based on Kernel version **4.19** which fixes some of the bugs present in Debian 9 and effects are less visible. @@ -156,6 +107,93 @@ aws ec2 describe-images --region us-east-1 --output table \ --filters "Name=name,Values=Flatcar-stable-*-hvm" ``` +### RHEL 8 + +RHEL 8 is based on Kernel version **4.18** which fixes some of the bugs present in RHEL/CentOS 7 and effects are less visible. + +One notable change is the addition of `iptables` NFT, which is the only iptables backend available. This may not be supported by some CNI plugins and should be used with care. + +Available images can be listed using: + +```bash +aws ec2 describe-images --region us-east-1 --output table \ + --owners 309956199498 \ + --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ + --filters "Name=name,Values=RHEL-8.*x86_64*" +``` + +### Ubuntu 20.04 (Focal) + +Ubuntu 20.04 is based on Kernel version **5.4** which fixes all the known major Kernel bugs. + +Available images can be listed using: + +```bash +aws ec2 describe-images --region us-east-1 --output table \ + --owners 099720109477 \ + --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ + --filters "Name=name,Values=ubuntu/images/hvm-ssd/ubuntu-focal-20.04-amd64-*" +``` + +## Deprecated Distros + +### CentOS 7 + +CentOS 7 is based on Kernel version **3.10** which has a considerable number of known bugs that affect it and may be noticed in production clusters: + +* [kubernetes/kubernetes#56903](https://github.com/kubernetes/kubernetes/issues/56903) +* [kubernetes/kubernetes#67577](https://github.com/kubernetes/kubernetes/issues/67577) + +The minimum supported version is **7.4**. Available images can be listed using: + +```bash +aws ec2 describe-images --region us-east-1 --output table \ + --owners 125523088429 \ + --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ + --filters "Name=name,Values=CentOS 7.*x86_64" +``` + +### CentOS 8 + +CentOS 8 has announced its End Of Life is December 31, 2021. + +CentOS 8 is based on Kernel version **4.18** which fixes some of the bugs present in RHEL/CentOS 7 and effects are less visible. + +One notable change is the addition of `iptables` NFT, which is the only iptables backend available. This may not be supported by some CNI plugins and should be used with care. + +Available images can be listed using: + +```bash +aws ec2 describe-images --region us-east-1 --output table \ + --owners 125523088429 \ + --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ + --filters "Name=name,Values=CentOS 8.*x86_64" +``` + +### Debian 9 (Stretch) + +Debian 9 is based on Kernel version **4.9** which has a number of known bugs that affect it and which may be noticed with larger clusters: + +This release is **EOL**, which means that the Debian Security Team no longer handles security fixes. That is now the responsibility/purview of the LTS team, which is a group of volunteers who are paid by donations to Debian LTS. + +* [kubernetes/kubernetes#56903](https://github.com/kubernetes/kubernetes/issues/56903) +* [kubernetes/kubernetes#67577](https://github.com/kubernetes/kubernetes/issues/67577) + +Available images can be listed using: + +```bash +aws ec2 describe-images --region us-east-1 --output table \ + --owners 379101102735 \ + --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ + --filters "Name=name,Values=debian-stretch-hvm-x86_64-gp2-*" +``` + +### Kope.io + +Support for _kope.io_ images is deprecated. These images were the default until Kubernetes 1.18, when they were replaced by the [official Ubuntu 20.04](#ubuntu-2004-focal) images. + +The _kope.io_ images were based on [Debian 9 (Stretch)](#debian-9-stretch) and had all packages required by kOps pre-installed. Other than that, the changes to the official Debian images were [minimal](https://github.com/kubernetes-sigs/image-builder/blob/master/images/kube-deploy/imagebuilder/templates/1.18-stretch.yml#L174-L198). + ### RHEL 7 RHEL 7 is based on Kernel version **3.10** which has a considerable number of known bugs that affect it and may be noticed in production clusters: @@ -172,21 +210,6 @@ aws ec2 describe-images --region us-east-1 --output table \ --filters "Name=name,Values=RHEL-7.*x86_64*" ``` -### RHEL 8 - -RHEL 8 is based on Kernel version **4.18** which fixes some of the bugs present in RHEL/CentOS 7 and effects are less visible. - -One notable change is the addition of `iptables` NFT, which is the only iptables backend available. This may not be supported by some CNI plugins and should be used with care. - -Available images can be listed using: - -```bash -aws ec2 describe-images --region us-east-1 --output table \ - --owners 309956199498 \ - --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ - --filters "Name=name,Values=RHEL-8.*x86_64*" -``` - ### Ubuntu 18.04 (Bionic) Ubuntu 18.04 is based on Kernel version **4.15** which has a number of known bugs that affect it and which may be noticed with larger clusters: @@ -203,41 +226,6 @@ aws ec2 describe-images --region us-east-1 --output table \ --filters "Name=name,Values=ubuntu/images/hvm-ssd/ubuntu-bionic-18.04-amd64-*" ``` -### Ubuntu 20.04 (Focal) - -Ubuntu 20.04 is based on Kernel version **5.4** which fixes all the known major Kernel bugs. - -Available images can be listed using: - -```bash -aws ec2 describe-images --region us-east-1 --output table \ - --owners 099720109477 \ - --query "sort_by(Images, &CreationDate)[*].[CreationDate,Name,ImageId]" \ - --filters "Name=name,Values=ubuntu/images/hvm-ssd/ubuntu-focal-20.04-amd64-*" -``` - -## Deprecated Distros - -### CoreOS - -Support for CoreOS was removed in kOps 1.18. - -You should consider using [Flatcar](#flatcar) as a replacement. - -### Debian 8 (Jessie) - -Support for Debian 8 (Jessie) was removed in kOps 1.18. - -### Kope.io - -Support for _kope.io_ images is deprecated. These images were the default until Kubernetes 1.18, when they were replaced by the [official Ubuntu 20.04](#ubuntu-2004-focal) images. - -The _kope.io_ images were based on [Debian 9 (Stretch)](#debian-9-stretch) and had all packages required by kOps pre-installed. Other than that, the changes to the official Debian images were [minimal](https://github.com/kubernetes-sigs/image-builder/blob/master/images/kube-deploy/imagebuilder/templates/1.18-stretch.yml#L174-L198). - -### Ubuntu 16.04 (Xenial) - -Support for Ubuntu 16.04 (Xenial) is deprecated and will be removed in kOps 1.20. - ## Owner aliases kOps supports owner aliases for the official accounts of supported distros: diff --git a/docs/releases/1.21-NOTES.md b/docs/releases/1.21-NOTES.md index d40f572540..201598367a 100644 --- a/docs/releases/1.21-NOTES.md +++ b/docs/releases/1.21-NOTES.md @@ -44,10 +44,20 @@ See the [warm pool](https://kops.sigs.k8s.io/instance_groups/#warmpool-aws-only) # Deprecations -* Support for Kubernetes versions 1.15 and 1.16 are deprecated and will be removed in kOps 1.22. +* Support for Kubernetes versions 1.15 and 1.16 is deprecated and will be removed in kOps 1.22. * Support for Kubernetes version 1.17 is deprecated and will be removed in kOps 1.23. +* Support for CentOS 7 is deprecated and will be removed in future versions of kOps. + +* Support for CentOS 8 is deprecated and will be removed in future versions of kOps. + +* Support for Debian 9 (Stretch) is deprecated and will be removed in future versions of kOps. + +* Support for RHEL 7 is deprecated and will be removed in future versions of kOps. + +* Support for Ubuntu 18.04 (Bionic) is deprecated and will be removed in future versions of kOps. + * The legacy location for downloads `s3://https://kubeupv2.s3.amazonaws.com/kops/` has been deprecated and will not be used as of kOps 1.22. The new canonical downloads location is `https://artifacts.k8s.io/binaries/kops/`. * The [manifest based metrics server addon](https://github.com/kubernetes/kops/tree/master/addons/metrics-server) has been deprecated in favour of a configurable addon. diff --git a/docs/releases/1.22-NOTES.md b/docs/releases/1.22-NOTES.md index f6f95e7eef..1ff131defa 100644 --- a/docs/releases/1.22-NOTES.md +++ b/docs/releases/1.22-NOTES.md @@ -36,6 +36,16 @@ This change only affects dedicated API server nodes and worker nodes. It does no * Support for Kubernetes version 1.18 is deprecated and will be removed in kOps 1.24. +* Support for CentOS 7 is deprecated and will be removed in future versions of kOps. + +* Support for CentOS 8 is deprecated and will be removed in future versions of kOps. + +* Support for Debian 9 (Stretch) is deprecated and will be removed in future versions of kOps. + +* Support for RHEL 7 is deprecated and will be removed in future versions of kOps. + +* Support for Ubuntu 18.04 (Bionic) is deprecated and will be removed in future versions of kOps. + * The [manifest based metrics server addon](https://github.com/kubernetes/kops/tree/master/addons/metrics-server) has been deprecated in favour of a configurable addon. * The [manifest based cluster autoscaler addon](https://github.com/kubernetes/kops/tree/master/addons/cluster-autoscaler) has been deprecated in favour of a configurable addon.