Azure / azure-cli

Azure Command-Line Interface
MIT License
4.01k stars 2.98k forks source link

Customer feedback | az webapp deploy | clarify `--acr-use-identity` parameter being enabled or disabled vs true or false #29759

Open dbradish-microsoft opened 2 months ago

dbradish-microsoft commented 2 months ago

Describe the bug

This GitHub issue is being moved from UUF 292320.

Summary

As this UUF does not provide the reference command, I'm guessing that the customer confusion is coming from az webapp deploy which has an --acr-use-identity parameter.

Engineering request

  1. Add information about the default property on all boolean parameter types in this command group.
  2. Add more complex examples to az webapp deploy. There are 15 parameters and only 2 examples. Please see the published reference guidelines for Azure CLI examples. For example, Provide at least one example for every parameter. A single example can use multiple parameters, but a parameter that doesn't appear within an example code block often shows no usage statistics in Azure CLI reporting..

Link to az webapp deploy


Customer feedback from UUF

Repo:

azure-docs-cli

Title: az webapp | Microsoft Learn

Verbatim: --acr-use-identityEnable or disable pull image from acr use managed identity.Default value: FalseIt says, default false, so its assumd that you can set it to true or false, but that is not possible. So the default value should perhaps be "disabled" instead of false?"

Verbatim Id: 680c1345-7650-ef11-a317-000d3a59d4e9

Triaged By: v-lmanohar@microsoft.com

Triaged Comment:

Live URL: https://learn.microsoft.com/en-us/cli/azure/webapp

GitHub URL: https://github.com/MicrosoftDocs/azure-docs-cli/blob/live/2017-03-09-profile/docs-ref-autogen/webapp.yml

Related command

az webapp deploy

Errors

n/a

Issue script & Debug output

n/a

Expected behavior

n/a

Environment Summary

Based on the creation of the UUF work item, this customer is using Azure CLI 2.62.0, 2017-03-09-profile

Additional context

No response

yonzhan commented 2 months ago

Thank you for opening this issue, we will look into it.

microsoft-github-policy-service[bot] commented 2 months ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @AzureAppServiceCLI, @antcp.

btardif commented 2 months ago

@tulikac can you take a look?