Files
docker-machine/docs/drivers/azure.md
Mary Anthony 39806c02e0 First stage of splitting out
Splitting out docs
Fixing location of help
entering in changes from testing
Filling in some missing structure
Updating with the comments from Nathan
Updating with the comments from Nathan
Updating after talk with Evan/Nathan

Signed-off-by: Mary Anthony <mary@docker.com>
2015-07-14 12:44:56 -07:00

3.4 KiB

Microsoft Azure

Create machines on Microsoft Azure.

You need to create a subscription with a cert. Run these commands and answer the questions:

$ openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout mycert.pem -out mycert.pem
$ openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
$ openssl x509 -inform pem -in mycert.pem -outform der -out mycert.cer

Go to the Azure portal, go to the "Settings" page (you can find the link at the bottom of the left sidebar - you need to scroll), then "Management Certificates" and upload mycert.cer.

Grab your subscription ID from the portal, then run docker-machine create with these details:

$ docker-machine create -d azure --azure-subscription-id="SUB_ID" --azure-subscription-cert="mycert.pem" A-VERY-UNIQUE-NAME

The Azure driver uses the b39f27a8b8c64d52b05eac6a62ebad85__Ubuntu-14_04_1-LTS-amd64-server-20140927-en-us-30GB image by default. Note, this image is not available in the Chinese regions. In China you should specify b549f4301d0b4295b8e76ceb65df47d4__Ubuntu-14_04_1-LTS-amd64-server-20140927-en-us-30GB.

You may need to machine ssh in to the virtual machine and reboot to ensure that the OS is updated.

Options:

  • --azure-docker-port: Port for Docker daemon.
  • --azure-image: Azure image name. See How to: Get the Windows Azure Image Name
  • --azure-location: Machine instance location.
  • --azure-password: Your Azure password.
  • --azure-publish-settings-file: Azure setting file. See How to: Download and Import Publish Settings and Subscription Information
  • --azure-size: Azure disk size.
  • --azure-ssh-port: Azure SSH port.
  • --azure-subscription-id: required Your Azure subscription ID (A GUID like d255d8d7-5af0-4f5c-8a3e-1545044b861e).
  • --azure-subscription-cert: required Your Azure subscription cert.
  • --azure-username: Azure login user name.

Environment variables and default values:

CLI option Environment variable Default
--azure-docker-port - 2376
--azure-image AZURE_IMAGE Ubuntu 14.04 LTS x64
--azure-location AZURE_LOCATION West US
--azure-password - -
--azure-publish-settings-file AZURE_PUBLISH_SETTINGS_FILE -
--azure-size AZURE_SIZE Small
--azure-ssh-port - 22
--azure-subscription-cert AZURE_SUBSCRIPTION_CERT -
--azure-subscription-id AZURE_SUBSCRIPTION_ID -
--azure-username - ubuntu