From af632df409b3305896d68787c2148241f6599088 Mon Sep 17 00:00:00 2001 From: sj-williams Date: Mon, 7 Oct 2024 16:21:26 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20update=20EKS=20upg?= =?UTF-8?q?rade=20template=20ticket?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../cloud-platform-k8s-upgrade-template.md | 64 +++++++++---------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/cloud-platform-k8s-upgrade-template.md b/.github/ISSUE_TEMPLATE/cloud-platform-k8s-upgrade-template.md index a2ab8d04..64b7fa80 100644 --- a/.github/ISSUE_TEMPLATE/cloud-platform-k8s-upgrade-template.md +++ b/.github/ISSUE_TEMPLATE/cloud-platform-k8s-upgrade-template.md @@ -1,22 +1,22 @@ --- -name: Cloud Platform Kubernetes Upgrade story -about: This template is for Cloud Platform team to create an epic ticket for kubernetes upgrades +name: Cloud Platform Kubernetes Upgrade Template ticket +about: This template is for Cloud Platform team to create an epic ticket for Kubernetes upgrades label: 'EPIC' --- ## Issue 1: -### Planning upgrade to EKS +### Planning upgrade to EKS -Go through the release notes of EKS 1.27 and create a plan to upgrade our clusters +Go through the release notes of EKS and create a plan to upgrade our clusters Things to consider: -Review changelog & release notes -EKS Module support at current version? -Are there any API deprecations & removals? (Check insights) +Review EKS / Kubernetes changelogs & release notes +EKS Module supported at target upgrade version? +Are there any API deprecations & removals? (Check EKS insights) Are there new components being added? What changes are being introduced to current components? -Are there changes to core infra of the CP required? i.e. Are all our current components compatible with ? +Are there changes to core infra of the CP required? i.e. Are all our current components compatible with ? Are there changes users need to make? Do we need to expand any of our smoke/integration testing? Create additional tickets needed for any findings specific to this upgrade @@ -25,8 +25,8 @@ Cluster upgrade Runbook: https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-cluster.html ## Issue 2: -### Update vpc-cni from to the version needed for current k8s version -Check for the latest supported addon version for the current kubernetes version and update the clusters +### Update vpc-cni to latest supported release for current EKS version +Check for the latest supported addon release for the current EKS version and update the clusters [Runbook link](https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-addons.html#listing-available-eks-upgrades) Production Clusters Checklist: @@ -43,8 +43,8 @@ See the [Amazon EKS add-ons](https://docs.aws.amazon.com/eks/latest/userguide/ek ## Issue 3: -### Update kube-proxy from to the version needed for current k8s version -Check for the latest supported addon version for the current kubernetes version and update the clusters +### Update kube-proxy to latest supported release for current EKS version +Check for the latest supported addon release for the current EKS version and update the clusters [Runbook link](https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-addons.html#listing-available-eks-upgrades) Production Clusters Checklist: @@ -61,8 +61,8 @@ See the [Amazon EKS add-ons](https://docs.aws.amazon.com/eks/latest/userguide/ek ## Issue 4: -### Update core-dns from to the version needed for current k8s version -Check for the latest supported addon version for the current kubernetes version and update the clusters +### Update core-dns to latest supported release for current EKS version +Check for the latest supported addon release for the current EKS version and update the clusters [Runbook link](https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-addons.html#listing-available-eks-upgrades) Production Clusters Checklist: @@ -78,17 +78,17 @@ See the [Amazon EKS add-ons](https://docs.aws.amazon.com/eks/latest/userguide/ek - [vpc-cni](https://docs.aws.amazon.com/eks/latest/userguide/managing-vpc-cni.html) ## Issue 5: -### Test EKS on test cluster +### Test EKS on test cluster Follow instructions from Upgrade runbook: https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-cluster.html#upgrade-eks-cluster ## Issue 6: -### Test EKS on live-like cluster +### Test EKS on live-like cluster Follow instructions from creating a live like cluster runbook: https://runbooks.cloud-platform.service.justice.gov.uk/creating-a-live-like.html#creating-a-live-like-cluster ## Issue 7: -### EKS: Upgrade Production clusters to Kubernetes +### EKS: Upgrade Production clusters to Kubernetes https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-cluster.html Production Clusters Checklist: @@ -98,8 +98,8 @@ Production Clusters Checklist: - [ ] live ## Issue 8: -### Update vpc-cni from to the version needed for the upgraded k8s version -Check for the latest supported addon version for the upgraded kubernetes version and update the clusters +### Update vpc-cni to latest supported release for upgraded EKS version +Check for the latest supported addon version for the upgraded EKS version and update the clusters [Runbook link](https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-addons.html#listing-available-eks-upgrades) Production Clusters Checklist: @@ -116,8 +116,8 @@ See the [Amazon EKS add-ons](https://docs.aws.amazon.com/eks/latest/userguide/ek ## Issue 9: -### Update kube-proxy from to the version needed for the upgraded k8s version -Check for the latest supported addon version for the upgraded kubernetes version and update the clusters +### Update kube-proxy to latest supported release for upgraded EKS version +Check for the latest supported addon version for the upgraded EKS version and update the clusters [Runbook link](https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-addons.html#listing-available-eks-upgrades) Production Clusters Checklist: @@ -134,8 +134,8 @@ See the [Amazon EKS add-ons](https://docs.aws.amazon.com/eks/latest/userguide/ek ## Issue 10: -### Update core-dns from to the version needed for the upgraded k8s version -Check for the latest supported addon version for the upgraded kubernetes version and update the clusters +### Update core-dns to latest supported release for upgraded EKS version +Check for the latest supported addon version for the upgraded EKS version and update the clusters [Runbook link](https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-addons.html#listing-available-eks-upgrades) Production Clusters Checklist: @@ -157,7 +157,7 @@ https://runbooks.cloud-platform.service.justice.gov.uk/container-images.html#con Review the compatibility matrix for all cluster components and verify if the image is compatible with the upgraded Kubernetes version ## Issue 12: -### Review and upgrade kube-state-metrics for the upgraded cluster version +### Review and upgrade kube-state-metrics for the upgraded EKS version https://runbooks.cloud-platform.service.justice.gov.uk/container-images.html#container-images-used-by-cluster-components https://github.com/kubernetes/kube-state-metrics?tab=readme-ov-file#compatibility-matrix @@ -165,24 +165,24 @@ https://github.com/kubernetes/kube-state-metrics?tab=readme-ov-file#compatibilit Review the compatibility matrix of kube-state-metrics and verify if the image is compatible with the upgraded Kubernetes version. If the version is a mismatch, check if the whole kube-prometheus-chart needs updating to get the default version of kube-state-metrics from the chart-> values. Otherwise, pin the kube-state-metrics image to match the Kubernetes version. ## Issue 13: -### Upgrade cluster autoscaler for k8s version -The Cloud Platform Cluster is in k8s version . Hence upgrade the cluster-autoscaler to match the k8s version. +### Upgrade cluster autoscaler for EKS version +The Cloud Platform EKS Cluster is in Kubernetes version . Hence upgrade the cluster-autoscaler to match the Kubernetes version. https://github.com/kubernetes/autoscaler/tree/master/charts/cluster-autoscaler https://github.com/ministryofjustice/cloud-platform-terraform-cluster-autoscaler ## Issue 14: -### Upgrade cluster descheduler for k8s version -The Cloud Platform Cluster is in k8s version . Hence upgrade the descheduler to match the k8s version. +### Upgrade cluster descheduler for EKS version +The Cloud Platform EKS Cluster is in Kubernetes version . Hence upgrade the descheduler to match the Kubernetes version. https://github.com/kubernetes-sigs/descheduler?tab=readme-ov-file#%EF%B8%8F--documentation-versions-by-release https://github.com/ministryofjustice/cloud-platform-terraform-descheduler ## Issue 15: -### Post k8s version Cleanup -Following upgrade from EKS , there will be a number of cleanup activities that need addressing: +### Post EKS version Cleanup +Following upgrade to EKS , there will be a number of cleanup activities that need addressing: -Update user guide / runbook references +Update user guide / runbook references to EKS version Update tools-image for kubectl version Update cloud-platform-cli for kubectl version Update concourse pipelines to use updated tools-image and cli @@ -193,7 +193,7 @@ Update concourse pipelines to use updated tools-image and cli Update the runbook for - any changes needed in the steps to perform the upgrade - any lessons learnt that could be useful for next upgrade -- any changes to the [upgrade issue template](https://github.com/ministryofjustice/cloud-platform/blob/main/.github/ISSUE_TEMPLATE/cloud-platform-k8s-upgrade-template.md) +- any changes to the [upgrade issue template](https://github.com/ministryofjustice/cloud-platform/blob/main/.github/ISSUE_TEMPLATE/cloud-platform-Kubernetes-upgrade-template.md) Cluster upgrade Runbook: https://runbooks.cloud-platform.service.justice.gov.uk/upgrade-eks-cluster.html