README
¶
This project is no longer actively developed or maintained.
For more information about Compute Engine, refer to our documentation.
Docker Cloud
What is it?
Docker Cloud is a proxy for the Docker API which automatically creates and destroys cloud virtual machines to run your docker containers.
Why would I want to do that?
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.
What clouds does it work on?
For now only Google Compute Engine, but the code is factored in such a way to make it easy to add other cloud providers.
Sounds great! How do I use it?
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>]
Connecting docker to the proxy
Use the -H flag on your docker client to connect to the proxy:
docker -H tcp://localhost:8080 run ehazlett/tomcat7
How can I contribute?
I'm glad you asked.
Getting the source
git clone https://github.com/GoogleCloudPlatform/docker-cloud.git
Setting up Go
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.
Building
go build
Documentation
¶
Overview ¶
Copyright (C) 2013 The Docker Cloud authors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Source Files
Directories