backend/e2e/docs/edge.md (view raw)
1### Edge Legacy
2
3**Please Note:**
4This guide assumes that a system with Windows 10 has been set up and the new
5[Microsoft Edge](https://www.microsoft.com/en-us/edge) browser has been
6installed.
7
8To run the tests with Edge, follow these steps:
9
101. Create a `.env` file in the same directory as
11 [docker-compose.yml](docker-compose.yml) and add the following environment
12 variables:
13
14 ```sh
15 SERVER_HOST=<DOCKER_HOST_IP>
16 SERVER_PORT=8080
17 WINDOWS_HOST=<WINDOWS_HOST_IP>
18 WINDOWS_ASSETS_DIR=C:\Users\<USERNAME>\Desktop\assets\
19 ```
20
21 Make sure that the `DOCKER_HOST_IP` is accessible from the Windows machine
22 and the `WINDOWS_HOST_IP` is accessible from a Docker container (see also the
23 [FAQ](FAQ.md)).
24 Also make sure that `WINDOWS_ASSETS_DIR` points to a valid folder path and
25 ends with a backslash.
26
272. Edit the `example` host entry in [etc/windows.hosts](etc/windows.hosts) and
28 set its IP address to the `SERVER_HOST` IP defined in the `.env` file.
29
303. Copy [bin/webdriver.ps1](bin/webdriver.ps1) and
31 [etc/windows.hosts](etc/windows.hosts) to the same folder in the Windows
32 machine (e.g. the Desktop).
33 Also copy the files in the `assets` directory to the folder defined as
34 `WINDOWS_ASSETS_DIR`.
35
364. Create a shortcut to `webdriver.ps1` (via "Right-Click" → "Create shortcut"),
37 then open the properties dialog for the shortcut (via "Right-Click" →
38 "Properties") and set the `Target` property to the following value:
39
40 ```bat
41 powershell -ExecutionPolicy ByPass -File webdriver.ps1
42 ```
43
44 Click "OK" to save the changes to the shortcut.
45
465. Double-Click on the webdriver shortcut to setup and start the servers.
47 Allow `Microsoft WebDriver`, `nginx` and `MJPEGServer` to communicate on all
48 networks in the Windows Defender Firewall dialog.
49
506. Run the tests with Edge:
51 ```sh
52 docker-compose run --rm wdio conf/edge.js
53 ```