cli/components/engine/docs/sources/installation/google.rst

title

Installation on Google Cloud Platform

description

Please note this project is currently under heavy development. It should not be used in production.

keywords

Docker, Docker documentation, installation, google, Google Compute Engine, Google Cloud Platform

Google Cloud Platform

Compute Engine QuickStart for Debian

1. Go to Google Cloud Console and create a new Cloud Project with Compute Engine enabled.
2. Download and configure the Google Cloud SDK to use your project with the following commands:

$ curl https://dl.google.com/dl/cloudsdk/release/install_google_cloud_sdk.bash | bash
$ gcloud auth login
Enter a cloud project id (or leave blank to not set): <google-cloud-project-id>

3. Start a new instance, select a zone close to you and the desired instance size:

$ gcutil addinstance docker-playground --image=backports-debian-7
1: europe-west1-a
...
4: us-central1-b
>>> <zone-index>
1: machineTypes/n1-standard-1
...
12: machineTypes/g1-small
>>> <machine-type-index>

4. Connect to the instance using SSH:

$ gcutil ssh docker-playground
docker-playground:~$ 

5. Enable IP forwarding:

docker-playground:~$ echo net.ipv4.ip_forward=1 | sudo tee /etc/sysctl.d/99-docker.conf 
docker-playground:~$ sudo sysctl --system

6. Install the latest Docker release and configure it to start when the instance boots:

docker-playground:~$ curl get.docker.io | bash
docker-playground:~$ sudo update-rc.d docker defaults

7. If running in zones: us-central1-a, europe-west1-1, and europe-west1-b, the docker daemon must be started with the -mtu flag. Without the flag, you may experience intermittent network pauses. See this issue for more details.

docker-playground:~$ echo 'DOCKER_OPTS="$DOCKER_OPTS -mtu 1460"' | sudo tee -a /etc/default/docker
docker-playground:~$ sudo service docker restart

8. Start a new container:

docker-playground:~$ sudo docker run busybox echo 'docker on GCE \o/'
docker on GCE \o/