This document explains how to install DC/OS 1.9 using the Azure Resource Manager templates.
TIP: To get support on Azure Marketplace-related questions, join the Azure Marketplace Slack community.
Important: Upgrades are not supported with this installation method.
To use all of the services offered in DC/OS, you should choose at least five Mesos Agents using
Standard_D2 Virtual Machines, which is the default size in the DC/OS Azure Marketplace offering.
Selecting smaller-sized VMs is not recommended, and selecting fewer VMs will likely cause certain resource-intensive services such as distributed datastores not to work properly (from installation issues to operational limitations).
You will need an active Azure subscription to install DC/OS via the Azure Marketplace.
Also, to access nodes in the DC/OS cluster you will need
ssh installed and configured.
Step 1: Deploying the template
To install DC/OS 1.9 on Azure, use the Azure Resource Manager templates provided.
Step 2: Accessing DC/OS
Because of security considerations, the DC/OS cluster in Azure is locked down by default. You must use an
ssh tunnel to access the DC/OS Dashboard.
First, look up
MASTERFQDN in the outputs of the deployment. To find that, click on the link under
Last deployment (which is
4/15/2016 (Succeeded) here) and you should see this:
Click on the latest deployment and copy the value of
MASTERFQDN in the
Use the value of
MASTERFQDN you found in the
Outputs section in the previous step and paste it in the following command:
ssh azureuser@$MASTERFQDN -p 2200 -L 8000:localhost:80
For example, in my case:
ssh firstname.lastname@example.org -p 2200 -L 8000:localhost:80
Now you can visit
http://localhost:8000 on your local machine and view the DC/OS Dashboard.
Some caveats around SSH access:
- For connections to
http://localhost:8000to work, the SSH command must be run on your local machine, and not inside a Virtual Machine.
- In the example above, port
8000is assumed to be available on your local machine.
- The SSH commands shown only work on Mac or Linux. For Windows use Putty with a similar port-forwarding configuration, see also How to Use SSH with Windows on Azure.
- If you want to learn more about SSH key generation check out this GitHub tutorial.
The DC/OS UI will not show the correct IP address or CLI install commands when connected by using an SSH tunnel.
Note that the following commands can be used to run the DC/OS CLI directly on the master node:
# Connect to master node with ssh ssh -p2200 azureuser@$MASTERFQDN -L 8000:localhost:80 # Install CLI on the master node and configure with http://localhost curl https://downloads.dcos.io/binaries/cli/linux/x86-64/dcos-1.9/dcos -o dcos && sudo mv dcos /usr/local/bin && sudo chmod +x /usr/local/bin/dcos && dcos config set core.dcos_url http://localhost && dcos # Now you can use the DC/OS CLI: dcos package search
Tear Down the DC/OS cluster
If you’ve created a new resource group in the deployment step, it is as easy as this to tear down the cluster and release all of the resources: just delete the resource group. If you have deployed the cluster into an existing resource group, you’ll need to identify all resources that belong to the DC/OS cluster and manually delete them.