3.12.0-boron release

diemol · diemol · commit e80b27c99bf1 · 2018-05-31T09:58:34.000+02:00
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
@@ -2,7 +2,7 @@
 Image(s):  
 <!-- node-chrome? hub? standalone-firefox? -->
 Docker-Selenium Image Version(s):  
-<!-- 3, 3.4, 3.12.0-americium etc -->
+<!-- 3, 3.4, 3.12.0-boron etc -->
 Docker Version:  
 <!-- 17.09.0-ce, 17.06.2-ce etc -->
 OS: 
diff --git a/Hub/Dockerfile b/Hub/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/base:3.12.0-americium
+FROM selenium/base:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER seluser
@@ -31,7 +31,9 @@ ENV GRID_TIMEOUT 30
 ENV GRID_DEBUG false
 # As integer, maps to "port"
 ENV GRID_HUB_PORT 4444
-
+# As string, maps to "host"
+ENV GRID_HUB_HOST "0.0.0.0"
+ 
 COPY generate_config \
     entry_point.sh \
     /opt/bin/
diff --git a/Makefile b/Makefile
@@ -1,5 +1,5 @@
 NAME := selenium
-VERSION := $(or $(VERSION),$(VERSION),3.12.0-americium)
+VERSION := $(or $(VERSION),$(VERSION),3.12.0-boron)
 NAMESPACE := $(or $(NAMESPACE),$(NAMESPACE),$(NAME))
 AUTHORS := $(or $(AUTHORS),$(AUTHORS),SeleniumHQ)
 PLATFORM := $(shell uname -s)
diff --git a/NodeBase/Dockerfile b/NodeBase/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/base:3.12.0-americium
+FROM selenium/base:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER root
@@ -98,6 +98,8 @@ ENV DISPLAY :99.0
 ENV NODE_MAX_INSTANCES 1
 # As integer, maps to "maxSession"
 ENV NODE_MAX_SESSION 1
+# As address, maps to "host"
+ENV NODE_HOST 0.0.0.0
 # As integer, maps to "port"
 ENV NODE_PORT 5555
 # In milliseconds, maps to "registerCycle"
