From 37ed178611622da42e3a4a0aed2288b00b4eb208 Mon Sep 17 00:00:00 2001 From: Brian Dorsey Date: Fri, 20 Dec 2013 16:06:28 -0800 Subject: [PATCH 1/2] Added a note about a networking work around. An additional flag to limit the networking MTU is required in three Compute Engine zones for reliable networking from inside the docker container. Added a warning to that effect to the QuickStart guide. --- docs/sources/installation/google.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/sources/installation/google.rst b/docs/sources/installation/google.rst index e3286d1d90..2f6ac214f4 100644 --- a/docs/sources/installation/google.rst +++ b/docs/sources/installation/google.rst @@ -63,3 +63,12 @@ docker-playground:~$ sudo docker run busybox echo 'docker on GCE \o/' docker on GCE \o/ + +**The -lxc-conf flag below is required** when running docker images in zones: us-central1-a, europe-west1-1, and europe-west1-b. Without the MTU flag, you may experience intermittent network pauses. +`See this issue `_ for more details. + +.. code-block:: bash + + docker-playground:~$ sudo docker run -lxc-conf="lxc.network.mtu = 1460" busybox echo 'docker on GCE \o/' + docker on GCE \o/ + From cdd14b1a31603e602ab36522582b4356264ccb60 Mon Sep 17 00:00:00 2001 From: Brian Dorsey Date: Fri, 20 Dec 2013 16:19:35 -0800 Subject: [PATCH 2/2] Update MTU work-around to use the new -mtu flag --- docs/sources/installation/google.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/docs/sources/installation/google.rst b/docs/sources/installation/google.rst index 2f6ac214f4..ff38e1e6e4 100644 --- a/docs/sources/installation/google.rst +++ b/docs/sources/installation/google.rst @@ -57,18 +57,17 @@ docker-playground:~$ curl get.docker.io | bash docker-playground:~$ sudo update-rc.d docker defaults -7. Start a new container: +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. + +.. code-block:: bash + + docker -d -mtu 1460 + +8. Start a new container: .. code-block:: bash docker-playground:~$ sudo docker run busybox echo 'docker on GCE \o/' docker on GCE \o/ -**The -lxc-conf flag below is required** when running docker images in zones: us-central1-a, europe-west1-1, and europe-west1-b. Without the MTU flag, you may experience intermittent network pauses. -`See this issue `_ for more details. - -.. code-block:: bash - - docker-playground:~$ sudo docker run -lxc-conf="lxc.network.mtu = 1460" busybox echo 'docker on GCE \o/' - docker on GCE \o/ -