Skip to content

Commit bcddcae

Browse files
committed
add proxy gateway docs
Add docs for using proxy gateways to run multiple workers on remote machines
1 parent eb5ac8c commit bcddcae

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/remote.rst

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,20 @@ new socket host with something like this::
6666
pytest -d --tx socket=192.168.1.102:8888 --rsyncdir mypkg
6767

6868

69+
Using proxies to run multiple workers on remote machines
70+
---------------------------------------
71+
72+
In case you want to run multiple workers on a remote machine,
73+
you can create a proxy gateway for the machine, and run multiple
74+
workers using the `via` attribute.::
75+
76+
pytest -d --tx proxy//id=my_proxy//socket=192.168.1.102:8888 --tx 5*popen//via=my_proxy
77+
78+
Here we declare a proxy gateway using the `proxy` attribute, and
79+
create 5 workers that run on the remote server using the proxy.
80+
Note that the proxy gateway does not run a worker, thus only 5
81+
workers are created.
82+
6983

7084
Running tests on many platforms at once
7185
---------------------------------------

0 commit comments

Comments
 (0)