Azure / Azure/azure-cli

Customer feedback | az aks create (both Core & Extensino) |

Open
#30,056 1 comment 0 reactions 0 assignees View on GitHub
act-observability-squad AKS Auto-Assign bug Service Attention
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

### Describe the bug

This GitHub issue is being moved from MicrosoftDocs/azure-docs-cli issue [#4659](https://github.com/MicrosoftDocs/azure-docs-cli/issues/4659) so the AKS service team can respond.

### Engineering request

1. Please update the `short-summary` description for `az aks create --service-principal` parameter and provide more information.
1. [Service principals](https://learn.microsoft.com/en-us/entra/identity-platform/app-objects-and-service-principals?tabs=browser#service-principal-object) can be `application` or `managed identity`. Don't assume the customer understands the difference and kindly state the type of SP this command is creating.
1. Consider providing a link to the Entra ID article [Service principal object](https://learn.microsoft.com/en-us/entra/identity-platform/app-objects-and-service-principals?tabs=browser#service-principal-object), and explaining that a [system assigned managed identity](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/overview#managed-identity-types) is a service principal of a special type.

*******************************

### Type of issue

Outdated article

### Feedback

regarding the parameter "--service-principal" the doc says that "If not specified, a new service principal is created and cached at $HOME/.azure/aksServicePrincipal.json to be used by subsequent az aks commands."

this is no longer the case if we create an aks cluster without specifying the parameter "--service-principal" it will use system managed identity instead of creating a SP and make cluster use it.

![image](https://github.com/user-attachments/assets/1764ca27-8b84-4b6f-be3b-fd254784c866)

### Page URL

https://learn.microsoft.com/en-us/cli/azure/aks?view=azure-cli-latest

### Content source URL

https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/aks.yml

### Related command

az aks create

### Errors

n/a

### Issue script & Debug output

n/a

### Expected behavior

n/a

### Environment Summary

Azure CLI 2.65.0

### Additional context

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.