Skip to content

Commit 9348ba1

Browse files
committed
add FAQ for apparent ASO API version mismatches
1 parent 1c6a5d3 commit 9348ba1

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

docs/book/src/topics/FAQ.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,3 +34,16 @@ feature and its benefits.
3434
4. **Collaborate with the Community:** Engage with and receive updates from other contributors and maintainers through our [Slack channel](https://kubernetes.slack.com/messages/CEX9HENG7) or
3535
[mailing lists](https://groups.google.com/forum/#!forum/kubernetes-sig-cluster-lifecycle) to gather support and feedback for Feature X.
3636
By actively participating, you can enhance CAPZ's functionalilty and ensure it meets the needs of the Kubernetes community on Azure.
37+
38+
## CAPZ creates a newer API version of an ASO resource, but kubectl shows me an older API version. Did the API version change?
39+
No, because the API version is not an integral property of Kubernetes resources. The same resource can be
40+
represented by several different API versions:
41+
https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-groups-and-versioning
42+
43+
ASO's versioning scheme isn't compatible with Kubernetes's assumptions about API versions w.r.t. `kubectl`'s
44+
default version selection, so you'll usually end up seeing an older version than you might have used to create
45+
the resource if you do a plain `kubectl get managedcluster` vs. specifying the version explicitly like
46+
`kubectl get managedclusters.v1api20240402preview.containerservice.azure.com`.
47+
48+
There is an open issue with ASO to smooth this out so the newest Azure API version is selected by default:
49+
https://github.com/Azure/azure-service-operator/issues/4147 for more context.

0 commit comments

Comments
 (0)