Azure CLI installation and few CLI examples

Today we will see how easy Microsoft has made it to install azure CLI which is a Command Line Interface (CLI) tool that manages azure Cloud resources. In previous posts I explored the installation for the CLI software of both Oracle and AWS, I have to say that Azure CLI is by far the simplest to configure. As usual, this post will be followed by at least 2 more articles that will cover two ways of provisioning an azure vm (AZ CLI, terraform).

Requirement

Whether on windows or on Linux the basic installation pf Azure CLI will always require 2 elements:

Azure Free Tier account
Python 3.6.x,3.7.x or 3.8.x

I. Azure CLI Installation

Windows

1- Download and execute the following Az-Cli MSI installer(current version: 2.14.0) https://aka.ms/installazurecliwindows
2- Follow the on-screen instructions (the MSI installer is also used to upgrade existing installations) .
3- Run the version command to confirm that Azure CLI was installed correctly.

C:Userskosse> az --version
azure-cli                         2.14.0
core                              2.14.0
telemetry                          1.0.6
Python location 'C:Program Files (x86)Microsoft SDKsAzureCLI2python.exe'
Extensions directory 'C:Userskosse.azurecliextensions'
Python (Windows) 3.6.8 (tags/v3.6.8:3c6b436a57, Dec 23 2018, 23:31:17) [MSC v.1916 32 bit (Intel)]
... Your CLI is up-to-date. 

C:Userskosse> where az
 > C:Program Files (x86)Microsoft SDKsAzureCLI2wbinaz

Note: az command can run from either Windows Command Prompt or PowerShell.

Linux
There is either an all-in-one install command or a multi step and interactive mode install. I’ll focus on the simpler approach.
► Ubuntu

brokedba~$ curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash brokedba~$ az --version azure-cli 2.14.0 core 2.14.0 telemetry 1.0.6

Python location '/opt/az/bin/python3' Extensions directory '/home/brokedba/.azure/cliextensions' brokdba:~$ which az /usr/bin/az

► REDHAT, Fedora, CENTOS, OLinux


# RHEL/OL/CENTOS (7,8+), Fedora 24+  
# -- Import Microsoft Repo Key
[r@localhost]# sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

# -- Add Az Cli repo
[r@localhost]# sudo sh -c 'echo -e "[azure-cli] name=Azure CLI baseurl=https://packages.microsoft.com/yumrepos/azure-cli enabled=1 gpgcheck=1 gpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/azure-cli.repo'

# Install rpm package 
[r@localhost]# sudo yum install azure-cli

► REDHAT install including Python

##RHEL bundle install with python 3
curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

II. Sign in to Azure from AZ CLI

Once your Azure free Tier account is created and azure cli installed, you won’t need to gather any API key or other usually required credentials (as in OCI,AWS). All you need is run the below az login command, this will open a browser so you can sign in with your registered Microsoft account (additional login options are available here ).

brokedba~$ az login

This image has an empty alt attribute; its file name is azure_login.png

Once signed in, your web page will confirm that az cli is now configured accordingly .

This image has an empty alt attribute; its file name is az_login.png

The above steps are common across platform no matter on which OS you installed your Az cli
Now we can run az account command to verify the our new configuration

$ az account list    --- OR account show
{
  "environmentName": "AzureCloud",
  "homeTenantId": "6187922f-3371-xxxxx-xxxx-xxxxxxxxxxxx",
  "id": "4dc6d66a-f5c9-4f0e-8f01-8b46e413ea93",
  "isDefault": true,
  "managedByTenants": [],
  "name": "BrokeDBA",
  "state": "Enabled",
  "tenantId": "6187922f-3371-xxxx-xxxx-xxxxxxxxxxxx",   --> same as homeTenantId
  "user": {
    "name": "xxxxxx@outlook.com",
    "type": "user"
  }
}

That’s it , you are now ready to go with azure cli (for 30 days).

Using az configure you can configure basic or more complex parameters for az cli which will be stored in the below file

$ cat ~/.azure/config 
  [cloud]
  name = AzureCloud
  [core]
  output = table     --- possible values : json|jsonc|yaml|yamlc|tsv|table
  collect_telemetry = no
  cache_ttl = 10
  [logging]
  enable_log_file = no

III.Test your first API request

Few notions worth reminding before hitting the terminal with your favorite azure-cli requests :
A. Command structure : is based on the below components

$ az [group] [subgroup] [command][parameters]

Parameters:
Will be followed by their values, this is resource bound so it will always depend on the group & subgroup value in the
command.The value type can also vary (string, integer, JSON, list,…)

Result related parameters :
1- “––output[-o]” : will format Azure CLI output into Json(colored), yaml(colored), Table, or tsv (raw).
2- “––query” : Allows to pick the list of fields to return in the response. It can be used to do some filtering.

