From fd403f3cab7081d64778a815f00021ba6390647e Mon Sep 17 00:00:00 2001 From: James Mortensen Date: Thu, 25 Aug 2022 15:34:57 +0530 Subject: [PATCH] Updated README for Dev and Beta channel container images -- added docker-compose files (#1663) Updated README to include information on the Dev and Beta channel container images, and also added a docker-compose file for dev and for beta on the Selenium Grid. [skip ci] --- README.md | 143 +++++++++++++++++++++++++++++ docker-compose-v3-beta-channel.yml | 42 +++++++++ docker-compose-v3-dev-channel.yml | 42 +++++++++ 3 files changed, 227 insertions(+) create mode 100644 docker-compose-v3-beta-channel.yml create mode 100644 docker-compose-v3-dev-channel.yml diff --git a/README.md b/README.md index 4f8e1dac4..b6658e212 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,9 @@ Talk to us at https://www.selenium.dev/support/ * [Quick start](#quick-start) * [Experimental Mult-Arch aarch64/armhf/amd64 Images](#experimental-mult-arch-aarch64armhfamd64-images) +* [Dev and Beta Channel Browser Images](#dev-and-beta-channel-browser-images) + + [Dev and Beta Standalone Mode](#dev-and-beta-standalone-mode) + + [Dev and Beta on the Grid](#dev-and-beta-on-the-grid) * [Execution modes](#execution-modes) + [Standalone](#standalone) + [Hub and Nodes](#hub-and-nodes) @@ -100,6 +103,146 @@ in _this_ repository (SeleniumHQ/docker-selenium) instead of the experimental on ___ +## Dev and Beta Channel Browser Images + +To run tests or otherwise work with pre-release browsers, Google, Mozilla, and Microsoft maintain a Dev and Beta release channel for those who need to see what's soon to be released to the general population. + +### Dev and Beta Standalone Mode + +Here are the instructions to run them in Standalone mode: + +**Chrome Beta:** + +```bash +$ docker run --rm -it -p 4444:4444 -p 7900:7900 --shm-size 2g selenium/standalone-chrome:beta +``` + +**Chrome Dev:** + +```bash +$ docker run --rm -it -p 4444:4444 -p 7900:7900 --shm-size 2g selenium/standalone-chrome:dev +``` + +**Firefox Beta:** + +```bash +$ docker run --rm -it -p 4444:4444 -p 7900:7900 --shm-size 2g selenium/standalone-firefox:beta +``` + +**Firefox Dev:** + +```bash +$ docker run --rm -it -p 4444:4444 -p 7900:7900 --shm-size 2g selenium/standalone-firefox:dev +``` + +**Edge Beta:** + +```bash +$ docker run --rm -it -p 4444:4444 -p 7900:7900 --shm-size 2g selenium/standalone-edge:beta +``` + +**Edge Dev:** + +```bash +$ docker run --rm -it -p 4444:4444 -p 7900:7900 --shm-size 2g selenium/standalone-edge:dev +``` + +### Dev and Beta on the Grid + +**docker-compose-v3-beta-channel.yml:** +```bash +# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3-beta-channel.yml up` +# Add the `-d` flag at the end for detached execution +# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose-v3-beta-channel.yml down` +version: "3" +services: + chrome: + image: selenium/node-chrome:beta + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + edge: + image: selenium/node-edge:beta + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + firefox: + image: selenium/node-firefox:beta + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + selenium-hub: + image: selenium/hub:latest + container_name: selenium-hub + ports: + - "4442:4442" + - "4443:4443" + - "4444:4444" +``` + +**docker-compose-v3-dev-channel.yml:** +```bash +# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3-dev-channel.yml up` +# Add the `-d` flag at the end for detached execution +# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose-v3-dev-channel.yml down` +version: "3" +services: + chrome: + image: selenium/node-chrome:dev + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + edge: + image: selenium/node-edge:dev + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + firefox: + image: selenium/node-firefox:dev + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + selenium-hub: + image: selenium/hub:latest + container_name: selenium-hub + ports: + - "4442:4442" + - "4443:4443" + - "4444:4444" +``` + +For more information on the Dev and Beta channel container images, see the blog post on [Dev and Beta Channel Browsers via Docker Selenium](https://www.selenium.dev/blog/2022/dev-and-beta-channel-browsers-via-docker-selenium/). + ## Execution modes ### Standalone diff --git a/docker-compose-v3-beta-channel.yml b/docker-compose-v3-beta-channel.yml new file mode 100644 index 000000000..677ee3686 --- /dev/null +++ b/docker-compose-v3-beta-channel.yml @@ -0,0 +1,42 @@ +# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3-beta-channel.yml up` +# Add the `-d` flag at the end for detached execution +# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose-v3-beta-channel.yml down` +version: "3" +services: + chrome: + image: selenium/node-chrome:beta + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + edge: + image: selenium/node-edge:beta + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + firefox: + image: selenium/node-firefox:beta + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + selenium-hub: + image: selenium/hub:latest + container_name: selenium-hub + ports: + - "4442:4442" + - "4443:4443" + - "4444:4444" diff --git a/docker-compose-v3-dev-channel.yml b/docker-compose-v3-dev-channel.yml new file mode 100644 index 000000000..1a4bc292f --- /dev/null +++ b/docker-compose-v3-dev-channel.yml @@ -0,0 +1,42 @@ +# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3-dev-channel.yml up` +# Add the `-d` flag at the end for detached execution +# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose-v3-dev-channel.yml down` +version: "3" +services: + chrome: + image: selenium/node-chrome:dev + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + edge: + image: selenium/node-edge:dev + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + firefox: + image: selenium/node-firefox:dev + shm_size: 2gb + depends_on: + - selenium-hub + environment: + - SE_EVENT_BUS_HOST=selenium-hub + - SE_EVENT_BUS_PUBLISH_PORT=4442 + - SE_EVENT_BUS_SUBSCRIBE_PORT=4443 + + selenium-hub: + image: selenium/hub:latest + container_name: selenium-hub + ports: + - "4442:4442" + - "4443:4443" + - "4444:4444"