This project is no longer actively developed or maintained.

For more information about Compute Engine, refer to our documentation.

Docker Cloud is a proxy for the Docker API which automatically creates and destroys cloud virtual machines to run your docker containers.

If you are running Docker on OS X or Windows, there is no longer any need to install a virtualization layer like vagrant on your machine. You can simply run it in the cloud. Additionally, if you want to easily turn up and down containers into a cloud workspace that lasts longer than your laptop, this is also straightforward.

For now only Google Compute Engine, but the code is factored in such a way to make it easy to add other cloud providers.

go get github.com/GoogleCloudPlatform/docker-cloud

If you don't already have a Google Cloud Project, you can get one on the Google Cloud Console

Create a new Client ID for Installed Application in the APIs/credentials section.

docker-cloud auth -project <your-google-cloud-project-here> -id <your-credentials-client-id> -secret <your-credentials-secret>
# follow the instructions to authorize the client

Once the authorization is completed, you can start the proxy server. If you don't specify any project ID, it'll use the project ID provided during authorization.

docker-cloud start [-project=<your-google-cloud-project-here>]

Use the -H flag on your docker client to connect to the proxy:

docker -H tcp://localhost:8080 run ehazlett/tomcat7

I'm glad you asked.

git clone https://github.com/GoogleCloudPlatform/docker-cloud.git

If you have not installed Go language yet, install Go with this instruction.

Add a work directory for Go code, add it to $GOPATH, and add $GOPATH/bin to $PATH.

mkdir $HOME/go
export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$PATH

If you haven't, you need to install Mercurial (hg) too.

go build