Azure-docs: Add a "Supported Kubernetes versions" section

[mathieu-benoit]

Could we add a section "Supported Kubernetes versions" which will be the result of "az aks get-versions -l eastus" for example.
KubernetesVersion Upgrades
1.11.3 None available
1.11.2 1.11.3
1.10.8 1.11.2, 1.11.3
1.10.7 1.10.8, 1.11.2, 1.11.3
1.9.10 1.10.7, 1.10.8
1.9.9 1.9.10, 1.10.7, 1.10.8
1.8.15 1.9.9, 1.9.10
1.8.14 1.8.15, 1.9.9, 1.9.10
1.7.16 1.8.14, 1.8.15
1.7.15 1.7.16, 1.8.14, 1.8.15

This section will have to be updated each time a new k8s version is integrated in AKS. But we could have this information here without going through the Azure CLI or Azure portal. Thoughts?
Furthermore, since it's linked, it should be interesting as well to have the associated/current ACS-Engine version in this section.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: ec484163-5d73-af3a-3d7b-9e0d421d2824
• Version Independent ID: 42da7aed-a33d-e331-fb7f-4fb4b40e5813
• Content: Supported Kubernetes versions in Azure Kubernetes Service
• Content Source: articles/aks/supported-kubernetes-versions.md
• Service: container-service
• GitHub Login: @sauryadas
• Microsoft Alias: saudas

[mimckitt]

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

[jakaruna-MSFT]

@mathieu-benoit I think updating this page for each version changes may require more effort.
But having the information about the possible versions will be good.
We can also think about adding a FAQ to list the versions via CLI. We can add JMESPath queries to match a particular version also.
Linking with ACS-Engine version also looks like a good option.
Share your thoughts.

[jakaruna-MSFT]

I am assigning this issue to the content author to investigate further and update the document as appropriate.

[iainfoulds]

Adding the CLI command to obtain a list of available versions makes sense, but I'd caution against trying to document each major and minor version available. That becomes unfeasible to maintain given rolling updates to available versions and slight delays in those replicating across all supported regions.

acs-engine is slightly different and versions don't really have relevance on AKS, certainly not to the extent that a customer can pick a particular version.

@sauryadas I'd suggesting adding a command example that allows a customer to see what versions are currently available in their region, such as az aks get-versions --location eastus --output table. Can use the azurecli-interactive code block to allow the user to run this from the Cloud Shell within the doc.

[sauryadas]

The cli command sounds good to me

Sent from Outlook

---

From: Iain Foulds [e-mail]
Sent: Monday, October 15, 2018 12:48:33 PM
To: MicrosoftDocs/azure-docs
Cc: Saurya Das; Mention
Subject: Re: [MicrosoftDocs/azure-docs] Add a "Supported Kubernetes versions" section (#16804)

Adding the CLI command to obtain a list of available versions makes sense, but I'd caution against trying to document each major and minor version available. That becomes unfeasible to maintain given rolling updates to available versions and slight delays in those replicating across all supported regions.

acs-engine is slightly different and versions don't really have relevance on AKS, certainly not to the extent that a customer can pick a particular version.

@sauryadashttps://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fsauryadas&data=02%7C01%7Csaudas%40microsoft.com%7Caf3639b0405e47f8a79b08d632d730f4%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636752297167473544&sdata=r2%2Bu8NorMSJ7AuYnW9ab%2ByC%2B5maAWMhA0RdQma6u6e4%3D&reserved=0 I'd suggesting adding a command example that allows a customer to see what versions are currently available in their region, such as az aks get-versions --location eastus --output table. Can use the azurecli-interactive code block to allow the user to run this from the Cloud Shell within the doc.

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHubhttps://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FMicrosoftDocs%2Fazure-docs%2Fissues%2F16804%23issuecomment-429988643&data=02%7C01%7Csaudas%40microsoft.com%7Caf3639b0405e47f8a79b08d632d730f4%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636752297167473544&sdata=kx8feJyQWocSgalio2dv2iukcitFHGTlF6m8WYxmRqU%3D&reserved=0, or mute the threadhttps://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FAOrMb4V3PKIjfyy9whzPamO8wbOvnr9Yks5ulOZmgaJpZM4XbOC-&data=02%7C01%7Csaudas%40microsoft.com%7Caf3639b0405e47f8a79b08d632d730f4%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636752297167473544&sdata=k9i7N%2B%2B1TKnvYTnP5jt411nAKEpRgcPR37ZhLNZEsis%3D&reserved=0.

[iainfoulds]

I have created a PR to add the command to list available versions. This update should merge and publish tomorrow morning.

in-progress