Docker for Azure frequently asked questions (FAQ)

Estimated reading time:
3 minutes

Stable and edge channels

Two different download channels are available for Docker for Azure:

The stable channel provides a general availability release-ready deployment
for a fully baked and tested, more reliable cluster. The stable version of Docker
for Azure comes with the latest released version of Docker Engine. The release
schedule is synched with Docker Engine releases and hotfixes. On the stable
channel, you can select whether to send usage statistics and other data.

The edge channel provides a deployment with new features we are working on,
but is not necessarily fully tested. It comes with the experimental version of
Docker Engine. Bugs, crashes, and issues are more likely to occur with the edge
cluster, but you get a chance to preview new functionality, experiment, and provide
feedback as the deployment evolve. Releases are typically more frequent than for
stable, often one or more per month. Usage statistics and crash reports are sent
by default. You do not have the option to disable this on the edge channel.

Can I use my own VHD?

No, at this time we only support the default Docker for Azure VHD.

Can I specify the type of Storage Account I use for my VM instances?

Not at this time, but it is on our roadmap for future releases.

Which Azure regions does Docker for Azure work with?

Docker for Azure should work with all supported Azure Marketplace regions.

Where are my container logs?

All container logs are aggregated within the xxxxlog storage account.

Where do I report problems or bugs?

Search for existing issues, or create a new one, within the Docker for Azure GitHub repositories.

In Azure, if your resource group is misbehaving, run the following diagnostic tool from one of the managers - this collects your docker logs and sends them to Docker:

Note: Your output may be slightly different from the above, depending on your swarm configuration.

Metrics

Docker for Azure sends anonymized minimal metrics to Docker (heartbeat). These metrics are used to monitor adoption and are critical to improve Docker for Azure.

How do I run administrative commands?

By default when you SSH into a manager, you are logged in as the regular username: docker - It is possible however to run commands with elevated privileges by using sudo.
For example to ping one of the nodes, after finding its IP via the Azure/Azure portal, such as, 10.0.0.4, you could run:

$ sudo ping 10.0.0.4

Note: Access to Docker for Azure and Azure happens through a shell container that itself runs on Docker.

What are the Editions containers running after deployment?

In order for our editions to deploy properly and for load balancer integrations to happen, we run a few containers. They are as follow:

Container name

Description

init

Sets up the swarm and makes sure that the stack came up properly. (checks manager+worker count).

agent

This is our shell/ssh container. When you SSH into an instance, you’re actually in this container.

meta

Assist in creating the swarm cluster, giving privileged instances the ability to join the swarm.

l4controller

Listens for ports exposed at the docker CLI level and opens them in the load balancer.

logger

Our log aggregator. This allows us to send all docker logs to the storage account.

What are the different Azure Regions?

All regions can be found here: Microsoft Azure Regions.
An excerpt of the above regions to use when you create your service principal are: