Skip to content

Commit fde0ab8

Browse files
author
Kaarthikeyan Subramanian
committed
API watch added
1 parent d6b7830 commit fde0ab8

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

articles/aks/upgrade-cluster.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,7 @@ All of the following criteria must be met in order for the stop to occur:
237237
* If performed via REST, the upgrade operation uses a preview API version of `2023-01-02-preview` or later.
238238
* If performed via Azure CLI, the `aks-preview` CLI extension 0.5.134 or later must be installed.
239239
* The last seen usage of deprecated APIs for the targeted version you're upgrading to must occur within 12 hours before the upgrade operation. AKS records usage hourly, so any usage of deprecated APIs within one hour isn't guaranteed to appear in the detection.
240+
* Even API usage that is actually watching for deprecated resources is covered here. Look at the [Verb][k8s-api] for the distinction.
240241

241242
### Mitigating stopped upgrade operations
242243

@@ -260,11 +261,11 @@ After receiving the error message, you have two options to mitigate the issue. Y
260261

261262
:::image type="content" source="./media/upgrade-cluster/applens-api-detection-inline.png" lightbox="./media/upgrade-cluster/applens-api-detection-full.png" alt-text="A screenshot of the Azure portal showing the 'Selected Kubernetes API deprecations' section.":::
262263

263-
3. Wait 12 hours from the time the last deprecated API usage was seen.
264+
3. Wait 12 hours from the time the last deprecated API usage was seen. Check the verb in the deprecated api usage to know if it is a [watch][k8s-api].
264265

265266
4. Retry your cluster upgrade.
266267

267-
You can also check past API usage by enabling [Container Insights][container-insights] and exploring kube audit logs.
268+
You can also check past API usage by enabling [Container Insights][container-insights] and exploring kube audit logs. Check the verb in the deprecated api usage to understand, if it is a [watch][k8s-api] use case.
268269

269270
### Bypass validation to ignore API changes
270271

@@ -353,5 +354,6 @@ This article showed you how to upgrade an existing AKS cluster. To learn more ab
353354
[release-tracker]: release-tracker.md
354355
[specific-nodepool]: node-image-upgrade.md#upgrade-a-specific-node-pool
355356
[k8s-deprecation]: https://kubernetes.io/blog/2022/11/18/upcoming-changes-in-kubernetes-1-26/#:~:text=A%20deprecated%20API%20is%20one%20that%20has%20been,point%20you%20must%20migrate%20to%20using%20the%20replacement
357+
[k8s-api]: https://kubernetes.io/docs/reference/using-api/api-concepts/
356358
[container-insights]:/azure/azure-monitor/containers/container-insights-log-query#resource-logs
357359
[support-policy-user-customizations-agent-nodes]: support-policies.md#user-customization-of-agent-nodes

0 commit comments

Comments
 (0)