diff --git a/azure-cli-conceptual/TOC.md b/azure-cli-conceptual/TOC.md index 06913f7..f9ae42d 100644 --- a/azure-cli-conceptual/TOC.md +++ b/azure-cli-conceptual/TOC.md @@ -1 +1,2 @@ -# [Index](index.md) \ No newline at end of file +# [Index](index.md) +## [Old and new CLIs](old-and-new-clis.md) diff --git a/azure-cli-conceptual/index.md b/azure-cli-conceptual/index.md index 1a8a2d2..5bef9f0 100644 --- a/azure-cli-conceptual/index.md +++ b/azure-cli-conceptual/index.md @@ -1 +1,99 @@ -# Welcome to azure-cli-conceptual! \ No newline at end of file +--- +title: Get started with Azure 2.0 CLI Preview +description: Get started with Azure 2.0 CLI Preview on Linux, Mac, or Windows. +keywords: Azure CLI 2.0, Linux, Mac, Windows, OS X, Ubuntu, Debian, CentOS, RHEL, SUSE, CoreOS, Docker, Windows, Python, PIP +author: allclark +manager: douge +ms.date: 11/14/2016 +ms.topic: article +ms.prod: azure +ms.technology: azure +ms.assetid: 85c418a8-6177-4833-bb8d-ff4ce2233c1a +--- + +# Get started with Azure 2.0 CLI Preview + +1. [Install Azure CLI 2.0 Preview](https://github.com/Azure/azure-cli/blob/master/doc/preview_install_guide.md) +on whatever platform you use. + +2. Run `az` with no arguments to verify the installation. You should get a page like this: + + ``` + Welcome to the cool new Azure CLI! + + Here are the base commands: + + account : Manages stored and default subscriptions. + acs : Manage Azure container services. + ad : Synchronize on-premises directories and manage Azure Active Directory (AAD) + resources. + cloud : Manage the Azure clouds registered. + component: Manages and updates Azure CLI components. + configure: Interactive experience for setting up the Azure CLI. + context : Manage contexts. + feedback : Loving or hating the CLI? Let us know! + login : Log in to access Azure subscriptions. + logout : Log out to remove accesses to Azure subscriptions. + network : Manages Network resources. + provider : Manage resource providers. + resource : Generic commands to manage Azure resources. + role : Use role assignments to manage access to your Azure resources. + storage : Durable, highly available, and massively scalable cloud storage. + tag : Manage resource tags. + vm : Provision Linux and Windows virtual machines in minutes. + vmss : Create highly available, auto-scalable Linux or Windows virtual machines. + ``` + +3. Run the login command. + + ```azurecli + az login + ``` + + You'll be prompted to open https://aka.ms/devicelogin and enter a code. + +4. Use a web browser to open the page https://aka.ms/devicelogin and enter the code to authenticate. + + You'll be prompted to log in using your credentials. + +5. Login in. + + Now you can run any command that accesses your account. + +Here are some other things to try: + +- Create a resource group + + ```azurecli + az resource group create -l westus -n MyRG + ``` + +- Create a VM + + ```azurecli + az vm create -g MyRG -n MyVM --admin-username admin --admin-password Password@1234 + ``` + +- Look at more [samples](https://github.com/Azure/azure-cli-samples). + +- Get help. + + ```azurecli + az [command-group [command]] -h + ``` + + For example, to get see what commands and subgroups are available for VMs, use + + ```azurecli + az vm -h + ``` + + To get help with the command to create a VM, use + + ```azurecli + az vm create -h + ``` + +- Read the [API reference docs](https://docs.microsoft.com/cli/azure). + +- Send us your feedback using `az feedback`. \ No newline at end of file diff --git a/azure-cli-conceptual/old-and-new-clis.md b/azure-cli-conceptual/old-and-new-clis.md new file mode 100644 index 0000000..34ad061 --- /dev/null +++ b/azure-cli-conceptual/old-and-new-clis.md @@ -0,0 +1,52 @@ +--- +title: Old and new Azure CLIs +description: There is a new CLI for Azure - Azure CLI 2.0 Preview. How do the old and new CLIs compare? +keywords: Azure CLI 2.0, Linux, Mac, Windows, OS X, Ubuntu, Debian, CentOS, RHEL, SUSE, CoreOS, Docker, Windows, Python, PIP +author: allclark +manager: douge +ms.date: 11/14/2016 +ms.topic: article +ms.prod: azure +ms.technology: azure +ms.assetid: 80ae9f6c-adb7-483c-bfb4-fbb958e075ba +--- + +# Old and new Azure CLIs + +With the continued growth of Azure, we’ve seen a lot of customers using our command-line tools, +particularly the Windows PowerShell tools and our Azure command-line interface (CLI). +We’ve received a lot of feedback on the great productivity provided by command-line tools, +but have also heard, especially from customers working with Linux, +about our current CLI and its poor integration with popular Linux command-line tools +and difficulties with installing and maintaining the Node environment (on which it was based). + +Based on this feedback - along with the growth in the Azure Resource Manager-based configuration model - +we improved the CLI experience and now provide a great experience for Azure. +We’re calling it the Azure CLI 2.0 Preview, now available as a beta on [GitHub](http://github.com/azure/azure-cli). + +As we set out to develop our next generation of command-line tools, we quickly settled on some guiding principles: +- **It must be natural and easy to install:** + Regardless of your platform, our CLI should be installed from where you expect it, + be it from “brew install azure-cli” on a MacBook, or from “apt-get install azure-cli” for BASH on Windows (coming soon). +- **It must be consistent with POSIX tools:** + Success with command-line tools is the result of the ease and predictability + that comes with the implementation of well-understood standards. +- **It must be part of the open source ecosystem:** + The value of open source comes from the community and the amazing features and integrations they develop, + from DevOps (Chef, Ansible) solutions to query languages (JMESPath). +- **It must be evergreen and current with Azure:** + In an age of continuous delivery, it's not enough to simply deploy a service. + We must have up-to-date tools that let our customers immediately take advantage of that service. + +As we applied these principles, we realized that the scope of improvements went beyond a few breaking changes, +and when combined with the feedback we’ve received about our old CLI, +it made sense to start from the ground up. +This choice allowed us to focus exclusively on the resource manager [deployment model](https://docs.microsoft.com/azure/resource-manager-deployment-model). + +So Azure CLI 2.0 Preview (az) is applicable when you use the resource manager deployment model. +When you use the service management deployment model, you need to contiunue to use Azure CLI (azure). +You can, of course, continue to use Azure CLI (azure) with the resource manager deployment model as you do today, +but we recommend you plan to switch to Azure CLI 2.0 Preview when you're able to do that. + +[Get started](index.md) with Azure CLI 2.0 Preview now. +