Controlling a remote Hoverfly instance with hoverctl¶
So far, the tutorials have shown how hoverctl can be used to control an instance of Hoverfly running on the same machine.
In some cases, you may wish to use hoverctl to control an instance of Hoverfly running on a remote host. With hoverctl, you can do this using the targets feature.
In this example, we assume that the remote host is reachable at hoverfly.example.com
, and that
ports 8880
and 8555
are available. We will also assume that the Hoverfly binary is installed on the remote host.
On the remote host, start Hoverfly using flags to override the default admin port (-ap
) and proxy port (-pp
).
hoverfly -ap 8880 -pp 8555
See also
For a full list of all Hoverfly flags, please refer to Hoverfly commands in the Reference section.
On your local machine, you can create a target named remote
using hoverctl. This target will be configured to communicate
with Hoverfly.
hoverctl targets create remote \
--host hoverfly.example.com \
--admin-port 8880 \
--proxy-port 8555
Now that hoverctl knows the location of the remote
Hoverfly instance, run the following commands
on your local machine to capture and simulate a URL using this instance:
hoverctl -t remote mode capture
curl --proxy http://hoverfly.example.com:8555 http://ip.jsontest.com
hoverctl -t remote mode simulate
curl --proxy http://hoverfly.example.com:8555 http://ip.jsontest.com
You will now need to specify the remote
target every time you want to interact with this Hoverfly instance.
If you are only working with this remote instance, you can set it to be the default target instance for hoverctl.
hoverctl targets default remote
Note
The --host
value of the hoverctl target allows hoverctl to interact with the admin API
of the remote Hoverfly instance.
The application that is making the request (in this case, cURL), also needs to be configured to
use the remote Hoverfly instance as a proxy. In this example, it is done using cURL’s --proxy
flag.
If you are running Hoverfly on a remote host, you may wish to enable authentication on the Hoverfly proxy and admin API. This is described in the Enabling authentication for the Hoverfly proxy and API tutorial.