fixes #7913 docs(nimbus): Update integration test docs for new changes (#7914)

Because
* We have made some changes to how the integration tests are run and
that is not reflected in the current documentation

This Commit
* Updates the docs to match how the tests are currently run
This commit is contained in:
Benjamin Forehand Jr 2022-11-03 13:31:36 -06:00 коммит произвёл GitHub
Родитель e94a94174d
Коммит d123eef686
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 13 добавлений и 5 удалений

Просмотреть файл

@ -389,11 +389,13 @@ For a full reference of all the common commands that can be run inside the conta
Run the integration test suite for experimenter inside a containerized instance of Firefox. You must also be already running a `make up` dev instance in another shell to run the integration tests.
#### make integration_test_nimbus
#### make FIREFOX_VERSION integration_test_nimbus
Run the integration test suite for nimbus inside a containerized instance of Firefox. You must also be already running a `make up` dev instance in another shell to run the integration tests.
#### make integration_vnc_up
FIREFOX_VERSION should either be `nimbus-firefox-release` or `nimbus-firefox-beta`. If you want to run your tests against nightly, please set the variable `UPDATE_FIREFOX_VERSION` to `true` and include it in the make command.
#### make FIREFOX_VERSION integration_vnc_up
First start a prod instance of Experimenter with:
@ -404,19 +406,23 @@ make refresh&&make up_prod_detached
Then start the VNC service:
```bash
make integration_vnc_up
make FIREFOX_VERSION integration_vnc_up
```
Then open your VNC client (Safari does this on OSX or just use [VNC Viewer](https://www.realvnc.com/en/connect/download/viewer/)) and open `vnc://localhost:5900` with password `secret`. Right click on the desktop and select `Applications > Shell > Bash` and enter:
```bash
cd app
sudo mkdir -m 0777 tests/integration/.tox/logs
tox -c tests/integration/
sudo apt get update
sudo apt install tox
chmod a+rwx tests/integration/.tox
tox -c tests/integration/ -e integration-test-nimbus
```
This should run the integration tests and watch them run in a Firefox instance you can watch and interact with.
To use NoVNC, navgate to this url `http://localhost:7902` with the password `secret`. Then you can follow the same steps as above.
#### Integration Test options
- `TOX_ARGS`: [Tox](https://tox.readthedocs.io/en/latest/config.html#tox) commandline variables.
@ -431,6 +437,8 @@ make integration_test_legacy PYTEST_ARGS="-k test_addon_rollout_experiment_e2e"
This builds and sets up the mobile sdk for use in testing.
### Testing Tools
#### Targeting test tool
Navigate to `app/tests/tools`
To test a targeting expression, first add an app context named `app_context.json` to the `app/tests/tools` directory.