Browse code

Add an example of how to add your client IP to the container hosts file

Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au>

Docker-DCO-1.1-Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au> (github: SvenDowideit)

Sven Dowideit authored on 2014/11/19 08:55:40
Showing 1 changed files
... ...
@@ -1606,6 +1606,30 @@ container exits with a non-zero exit status more than 10 times in a row
1606 1606
 Docker will abort trying to restart the container.  Providing a maximum
1607 1607
 restart limit is only valid for the ** on-failure ** policy.
1608 1608
 
1609
+### Adding entries to a container hosts file
1610
+
1611
+You can add other hosts into a container's `/etc/hosts` file by using one or more
1612
+`--add-host` flags. This example adds a static address for a host named `docker`:
1613
+
1614
+```
1615
+    $ docker run --add-host=docker:10.180.0.1 --rm -it debian
1616
+    $$ ping docker
1617
+    PING docker (10.180.0.1): 48 data bytes
1618
+    56 bytes from 10.180.0.1: icmp_seq=0 ttl=254 time=7.600 ms
1619
+    56 bytes from 10.180.0.1: icmp_seq=1 ttl=254 time=30.705 ms
1620
+    ^C--- docker ping statistics ---
1621
+    2 packets transmitted, 2 packets received, 0% packet loss
1622
+    round-trip min/avg/max/stddev = 7.600/19.152/30.705/11.553 ms
1623
+```
1624
+
1625
+> **Note:**
1626
+> Sometimes you need to connect to the Docker host, which means getting the IP
1627
+> address of the host. You can use the following shell commands to simplify this
1628
+> process:
1629
+>
1630
+>      $ alias hostip="ip route show 0.0.0.0/0 | grep -Eo 'via \S+' | awk '{ print \$2 }'"
1631
+>      $ docker run  --add-host=docker:$(hostip) --rm -it debian
1632
+
1609 1633
 ## save
1610 1634
 
1611 1635
     Usage: docker save [OPTIONS] IMAGE [IMAGE...]