This project provides a cross platform command line tool for managing Windows Azure Websites and Virtual Machines.
With Windows Azure Websites you can deploy node.js applications to the cloud in just seconds using git.
- Accounts
- Download and import Azure publish settings
- Create and manage Storage Accounts
- Websites
- Create and manage Windows Azure websites
- Download site logs
- Manage Deployments
- Configure Github integration
- Virtual machines
- Create and manage Windows and Linux Virtual machines
- Create and manage VM endpoints
- Create and manage Virtual Machine Images
- Create and manage certificates
- Mobile Services
- Create and manage Mobile Services
- Manage tables, scripts, and configuration
- Access logs
- Access data
- Service Bus
- Create and manage Service Bus namespaces
To get the source code of the SDK via git just type:
git clone https://github.com/WindowsAzure/azure-sdk-tools-xplat.git
cd ./azure-sdk-tools-xplat
npm install
You can install the azure cli npm package directly.
npm install -g azure-cli
The azure cli has several top-level commands, which correspond to different features of Windows Azure. Each top-level command is then broken up into further sub commands. Typing "azure" by itself or "azure --help" will list out each of the sub commands.
Below is a list of some of the more common commands and explanations on how to use them.
In order to use the CLI, you must first import credentials.
azure account download
Download your credentials from Windows Azure. Logs you in to the Azure portal and downloads a publishsettings file.
azure account import [file]
Imports previously downloaded credentials
You can create and manage store accounts for leveraging blobs, tables and queues within your applications.
azure account storage list
Lists all your storage accounts
azure account storage create [name]
Creates a new storage account
--location - Location for the storage account
--affinitygroup - Affinity group for the storage account
Note: Either location or affinity group is required.
azure account storage update [name]
Updates a storage account label, description, etc.
azure account storage delete [name]
Removes the storage account
azure account storage keys list [name]
Lists out storage account keys for the specified account
azure account storage keys renew [name]
Renews storage account keys for the specified account
You can create websites for deploying static HTML, node.js, PHP, and .NET applications.
azure site list
Lists all your websites
azure site create [site]
Creates a new Windows Azure website. If run in a folder that has an app.js or a server.js, we will assume this is a node.js application and create an iisnode.yml file for configuring the node hosted environment.
--git - create a git repo for deploying the application. Will call "git init" to initialize the local folder as repo and will add an "azure" remote for the remote repository. --publishingUsername can be used for scripting scenarios. If publishing user is not provider, you will be prompted. ex. "azure site create foo --git".
--github - connect this website to a github repo. If run in a local repo, will use the remotes present. --githubusername / --githubpassword / -- githubrepository can be used for scripting scenarios. If these are not provided, you will be prompted. ex. "azure site create foo --github"
azure site show [site]
Lists the details for a specific website.
azure site browse [site]
Opens the website in the browser.
azure site delete [site]
Deletes the current site. Will prompt for deletion.
azure site stop [site]
Stops the website
azure site start [site]
Starts the website
azure site restart [site]
Stops and starts the website
azure site deploymentscript
Generates a bash or cmd script for customizing the deployment of your Website
--quiet - overrides prompting for delete.
Note: Above [site] is not required if the command is run in the main app folder.
You can set application settings, which will propagate to environment variables for your node and PHP applications. Changes are instant, and you do not need to stop/start the app to pick up the new variables.
azure site config list [site]
Lists all application settings.
azure site config add [keyvaluepair] [site]
Adds a new app setting. [keyvaluepair] is of the form "[key]=[value]" i.e. "foo=bar".
azure site config clear [key] [site]
Removes the specified app setting.
azure site config get [key] [site]
Retrieves the value for the selected key.
You can create and manage both Windows and Linux virtual machines in Windows Azure.
azure vm list
List your virtual machines and their statuses
azure vm location list
List available locations for hosting virtual machines.
azure vm create [name] [image] [username] [password] [location]
Create a new virtual machine using the specific image and credentials. An image can be a base image or an custom image uploaded to your account ex. "azure create myvm SUSE__openSUSE-12-1-20120603-en-us-30GB.vhd user pa$$w0rd westus".
--ssh [port] - Enable a Linux VM to be remotely administered via ssh. By default port 22 is chosen.
--rdp [port] - Enable a Windows VM to be remotely administered via RDP. By default port 3389 is chosen.
--community - Specifies that the image is a community image
azure vm create-from [name] [rolefile]
Create a virtual machine from a previously exported rolefile.
azure vm export [name] [file]
Export a virtual machine definition.
azure vm show [name]
Display details about the VM.
azure vm shutdown [name]
Stop the virtual machine
azure vm start
Start a previously shutdown virtual machine
azure vm restart [name]
Restart the virtual machine
azure vm delete [name]
Delete the virtual machine
Windows Azure allows you to create virtual machines using a set of preconfigured based images or using your own custom images which you create either by uploaded, or saving an existing vm.
azure vm image list
List base and custom vm images
azure vm image show [image]
Show details about a specific image
azure vm image create [name] [path]
Upload a new custom image. The path can point to a local file or a public hosted blob, including a secure blob.
--os [os] - specify the OS, "Linux" or "Windows"
--basevhd [blob] - Specify a base vhd blob url.
--source-key [key] - If the blob is secured, specifies the access key.
azure vm image delete [name]
Deletes the specified image.
You can create additional data disks, which you mount within your virtual machines.
azure vm disk list
Lists available data disks
azure vm disk show [name]
Displays details on a specific disk
azure vm disk create [name] [path]
Uploads and creates a new disk using the specified path. The path can point to a local file or a public hosted blob, including a secure blob.
--source-key [key] - If the blob is secured, specifies the access key.
azure vm disk attach [vm-name] [image]
Attaches an image to an existing VM.
azure vm disk detach [vm-name] [image]
Detaches an image from an existing VM.
You can create and manage your mobile services right from the cli. You can create new services and databases, work directly with table data, and manage scripts and more.
azure mobile list
Lists all mobile services for this subscription
azure mobile create [servicename] [sqlAdminUsername] [sqlAdminPassword]
Creates a new mobile service using the specific service name. Also creates a new SQL Database using the specified user and password.
azure mobile show [servicename]
Displays details about a mobile service including database details, applicationUrl and applicationKey
azure mobile delete
Deletes a mobile service [servicename]
azure mobile log
Retrieves mobile logs [servicename]
You can configure your Microsoft account, Facebook, Twitter, Google and push notification settings using these commands.
azure mobile config list [servicename]
Lists the available mobile configuration settings and their values
azure mobile config set [servicename] [key] [value]
Sets mobile configuration settings
azure mobile config get [servicename] [key]
Gets a specific mobile configuration setting
azure mobile table list [servicename]
List the tables for a specific service
azure mobile table create [servicename] [tablename]
Creates a new table for your mobile service
--permissions [permissions] - comma delimited list of = pairs
azure mobile table show [servicename] [tablename]
Display table details such as the number of records, the list of columns and which scripts are defined.
azure mobile table update [options] [servicename] [tablename]
Updates mobile table schema, permissions and indexes
--permissions [permissions] - comma delimited list of = pairs --deleteColumn [columns] - comma delimited list of columns to delete
azure mobile table delete [servicename] [tablename]
Deletes a mobile table
You can create and upload scripts for your table operations.
azure mobile script list
List scripts for the specified service
azure mobile script download [servicename] [scriptname]
Downloads the specified script. Table script names are in the format table/.{read|insert|update|delete} (e.g. table/todoitem.insert)
azure mobile script upload [servicename] [scriptname]
Uploads a script
azure mobile script delete [servicename] [scriptname]
Deletes a script
azure mobile data read [servicename] [tablename] [query]
Query a mobile service table
azure sb namespace list
List all your Service Bus namespaces
azure sb namespace create [namespace] [region]
Create a new Service Bus namespace in the specified region
azure sb namespace show [name]
Display details about a namespace such as the connection string and endpoint information
azure sb namespace check [name]
Check if a namespace is available
azure sb namespace delete [name]
Delete a namespace
azure sb namespace location list
Lists all available regions for creating new namespaces
For more details on the commands, please see the command line tool reference and this How to Guide
Be sure to check out the Windows Azure Developer Forums on Stack Overflow if you have trouble with the provided code.
If you would like to become an active contributor to this project please follow the instructions provided in Windows Azure Projects Contribution Guidelines.
If you encounter any bugs with the library please file an issue in the Issues section of the project.
The tests included in the repository execute CLI commands against live Widows Azure management endpoints. In order to run the tests, you must have a Windows Azure subscription as well as a GitHub account.
Before running tests, you must take a one-time action to configure the CLI with the Windows Azure subscription by running
azure account download
azure account import
Next, provide the following parameters by setting environment variables:
AZURE_STORAGE_ACCOUNT- your Windows Azure Storage Account nameAZURE_STORAGE_ACCESS_KEY- secret access key to that Storage AccountAZURE_SERVICEBUS_NAMESPACE- your Windows Azure Service Bus NamespaceAZURE_SERVICEBUS_ACCESS_KEY- secret access to that Service Bus namespaceAZURE_GITHUB_USERNAME- GitHub account usernameAZURE_GITHUB_PASSWORD- GitHub account passwordAZURE_GITHUB_REPOSITORY- name an empty GitHub repository to use during tests (e.g.tjanczuk/clitest)
To run the tests, call
npm test
from the root of your clone of the repository. Most tests execute against live Windows Azure management APIs, and running them takes considerable time.
Note: by default, the tests targeting the Windows Azure Mobile Services run against a mocked Windows Azure HTTP endpoints. In order to execute these tests against live Windows Azure management APIs instead, set the NOCK_OFF=true environment variable before running the tests.
For documentation on how to host Node.js applications on Windows Azure, please see the Windows Azure Node.js Developer Center.
For more extensive documentation on the new cross platform CLI tool for Mac and Linux, please see this reference and this How to Guide
Check out our new IRC channel on freenode, node-azure.