Skip to content
This is an experimental project that allows you connect to Azure Cloud Shell from a local terminal without a browser.
Branch: master
Clone or download
yangl900 Merge pull request #6 from jbpaux/master
Add chocolatey package installation method in README
Latest commit acfa459 May 23, 2019

README.md

Go Report Card

azshell

This is an experimental project that allows you connect to Azure Cloud Shell from a local terminal without a browser.

With azshell you will be able to access latest Azure CLI, PowerShell and all other Cloud Shell tooling (terraform, ansible, .net core) from your local command line.

Installation

azshell is just one binary, copy and use it.

For Linux:

curl -sL https://github.com/yangl900/azshell/releases/download/v0.2.2/azshell_linux_64-bit.tar.gz | tar xz

For Windows (In PowerShell):

curl https://github.com/yangl900/azshell/releases/download/v0.2.2/azshell_windows_64-bit.zip -OutFile azshell_windows_64.zip

And unzip the file, the only binary needed is azshell.exe.

For Windows (Using Chocolatey package manager)

choco install azshell

For MacOS:

curl -sL https://github.com/yangl900/azshell/releases/download/v0.2.2/azshell_macOS_64-bit.tar.gz | tar xz

Usage

Simply type azshell and you are good to go. You will be prompt for device login for the first time, and access token will be cached in $HOME/.azshell.

Demo

Reset the login status and selected tenant:

azshell --reset

Specify the shell to start:

azshell --shell bash
azshell --shell pwsh

OS support

This should work on Linux, Mac and Windows.

How to build

Run make from the project root. Linux / Mac / Windows binaries will all be built.

Multiple tenants (not common)

If your account happen to have access to multiple tenants (AAD Directory), you will choose the default tenant for the first time. Later sessions will reuse the preference. To reset the tenant selection, run azshell --reset

Limitations

This is an experimental / prototype project. There are a few things I have not handled:

  • Not all authentication is hooked up. For example Graph and KeyVault CLI won't get the automatic login.
  • download command is not implemented, but it is possible to implement. Same for upload.

Contributions and comments

If you like the idea and like to contribute to make this a real tool, contributions are welcome! Any comments are welcome too.

If you'd like to see this become an official tool from Azure, feel free to open issues or post to Azure Cloud Shell feedback.

You can’t perform that action at this time.