azure-xplat-cli icon indicating copy to clipboard operation
azure-xplat-cli copied to clipboard

`azure` or `az` ?

Open dluc opened this issue 8 years ago • 10 comments

There are 2 Azure CLI, azure 0.10.11 (this project) and az 2.0.2, and both are cross-platform (either via nodejs or python). I just noticed that the instructions to install azure are redirecting to the instruction to install az, so perhaps az is the official tool?

https://azure.microsoft.com/en-us/documentation/articles/xplat-cli-install (azure)

redirects to

https://docs.microsoft.com/en-us/cli/azure/install-azure-cli (az)

As far I could see azure seems to have a more comprehensive list of options, for instance while working with Azure IoT Hub, azure provides all the options to customize a deployment. However, the URL redirection above is pointing users to az. Should I raise feature requests on az if I notice that something is missing (e.g. the IoT options)?

Could you provide some indications on which tool to adopt, and which one is the way forward?

On a side note, the list of pre-compiled installers is out of date, pointing to 0.10.9.

Thanks!

dluc avatar Apr 07 '17 00:04 dluc

@dluc - Thanks for filing an issue. Sorry for the confusion. az (is the new python based CLI). It will replace this project in the near future as far as ARM (Version 2 of the Azure APIs) is concerned. This project will continue to be used for talking to ASM (Version 1 of the Azure APIs).

If you have any feature requests or if you see any commands that are present in this project and do not see in the new python based azure-cli then please file an issue over there. The team will do the needful to help you accordingly.

amarzavery avatar Apr 08 '17 05:04 amarzavery

Looks like the issue has been fixed. It may have been a CDN issue or some one updated the links. Now both the links point to the new python cli

amarzavery avatar Apr 08 '17 05:04 amarzavery

@amarzavery I'm not sure what you mean, the links already pointed to the Python CLI.

I think the first link should point to the instructions to install the NPM based instead. The link URL is confusing people in my opinion, because it contains "xpat-cli" like this project name.

dluc avatar Apr 11 '17 18:04 dluc

rather than giving you a 404 on the link

https://azure.microsoft.com/en-us/documentation/articles/xplat-cli-install

They are redirecting it to the newer CLI. They want customers to use the new CLI and not the old one.

amarzavery avatar Apr 11 '17 21:04 amarzavery

FYI there are printed books out there, explaining how to use azure and pointing to that URL. Users will find themselves in a page with instructions for a different tool, and wonder what is wrong.

If I can suggest a better alternative, I would use an informational notice, to prepare users before the redirection. It's pretty common to have a note on deprecated tools, inviting users to adopt the new tool.

dluc avatar Apr 11 '17 22:04 dluc

That is a good point. Will let the team know about it.

amarzavery avatar Apr 12 '17 02:04 amarzavery

Azure CLI 2.0 does not work for classic VM (ASM). It leaves us unsupported if we have created VMs in classic mode.

kumarkshiva avatar Jun 13 '17 01:06 kumarkshiva

@kumarkshiva - For ASM you need to use CLI 1.0. Azure CLI 2.0 works only for ARM. /cc @mayurid @yugangw-msft

amarzavery avatar Jun 14 '17 15:06 amarzavery

This is a bummer to hear. For node developers getting this tool through npm is greatly preferred over downloading some external python script, it doesn't seem like a good choice to deprecate this tool and build a whole different one in python. I like that this can be installed locally instead of globally and the python version doesn't even install for me on windows, so its pretty frustrating to read this.

justinmchase avatar Oct 03 '17 16:10 justinmchase

For CLI 2.0, installation via many of the native platform package tools is supported. https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest

tjprescott avatar Oct 03 '17 16:10 tjprescott