You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/aks/stop-api-upgrade.md
+9-28Lines changed: 9 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,16 +43,20 @@ After receiving the error message, you have two options:
43
43
- Remove usage on your end and wait 12 hours for the current record to expire.
44
44
- Bypass the validation to ignore API changes.
45
45
46
-
##Fail fast on minor version manual upgrades in AKS
46
+
### Remove usage on API breaking changes
47
47
48
-
When manually updating a minor Kubernetes version, checks will be run to detect API breaking changes. If you attempt an upgrade and the checks detect usage on a deprecated API in the goal version, you can either remove usage on your end or bypass the validation to ignore API changes.
48
+
Remove usage on API breaking changes using the following steps:
49
49
50
-
### Remove usage on API breaking changes
50
+
1. Remove the deprecated API, which is listed in the error message.
51
+
2. Wait 12 hours for the current record to expire.
52
+
3. Retry your cluster upgrade.
53
+
54
+
### Bypass validation to ignore API changes
51
55
52
-
To remove usage on API breaking changes, update the `"properties":` block of `Microsoft.ContainerService/ManagedClusters``PUT` operation with the following settings:
56
+
To bypass validation to ignore API breaking changes, update the `"properties":` block of `Microsoft.ContainerService/ManagedClusters``PUT` operation with the following settings:
53
57
54
58
> [!NOTE]
55
-
> The date and time you specify for `"until"` has to be in the future. `Z` stands for timezone. The following example is in GMT.
59
+
> The date and time you specify for `"until"` has to be in the future. `Z` stands for timezone. The following example is in GMT. For more information, see [Combined date and time representations](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
56
60
57
61
```
58
62
{
@@ -69,28 +73,6 @@ To remove usage on API breaking changes, update the `"properties":` block of `Mi
69
73
}
70
74
```
71
75
72
-
After updating the properties, you must wait 12 hours for the current record to expire.
73
-
74
-
### Bypass validation to ignore API changes
75
-
76
-
To override fail fast on control plane minor version manual upgrades in AKS, use the [`az aks upgrade`][az-aks-upgrade] command with the `--ignore-api-changes` parameter.
77
-
78
-
```azurecli
79
-
az aks upgrade --resource-group myResourceGroup --name myAKSCluster --kubernetes_version KUBERNETES_VERSION --ignore-api-changes
80
-
```
81
-
82
-
To override *after* fail fast, use the [`az aks upgrade`][az-aks-upgrade] command.
83
-
84
-
```azurecli
85
-
az aks upgrade --resource-group myResourceGroup --name myAKSCluster --kubernetes_version KUBERNETES_VERSION
86
-
```
87
-
88
-
You'll receive a message prompting you to choose whether you want to proceed with the API breaking changes. This message will look similar to the following example message:
89
-
90
-
```azurecli
91
-
We detected the following API breaking changes in your service, do you wish to proceed Y/N?
92
-
```
93
-
94
76
## Next steps
95
77
96
78
In this article, you learned how to stop cluster upgrades on API breaking changes in AKS. To learn more about AKS cluster upgrades, see:
@@ -101,4 +83,3 @@ In this article, you learned how to stop cluster upgrades on API breaking change
0 commit comments