Skip to content
This repository was archived by the owner on Jun 30, 2021. It is now read-only.

Commit 588742f

Browse files
committed
Update alternatives in README
1 parent 645c818 commit 588742f

File tree

1 file changed

+16
-5
lines changed

1 file changed

+16
-5
lines changed

README.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,17 +16,28 @@
1616

1717
![docker-selenium-grid](./images/grid_console.png)
1818

19+
### Purpose
20+
The purpose of this project is to have [Selenium][] running as simple and as fast as possible.
21+
1922
<h2 id="official">Official repo</h2>
2023

21-
Note [SeleniumHQ/docker-selenium](https://github.com/SeleniumHQ/docker-selenium) project is more useful for building selenium grids while this one focuses on building disposable standalone seleniums with [video recording support](./docs/videos.md) and both browsers on the same container. It also adds some other features like [customizing the screen size](#screen-size) and [ssh access](#ssh) that can be particularly useful for tunneling support.
24+
Note [SeleniumHQ/docker-selenium](https://github.com/SeleniumHQ/docker-selenium) and this one share the same purpose however both projects have diverged considerably in the last two years, some major differences are:
2225

23-
### Purpose
24-
The purpose of this project is to have [Selenium][] running as simple and as fast as possible.
26+
* both browsers and also the grid are on the same container in this repo
27+
* support for [video recording](./docs/videos.md)
28+
* support for [customizing the screen size](#screen-size)
29+
* support for [ssh access](#ssh) that can be particularly useful for tunneling support
30+
* this image size is considerably larger (around 2.5GB) than the official one which is around 300MB
31+
* process manager: this image uses [supervisord](http://supervisord.org) while the official [uses bash](https://github.com/SeleniumHQ/docker-selenium/blob/master/StandaloneChromeDebug/entry_point.sh)
32+
* release flow: TravisCI docker pushes vs docker.com automated builds in the official repo
33+
34+
Even though both projects share the same purpose is good to have alternatives. Letting both projects grow and learn from each other's success or failures ultimately impacts the final users positively. This doesn't discard that at some point all selenium maintainers will sit together a sprint to coordinate some major changes and cleanup open issues and perhaps we might merge both projects again in the future also.
2535

2636
### Alternatives
2737
If you don't require a real browser [PhantomJS](https://github.com/ariya/phantomjs) might be enough for you.
28-
[Electron](https://wallabyjs.com/docs/integration/electron.html) allows to use the latest Chromium/V8 which might be equivalent to running in Chrome however it sill needs a display so [xvfb][xvfb-electron] is needed. You can also use a paid service like [Sauce Labs][sauce] or [BrowserStack][], note they offer free open source accounts and straightforward [integration with Travis CI](https://docs.travis-ci.com/user/sauce-connect/).
38+
[Electron](https://wallabyjs.com/docs/integration/electron.html) allows to use the latest Chromium/V8 which might be equivalent to running in Chrome however still requires a display so [xvfb][xvfb-electron] is needed. You can also use a paid service like [Sauce Labs][sauce] or [BrowserStack][], note they offer free open source accounts and straightforward [integration with Travis CI](https://docs.travis-ci.com/user/sauce-connect/).
2939
You can also configure [xvfb](https://docs.travis-ci.com/user/gui-and-headless-browsers/#Using-xvfb-to-Run-Tests-That-Require-a-GUI) yourself but it involves some manual steps and doesn't include video recording, nor does PhantomJS nor Electron.
40+
A [new chromium headless project](https://github.com/electron/electron/issues/228#issuecomment-223797342) looks very promising so might we worth to take a look though as of now leaves video recording out of scope there and Firefox of course.
3041

3142
### Usage
3243

@@ -36,7 +47,7 @@ You can also configure [xvfb](https://docs.travis-ci.com/user/gui-and-headless-b
3647

3748
docker pull elgalu/selenium:2.53.0q
3849

39-
docker run --rm -ti --name=grid -p 4444:24444 -p 5900:25900 \
50+
docker run -d --name=grid -p 4444:24444 -p 5900:25900 \
4051
-e TZ="US/Pacific" -e VNC_PASSWORD=hola \
4152
-v /dev/shm:/dev/shm elgalu/selenium:2.53.0q
4253

0 commit comments

Comments
 (0)