From 49b244c5ef107e94005122101eee900cd491cb85 Mon Sep 17 00:00:00 2001 From: Nitish Kumar Date: Sat, 2 Jul 2022 01:14:55 +0530 Subject: [PATCH 1/4] Cluster not starting after Kubernetes 1.24 resolved --- .../en/docs/tasks/debug/debug-cluster/_index.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/content/en/docs/tasks/debug/debug-cluster/_index.md b/content/en/docs/tasks/debug/debug-cluster/_index.md index 29fb9a06ae71e..0c6682ce84cd0 100644 --- a/content/en/docs/tasks/debug/debug-cluster/_index.md +++ b/content/en/docs/tasks/debug/debug-cluster/_index.md @@ -14,7 +14,23 @@ problem you are experiencing. See the [application troubleshooting guide](/docs/tasks/debug/debug-application/) for tips on application debugging. You may also visit the [troubleshooting overview document](/docs/tasks/debug/) for more information. + Before upgrading to Kubernetes 1.24 , It is very important to go through [Urgent Upgrade Notes](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md#urgent-upgrade-notes). + +## Cluster not starting + +To start your cluster, Run the following command: + +```shell +kubelet --help | grep network-plugin +``` + +*Note: If you get the following error after upgrading to Kubernetes 1.24, go through the [Migrating from dockershim](https://kubernetes.io/docs/tasks/administer-cluster/migrating-from-dockershim/) page to get a better understanding on how to resolve this error.* + +```shell +Error: failed to parse kubelet flag: unknown flag: --network-plugin +``` + ## Listing your cluster From 493d084e30c0d1345738490dca9a80cc3be03658 Mon Sep 17 00:00:00 2001 From: Nitish Kumar Date: Mon, 4 Jul 2022 13:13:28 +0530 Subject: [PATCH 2/4] Improve troubleshooting guide for issues switching from docker Engine --- .../administer-cluster/cluster-upgrade.md | 2 ++ .../docs/tasks/debug/debug-cluster/_index.md | 21 +++++-------------- 2 files changed, 7 insertions(+), 16 deletions(-) diff --git a/content/en/docs/tasks/administer-cluster/cluster-upgrade.md b/content/en/docs/tasks/administer-cluster/cluster-upgrade.md index e3f9595d26bf1..2f3f0e0ff460e 100644 --- a/content/en/docs/tasks/administer-cluster/cluster-upgrade.md +++ b/content/en/docs/tasks/administer-cluster/cluster-upgrade.md @@ -27,6 +27,8 @@ the documentation for the version of Kubernetes that you plan to upgrade to. ## Upgrade approaches +Before upgrading to Kubernetes 1.24, please go through [Urgent Upgrade Notes](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md#urgent-upgrade-notes). + ### kubeadm {#upgrade-kubeadm} If your cluster was deployed using the `kubeadm` tool, refer to diff --git a/content/en/docs/tasks/debug/debug-cluster/_index.md b/content/en/docs/tasks/debug/debug-cluster/_index.md index 0c6682ce84cd0..4b6fa9c4b8980 100644 --- a/content/en/docs/tasks/debug/debug-cluster/_index.md +++ b/content/en/docs/tasks/debug/debug-cluster/_index.md @@ -14,23 +14,7 @@ problem you are experiencing. See the [application troubleshooting guide](/docs/tasks/debug/debug-application/) for tips on application debugging. You may also visit the [troubleshooting overview document](/docs/tasks/debug/) for more information. - Before upgrading to Kubernetes 1.24 , It is very important to go through [Urgent Upgrade Notes](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md#urgent-upgrade-notes). - -## Cluster not starting - -To start your cluster, Run the following command: - -```shell -kubelet --help | grep network-plugin -``` - -*Note: If you get the following error after upgrading to Kubernetes 1.24, go through the [Migrating from dockershim](https://kubernetes.io/docs/tasks/administer-cluster/migrating-from-dockershim/) page to get a better understanding on how to resolve this error.* - -```shell -Error: failed to parse kubelet flag: unknown flag: --network-plugin -``` - ## Listing your cluster @@ -329,7 +313,12 @@ This is an incomplete list of things that could go wrong, and how to adjust your - Action: applications (containers) designed to tolerate unexpected restarts - Mitigates: Node shutdown - Mitigates: Kubelet software fault + +### Things to note after dockershim migration +## {{< note >}} +*Note: If you get the following error after upgrading to Kubernetes 1.24, go through the [Migrating from dockershim](/docs/tasks/administer-cluster/migrating-from-dockershim/) guide to get a better understanding of how to resolve this error.* +## {{< note >}} ## {{% heading "whatsnext" %}} From d0ec0bd0ff5f31d7da87ad928bddd21e680c5382 Mon Sep 17 00:00:00 2001 From: NitishKumar06 Date: Sun, 1 Jan 2023 17:50:40 +0530 Subject: [PATCH 3/4] new changes applied --- content/en/docs/tasks/administer-cluster/cluster-upgrade.md | 2 +- content/en/docs/tasks/debug/debug-cluster/_index.md | 6 +++++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/content/en/docs/tasks/administer-cluster/cluster-upgrade.md b/content/en/docs/tasks/administer-cluster/cluster-upgrade.md index abccd2993284e..97088cfd0d29e 100644 --- a/content/en/docs/tasks/administer-cluster/cluster-upgrade.md +++ b/content/en/docs/tasks/administer-cluster/cluster-upgrade.md @@ -27,7 +27,7 @@ the documentation for the version of Kubernetes that you plan to upgrade to. ## Upgrade approaches -Before upgrading to Kubernetes 1.24, please go through [Urgent Upgrade Notes](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md#urgent-upgrade-notes). +please go through [Urgent Upgrade Notes](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md#urgent-upgrade-notes). ### kubeadm {#upgrade-kubeadm} diff --git a/content/en/docs/tasks/debug/debug-cluster/_index.md b/content/en/docs/tasks/debug/debug-cluster/_index.md index 4b6fa9c4b8980..7b93ad658aebf 100644 --- a/content/en/docs/tasks/debug/debug-cluster/_index.md +++ b/content/en/docs/tasks/debug/debug-cluster/_index.md @@ -317,7 +317,11 @@ This is an incomplete list of things that could go wrong, and how to adjust your ### Things to note after dockershim migration ## {{< note >}} -*Note: If you get the following error after upgrading to Kubernetes 1.24, go through the [Migrating from dockershim](/docs/tasks/administer-cluster/migrating-from-dockershim/) guide to get a better understanding of how to resolve this error.* +*Note: Due to change in CNI, the `kubelet` binary might not recognize `--network-plugin` flag even after passing to `kubelet` which leads to the following error: + +`Error: failed to parse kubelet flag: unknown flag: --network-plugin` + +If you get the following error, go through the [Migrating from dockershim](/docs/tasks/administer-cluster/migrating-from-dockershim/) guide to get a better understanding of how to resolve this error.* ## {{< note >}} ## {{% heading "whatsnext" %}} From 8187003dc05a48eda6f321b10028ecd86a1a70d6 Mon Sep 17 00:00:00 2001 From: NitishKumar06 Date: Wed, 8 Feb 2023 21:53:37 +0530 Subject: [PATCH 4/4] changes applied --- content/en/docs/tasks/administer-cluster/cluster-upgrade.md | 4 ---- content/en/docs/tasks/debug/debug-cluster/_index.md | 4 ++-- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/content/en/docs/tasks/administer-cluster/cluster-upgrade.md b/content/en/docs/tasks/administer-cluster/cluster-upgrade.md index 7bc715de79dde..491708c3f2f01 100644 --- a/content/en/docs/tasks/administer-cluster/cluster-upgrade.md +++ b/content/en/docs/tasks/administer-cluster/cluster-upgrade.md @@ -26,10 +26,6 @@ You must have an existing cluster. This page is about upgrading from Kubernetes is not currently running Kubernetes {{< skew currentVersionAddMinor -1 >}} then please check the documentation for the version of Kubernetes that you plan to upgrade to. -## Upgrade approaches - -please go through [Urgent Upgrade Notes](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md#urgent-upgrade-notes). - ### kubeadm {#upgrade-kubeadm} If your cluster was deployed using the `kubeadm` tool, refer to diff --git a/content/en/docs/tasks/debug/debug-cluster/_index.md b/content/en/docs/tasks/debug/debug-cluster/_index.md index 5d15c1b3b4ba9..898ab24691677 100644 --- a/content/en/docs/tasks/debug/debug-cluster/_index.md +++ b/content/en/docs/tasks/debug/debug-cluster/_index.md @@ -317,11 +317,11 @@ This is an incomplete list of things that could go wrong, and how to adjust your ### Things to note after dockershim migration ## {{< note >}} -*Note: Due to change in CNI, the `kubelet` binary might not recognize `--network-plugin` flag even after passing to `kubelet` which leads to the following error: +*Note: Starting 1.24, since management of the CNI is no longer in scope for kubelet, the `--network-plugin` command line parameter has been removed from the binary and will throw the following error, if used: `Error: failed to parse kubelet flag: unknown flag: --network-plugin` -If you get the following error, go through the [Migrating from dockershim](/docs/tasks/administer-cluster/migrating-from-dockershim/) guide to get a better understanding of how to resolve this error.* +To understand how to resolve this error, go through the [Migrating from dockershim](/docs/tasks/administer-cluster/migrating-from-dockershim/) guide. ## {{< note >}} ## {{% heading "whatsnext" %}}