B. Query :
The –query option relies on JMSPath and its filtering is done at client side. The best way to learn is to fetch the output in Json then locate the node where your information resides.
– To demonstrate the principle, here’s an example based on the account info displayed earlier in this article

$ az account list -o json       ----> see original query further above 
...
# >> Display the user’s email 
$ az account list --query "[0].user.name" -o json
  "brokedba@outlook.com"

# Table output
$ az account list --query "[0].user.{email:name}" -o table
Email
--------------------
kosseila@outlook.com

Examples

There are few requests that you can run to practice with azure-cli. Below commands are good examples to start with.

list azure regions using list subcommand and –query option

$ az account list-locations --query "[].{DisplayName:displayName, Name:name}" -o table 
DisplayName          Name
-------------------  ------------------
East Asia            eastasia
Southeast Asia       southeastasia
Central US           centralus
East US              eastus
East US 2            eastus2
West US              westus
North Central US     northcentralus
South Central US     southcentralus
North Europe         northeurope
West Europe          westeurope
Japan West           japanwest
Japan East           japaneast
...

List the current vms in a specific resource group :

$ az vm list --resource-group brokedba --show-details  --query "[*].{VM:name, Size:hardwareProfile.vmSize, OS:storageProfile.osDisk.osType, State:powerState}"  --output table  

+-----------------------+-------------------+---------+-------------+
|      VM               |     Size          | OS      |   State     |
+-----------------------+-------------------+---------+-------------+
|   BrokeVM             | Standard_B1ls     |  Linux  |  VM running |
|   demoinstance        | Standard_D2s_v3   |  Linux  |  VM running |
+-----------------------+-------------------+---------+-------------+

List all blobs in a container:

$ az storage blob list -c mycontainer

Create a resource group then create a vm in that same group

$ az group create -l "eastus"  -n brokedba
$ az vm create --resource-group brokedba --name brokeVM --size Standard_B1ls --image UbuntuLTS --generate-ssh-keys    

-----------------------------------------
|           DescribeInstances           |
+----------+----------------------------+
|  AZ      |  us-east-1a                |
|  PrivIP  |  192.168.10.45             |
|  Rootdev |  /dev/sda1                 |
|  Subnet  |  subnet-08b49f9682c5da2b6  |
|  VPCID   |  vpc-096b461ebe9d06ff3     |
|  image   |  ami-01861c2f0a2adfdb7     |
+----------+----------------------------+

Note: you can also display most popular commands within the group which adds more context than the help command

$ az find "az vm" Finding examples... Get the details of a VM. (autogenerated) az vm show --name MyVm --resource-group MyResourceGroup

Aliases

Unlike in AWS CLI Azure leaves the choice to the users to create their own aliases using the alias extension (no predefined aliases). This could help shorten common queries like listing resource groups/running vms etc. You can quickly install it by running the below commands:

$ az extension add --name alias  
$ az extension list --output table

Experimental   Exten-Type  Name    Path                           Preview    Version
------------- ----------- ------  ------------------------------- ---------  -------
False          whl         alias   ~/.azure/cliextensions/alias  True       0.5.2

$ az alias create --name rg --command group
$ az alias list
  Alias Command
  ----- ---------
  rg     group

Escape characters

az-cli query blocks

In Linux

–>

value

query “..“

value

query ‘..‘

In Windows

value

query “..“

Example :
List vm sizes in eastus region with 4vcpus of type D (general compute) or E (memory optimized compute) sorted by RAM.

LINUX 
$ az vm list-sizes -l eastus --query "sort_by(@,&memoryInMb)[?numberOfCores == `4` && (contains(name,`_E4`) || contains(name,`_D4`))]"

OR
$ az vm list-sizes -l eastus –query 'sort_by(@,&memoryInMb)[?numberOfCores == `4` && (contains(name,`_E4`) || contains(name,`_D4`))]'
 
Name           NumberOfCores    DiskSizeInMb    ResceDiskSizeInM  MemoryInMb    MaxDataDisk
--------------  ------------- --------------  ------------------ ----------- -----------
Standard_D4s_v3           4                8               16384   1047552     32768
Standard_D4_v3            4                8               16384   1047552     102400
...
Standard_E4_v3            4                8                32768  1047552     102400

WINDOWS
$ az vm list-sizes -l eastus --query "sort_by(@,&memoryInMb)[?numberOfCores == `4` && (contains(name,`_E4`) || contains(name,`_D4`))]"

Conclusion:

In this tutorial we learned how to install and configure azure-cli which took 5 minutes. We also described the command syntax and tried few requests using az-cli.
Finally, feel free to consult Azure CLI Command Reference for more details and examples on az-cli requests.

Cheers.