Quickstart for Bash in Azure Cloud Shell

This document details how to use Bash in Azure Cloud Shell in the Azure portal.

Note

A PowerShell in Azure Cloud Shell Quickstart is also available.

Start Cloud Shell

  1. Launch Cloud Shell from the top navigation of the Azure portal.

  2. Select a subscription to create a storage account and Microsoft Azure Files share.

  3. Select "Create storage"

Tip

You are automatically authenticated for Azure CLI 2.0 in every session.

Select the Bash environment

Check that the environment drop-down from the left-hand side of shell window says Bash.

Set your subscription

  1. List subscriptions you have access to.

    az account list
    
  2. Set your preferred subscription:

    az account set --subscription my-subscription-name`
    

Tip

Your subscription will be remembered for future sessions using /home/<user>/.azure/azureProfile.json.

Create a resource group

Create a new resource group in WestUS named "MyRG".

az group create --location westus --name MyRG

Create a Linux VM

Create an Ubuntu VM in your new resource group. The Azure CLI 2.0 will create SSH keys and set up the VM with them.

az vm create -n myVM -g MyRG --image UbuntuLTS --generate-ssh-keys

Note

Using --generate-ssh-keys instructs Azure CLI 2.0 to create and set up public and private keys in your VM and $Home directory. By default keys are placed in Cloud Shell at /home/<user>/.ssh/id_rsa and /home/<user>/.ssh/id_rsa.pub. Your .ssh folder is persisted in your attached file share's 5-GB image used to persist $Home.

Your username on this VM will be your username used in Cloud Shell ($User@Azure:).

SSH into your Linux VM

  1. Search for your VM name in the Azure portal search bar.
  2. Click "Connect" to get your VM name and public IP address.

  3. SSH into your VM with the ssh cmd.

    ssh username@ipaddress
    

Upon establishing the SSH connection, you should see the Ubuntu welcome prompt.

Cleaning up

  1. Exit your ssh session.

    exit
    
  2. Delete your resource group and any resources within it.

    Run `az group delete -n MyRG`
    

Next steps

Learn about persisting files for Bash in Cloud Shell
Learn about Azure CLI 2.0
Learn about Azure Files storage