diff --git a/NodeChrome/Dockerfile b/NodeChrome/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-base:3.12.0-americium
+FROM selenium/node-base:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER root
diff --git a/NodeChromeDebug/Dockerfile b/NodeChromeDebug/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-chrome:3.12.0-americium
+FROM selenium/node-chrome:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER root
diff --git a/NodeChromeDebug/README.md b/NodeChromeDebug/README.md
@@ -37,7 +37,7 @@ If you are running Boot2Docker on Mac then you already have a [VNC client](http:
 When you are prompted for the password it is __secret__. If you wish to change this then you should either change it in the `/NodeBase/Dockerfile` and build the images yourself, or you can define a docker image that derives from the posted ones which reconfigures it:
 
 ``` dockerfile
-FROM selenium/node-chrome-debug:3.12.0-americium
+FROM selenium/node-chrome-debug:3.12.0-boron
 
 RUN x11vnc -storepasswd <your-password-here> /home/seluser/.vnc/passwd
 ```
diff --git a/NodeDebug/README.template.md b/NodeDebug/README.template.md
@@ -37,7 +37,7 @@ If you are running Boot2Docker on Mac then you already have a [VNC client](http:
 When you are prompted for the password it is __secret__. If you wish to change this then you should either change it in the `/NodeBase/Dockerfile` and build the images yourself, or you can define a docker image that derives from the posted ones which reconfigures it:
 
 ``` dockerfile
-FROM selenium/##BASE##-debug:3.12.0-americium
+FROM selenium/##BASE##-debug:3.12.0-boron
 
 RUN x11vnc -storepasswd <your-password-here> /home/seluser/.vnc/passwd
 ```
diff --git a/NodeFirefox/Dockerfile b/NodeFirefox/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-base:3.12.0-americium
+FROM selenium/node-base:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER root
diff --git a/NodeFirefoxDebug/Dockerfile b/NodeFirefoxDebug/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-firefox:3.12.0-americium
+FROM selenium/node-firefox:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER root
diff --git a/NodeFirefoxDebug/README.md b/NodeFirefoxDebug/README.md
@@ -37,7 +37,7 @@ If you are running Boot2Docker on Mac then you already have a [VNC client](http:
 When you are prompted for the password it is __secret__. If you wish to change this then you should either change it in the `/NodeBase/Dockerfile` and build the images yourself, or you can define a docker image that derives from the posted ones which reconfigures it:
 
 ``` dockerfile
-FROM selenium/node-firefox-debug:3.12.0-americium
+FROM selenium/node-firefox-debug:3.12.0-boron
 
 RUN x11vnc -storepasswd <your-password-here> /home/seluser/.vnc/passwd
 ```
@@ -47,7 +47,7 @@ _Selenium automates browsers._ That's it! What you do with that power is entirel
 
 Selenium has the support of some of the largest browser vendors who have taken (or are taking) steps to make Selenium a native part of their browser. It is also the core technology in countless other browser automation tools, APIs and frameworks.
 
-See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.
+See the Selenium [site](http://docs.seleniumhq.org/) for documentation on usage within your test code.
 
 ## License
 
diff --git a/README.md b/README.md
@@ -31,15 +31,15 @@ Images included:
 
 Chrome
 ``` bash
-$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-chrome:3.12.0-americium
+$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-chrome:3.12.0-boron
 #OR
-$ docker run -d -p 4444:4444 --shm-size=2g selenium/standalone-chrome:3.12.0-americium
+$ docker run -d -p 4444:4444 --shm-size=2g selenium/standalone-chrome:3.12.0-boron
 ```
 Firefox
 ``` bash
-$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-firefox:3.12.0-americium
+$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-firefox:3.12.0-boron
 #OR
-$ docker run -d -p 4444:4444 --shm-size 2g selenium/standalone-firefox:3.12.0-americium
+$ docker run -d -p 4444:4444 --shm-size 2g selenium/standalone-firefox:3.12.0-boron
 ```
 This is a known workaround to avoid the browser crashing inside a docker container, here are the documented issues for
 [Chrome](https://code.google.com/p/chromium/issues/detail?id=519952) and [Firefox](https://bugzilla.mozilla.org/show_bug.cgi?id=1338771#c10).
@@ -50,9 +50,9 @@ to tune this value according to your needs. Along the examples `-v /dev/shm:/dev
 ### Standalone Chrome and Firefox
 
 ``` bash
-$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-chrome:3.12.0-americium
+$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-chrome:3.12.0-boron
 # OR
-$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-firefox:3.12.0-americium
+$ docker run -d -p 4444:4444 -v /dev/shm:/dev/shm selenium/standalone-firefox:3.12.0-boron
 ```
 
 _Note: Only one standalone image can run on port_ `4444` _at a time._
@@ -68,9 +68,9 @@ A docker [network](https://docs.docker.com/engine/reference/commandline/network_
 
 ``` bash
 $ docker network create grid
-$ docker run -d -p 4444:4444 --net grid --name selenium-hub selenium/hub:3.12.0-americium
-$ docker run -d --net grid -e HUB_HOST=selenium-hub -v /dev/shm:/dev/shm selenium/node-chrome:3.12.0-americium
-$ docker run -d --net grid -e HUB_HOST=selenium-hub -v /dev/shm:/dev/shm selenium/node-firefox:3.12.0-americium
+$ docker run -d -p 4444:4444 --net grid --name selenium-hub selenium/hub:3.12.0-boron
+$ docker run -d --net grid -e HUB_HOST=selenium-hub -v /dev/shm:/dev/shm selenium/node-chrome:3.12.0-boron
+$ docker run -d --net grid -e HUB_HOST=selenium-hub -v /dev/shm:/dev/shm selenium/node-firefox:3.12.0-boron
 ```
 
 When you are done using the grid and the containers have exited, the network can be removed with the following command:
@@ -94,7 +94,7 @@ snippet as your `docker-compose.yaml`, save it locally and in the same folder ru
 version: '2'
 services:
   firefox:
-    image: selenium/node-firefox:3.12.0-americium
+    image: selenium/node-firefox:3.12.0-boron
     volumes:
       - /dev/shm:/dev/shm
     depends_on:
@@ -103,7 +103,7 @@ services:
       HUB_HOST: hub
 
   chrome:
-    image: selenium/node-chrome:3.12.0-americium
+    image: selenium/node-chrome:3.12.0-boron
     volumes:
       - /dev/shm:/dev/shm
     depends_on:
@@ -112,7 +112,7 @@ services:
       HUB_HOST: hub
 
   hub:
-    image: selenium/hub:3.12.0-americium
+    image: selenium/hub:3.12.0-boron
     ports:
       - "4444:4444"
 ```
@@ -124,19 +124,19 @@ services:
 version: "3"
 services:
   selenium-hub:
-    image: selenium/hub:3.12.0-americium
+    image: selenium/hub:3.12.0-boron
     container_name: selenium-hub
     ports:
       - "4444:4444"
   chrome:
-    image: selenium/node-chrome:3.12.0-americium
+    image: selenium/node-chrome:3.12.0-boron
     depends_on:
       - selenium-hub
     environment:
       - HUB_HOST=selenium-hub
       - HUB_PORT=4444
   firefox:
-    image: selenium/node-firefox:3.12.0-americium
+    image: selenium/node-firefox:3.12.0-boron
     depends_on:
       - selenium-hub
     environment:
@@ -152,9 +152,9 @@ for longer term usage since this is a docker [legacy feature](https://docs.docke
 It could serve you as an option for a proof of concept, and for simplicity it is used in the examples shown from now on. 
 
 ``` bash
-$ docker run -d -p 4444:4444 --name selenium-hub selenium/hub:3.12.0-americium
-$ docker run -d --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-chrome:3.12.0-americium
-$ docker run -d --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-firefox:3.12.0-americium
+$ docker run -d -p 4444:4444 --name selenium-hub selenium/hub:3.12.0-boron
+$ docker run -d --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-chrome:3.12.0-boron
+$ docker run -d --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-firefox:3.12.0-boron
 ```
 
 ## Configuring the containers
@@ -164,15 +164,15 @@ $ docker run -d --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-firef
 You can pass `JAVA_OPTS` environment variable to java process.
 
 ``` bash
-$ docker run -d -p 4444:4444 -e JAVA_OPTS=-Xmx512m --name selenium-hub selenium/hub:3.12.0-americium
+$ docker run -d -p 4444:4444 -e JAVA_OPTS=-Xmx512m --name selenium-hub selenium/hub:3.12.0-boron
 ```
 
 ### SE_OPTS Selenium Configuration Options
 
 You can pass `SE_OPTS` variable with additional commandline parameters for starting a hub or a node.
 
 ``` bash
-$ docker run -d -p 4444:4444 -e SE_OPTS="-debug" --name selenium-hub selenium/hub:3.12.0-americium
+$ docker run -d -p 4444:4444 -e SE_OPTS="-debug" --name selenium-hub selenium/hub:3.12.0-boron
 ```
 
 ### Selenium Hub and Node Configuration options
@@ -184,15 +184,15 @@ You can pass the `HUB_HOST` and `HUB_PORT` options to provide the hub address to
 
 ``` bash
 # Assuming a hub was already started
-$ docker run -d -e HUB_HOST=<hub_ip|hub_name> -e HUB_PORT=4444 selenium/node-chrome:3.12.0-americium
+$ docker run -d -e HUB_HOST=<hub_ip|hub_name> -e HUB_PORT=4444 selenium/node-chrome:3.12.0-boron
 ```
 
 Some network topologies might prevent the hub to reach the node through the url given at registration time, `REMOTE_HOST`
 can be used to supply the hub a url where the node is reachable under your specific network configuration 
 
 ``` bash
 # Assuming a hub was already started
-$ docker run -d -e HUB_HOST=<hub_ip|hub_name> -e REMOTE_HOST="http://node_ip|node_name:node_port" selenium/node-firefox:3.12.0-americium
+$ docker run -d -e HUB_HOST=<hub_ip|hub_name> -e REMOTE_HOST="http://node_ip|node_name:node_port" selenium/node-firefox:3.12.0-boron
 ```
 
 ## Building the images
@@ -216,11 +216,11 @@ _Note: Omitting_ `VERSION=local` _will build the images with the current version
 ##### Example: Spawn a container for testing in Chrome:
 
 ``` bash
-$ docker run -d --name selenium-hub -p 4444:4444 selenium/hub:3.12.0-americium
+$ docker run -d --name selenium-hub -p 4444:4444 selenium/hub:3.12.0-boron
 $ CH=$(docker run --rm --name=ch \
     --link selenium-hub:hub -v /e2e/uploads:/e2e/uploads \
     -v /dev/shm:/dev/shm \
-    selenium/node-chrome:3.12.0-americium)
+    selenium/node-chrome:3.12.0-boron)
 ```
 
 _Note:_ `-v /e2e/uploads:/e2e/uploads` _is optional in case you are testing browser uploads on your web app you will probably need to share a directory for this._
@@ -230,11 +230,11 @@ _Note:_ `-v /e2e/uploads:/e2e/uploads` _is optional in case you are testing brow
 This command line is the same as for Chrome. Remember that the Selenium running container is able to launch either Chrome or Firefox, the idea around having 2 separate containers, one for each browser is for convenience plus avoiding certain `:focus` issues your web app may encounter during end-to-end test automation.
 
 ``` bash
-$ docker run -d --name selenium-hub -p 4444:4444 selenium/hub:3.12.0-americium
+$ docker run -d --name selenium-hub -p 4444:4444 selenium/hub:3.12.0-boron
 $ FF=$(docker run --rm --name=fx \
     --link selenium-hub:hub -v /e2e/uploads:/e2e/uploads \
     -v /dev/shm:/dev/shm \
-    selenium/node-firefox:3.12.0-americium)
+    selenium/node-firefox:3.12.0-boron)
 ```
 
 _Note: Since a Docker container is not meant to preserve state and spawning a new one takes less than 3 seconds you will likely want to remove containers after each end-to-end test with_ `--rm` _command. You need to think of your Docker containers as single processes, not as running virtual machines, in case you are familiar with [Vagrant](https://www.vagrantup.com/)._
@@ -243,27 +243,27 @@ _Note: Since a Docker container is not meant to preserve state and spawning a ne
 
 In the event you wish to visually see what the browser is doing you will want to run the `debug` variant of node or standalone images. A VNC server will run on port 5900. You are free to map that to any free external port that you wish. Keep in mind that you will only be able to run one node per port so if you wish to include a second node, or more, you will have to use different ports, the 5900 as the internal port will have to remain the same though as thats the VNC service on the node. The second example below shows how to run multiple nodes and with different VNC ports open:
 ``` bash
-$ docker run -d -P -p <port4VNC>:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-chrome-debug:3.12.0-americium
-$ docker run -d -P -p <port4VNC>:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-firefox-debug:3.12.0-americium
+$ docker run -d -P -p <port4VNC>:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-chrome-debug:3.12.0-boron
+$ docker run -d -P -p <port4VNC>:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-firefox-debug:3.12.0-boron
 ```
 e.g.:
 ``` bash
-$ docker run -d -P -p 5900:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-chrome-debug:3.12.0-americium
-$ docker run -d -P -p 5901:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-firefox-debug:3.12.0-americium
+$ docker run -d -P -p 5900:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-chrome-debug:3.12.0-boron
+$ docker run -d -P -p 5901:5900 --link selenium-hub:hub -v /dev/shm:/dev/shm selenium/node-firefox-debug:3.12.0-boron
 ```
 to connect to the Chrome node on 5900 and the Firefox node on 5901 (assuming those node are free, and reachable).
 
 And for standalone:
 ``` bash
-$ docker run -d -p 4444:4444 -p <port4VNC>:5900 -v /dev/shm:/dev/shm selenium/standalone-chrome-debug:3.12.0-americium
+$ docker run -d -p 4444:4444 -p <port4VNC>:5900 -v /dev/shm:/dev/shm selenium/standalone-chrome-debug:3.12.0-boron
 # OR
-$ docker run -d -p 4444:4444 -p <port4VNC>:5900 -v /dev/shm:/dev/shm selenium/standalone-firefox-debug:3.12.0-americium
+$ docker run -d -p 4444:4444 -p <port4VNC>:5900 -v /dev/shm:/dev/shm selenium/standalone-firefox-debug:3.12.0-boron
 ```
 or
 ``` bash
-$ docker run -d -p 4444:4444 -p 5900:5900 -v /dev/shm:/dev/shm selenium/standalone-chrome-debug:3.12.0-americium
+$ docker run -d -p 4444:4444 -p 5900:5900 -v /dev/shm:/dev/shm selenium/standalone-chrome-debug:3.12.0-boron
 # OR
-$ docker run -d -p 4444:4444 -p 5901:5900 -v /dev/shm:/dev/shm selenium/standalone-firefox-debug:3.12.0-americium
+$ docker run -d -p 4444:4444 -p 5901:5900 -v /dev/shm:/dev/shm selenium/standalone-firefox-debug:3.12.0-boron
 ```
 
 You can acquire the port that the VNC server is exposed to by running:
@@ -282,8 +282,8 @@ If you are running [Boot2Docker](https://docs.docker.com/installation/mac/) on O
 
 When you are prompted for the password it is `secret`. If you wish to change this then you should either change it in the `/NodeBase/Dockerfile` and build the images yourself, or you can define a Docker image that derives from the posted ones which reconfigures it:
 ``` dockerfile
-#FROM selenium/node-chrome-debug:3.12.0-americium
-#FROM selenium/node-firefox-debug:3.12.0-americium
+#FROM selenium/node-chrome-debug:3.12.0-boron
+#FROM selenium/node-firefox-debug:3.12.0-boron
 #Choose the FROM statement that works for you.
 
 RUN x11vnc -storepasswd <your-password-here> /home/seluser/.vnc/passwd
diff --git a/StandaloneChrome/Dockerfile b/StandaloneChrome/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-chrome:3.12.0-americium
+FROM selenium/node-chrome:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER seluser
diff --git a/StandaloneChromeDebug/Dockerfile b/StandaloneChromeDebug/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-chrome-debug:3.12.0-americium
+FROM selenium/node-chrome-debug:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER seluser
diff --git a/StandaloneFirefox/Dockerfile b/StandaloneFirefox/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-firefox:3.12.0-americium
+FROM selenium/node-firefox:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER seluser
diff --git a/StandaloneFirefoxDebug/Dockerfile b/StandaloneFirefoxDebug/Dockerfile
@@ -2,7 +2,7 @@
 # NOTE: DO *NOT* EDIT THIS FILE.  IT IS GENERATED.
 # PLEASE UPDATE Dockerfile.txt INSTEAD OF THIS FILE
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-FROM selenium/node-firefox-debug:3.12.0-americium
+FROM selenium/node-firefox-debug:3.12.0-boron
 LABEL authors=SeleniumHQ
 
 USER seluser
