Azure AKS reference documentation for "addonProfiles" is missing

[aheumaier]

Azure AKS reference documentation for "addonProfiles" is missing .

Instead of "addonProfiles": {} it is expected to note at least the portal enabled features like :

        "addonProfiles": {
          "httpApplicationRouting": {
            "enabled": bool
          }

[mimckitt]

Thanks for the feedback! We are currently investigating and will update you shortly.

[mimckitt]

@aheumaier I have assigned the issue to the content author to investigate further and update the document as appropriate.

[tfitzmac]

@mmacy - do you know someone who can verify if the swagger file needs to be changed? It looks like the REST reference has the same empty object.

[mmacy]

@tfitzmac Swagger is OK, it's a publishing bug. This is a known issue, currently tracked in ICM:

Sev 2: Id 73589353: AKS REST content is not generating from the defined swagger definintions

...and in CSI VSTS work item 1292854.

Cc: @aheumaier @iainfoulds

[mmacy]

@tfitzmac Hey Tom, this is now rendering in the REST reference as a separate object:

https://docs.microsoft.com/rest/api/aks/managedclusters/createorupdate#managedclusteraddonprofile

Should this now be rendering differently in the template ref?

[tfitzmac]

The template ref generation process still does not include that object, but I added it manually.

[tfitzmac]

#please-close

[4c74356b41]

@tfitzmac you kidding me or something. this is a documentation on addons: https://github.com/Azure/acs-engine/blob/master/docs/clusterdefinition.md#addons. what you got published doesnt help. how do I find the list of possible addons? why dont you provide a value for the addon?

[tdihp]

the list of possible add-on is still not available.

[XBeg9]

2yrs and I still can't find addonProfile definitions

[shackit]

Oh wow! I have just said exactly the same thing on Azure/AKS#2047 . I cannot understand why such information is hidden.

[tfitzmac]

@shackit - can you create an issue in the REST API specification? It looks like the spec doesn't include those definitions.

[jusnitlive]

bumping this -- there is a quickstart template published with 6/9 of the available add-ons. this should be documented somewhere...
https://github.com/Azure/azure-quickstart-templates/blob/master/demos/aks-nat-agic/azuredeploy.json
https://learn.microsoft.com/en-us/azure/aks/integrations#available-add-ons

[psyrus]

Ironically... the most comprehensive list so far was the list I found while trying to contact support to ask where the addonProfiles were documented....

Ironic much?

[neilmca-inc]

I'm here looking for list right now - how is this closed?! Re-open please

[sebnyberg]

@tfitzmac Docs are still missing descriptions of the addon profiles. Please re-open this issue.

[tfitzmac]

The available properties and descriptions are defined in the REST API specification. Please open an issue in https://github.com/Azure/azure-rest-api-specs

[ghost]

For a reference of the valid addonProfile options for Managed Clusters I had to dig into the deployment code Hope this helps others

EDIT: Added link to relevant issue