Configuring stubs to connect to HCL Quality Server and the HTTP proxy

A stub running on its own may not be sufficient in some cases, because it might have dependencies on services such as HCL Quality Server or the HTTP proxy. If the stub is running on the public cloud and the services are running in the enterprise, you must configure the stub to connect to these services.

There are many ways in which you can establish communication between the services - for example, by using SSH reverse tunneling or a virtual private network. An example of how to configure the stub to connect to the services by using the SSH reverse tunneling method is as follows:

Assumptions
  • The stub makes available an HTTP transport using port 80.
  • The stub's HTTP transport is configured to use localhost:3128 as a proxy for pass-through.
  • The stub is configured to connect to HCL Quality Server on localhost:5443.
Procedure
  1. In the enterprise, use SSH to connect to the public cloud instance. This creates tunnels for the stub to connect to HCL Quality Server and the HTTP proxy.
    ssh -R 5443:${RTCP_ENDPOINT} -R 3128:${HTTP_PROXY_ENDPOINT} ${DOCKER_HOST_IP}
  2. Start the stub image by using the following command:
    docker run --net=host -p 80:80 -e RULE_HOST=${DOCKER_HOST_IP} -e RTVS_METRIC_MODE=OFF ${DOCKER_IMAGE}
    where, --net=host makes the ssh tunnels accessible to the docker container, and RTVS_METRIC_MODE=OFF switches off metrics reporting (which would result in a logged error in the Starter Edition).
    For example:
    docker run --net=host -p 80:80 -e RULE_HOST=mydockerhost.local -e RTVS_METRIC_MODE=OFF dockerimage

    For information about the docker run command, see Publishing stubs to Docker: Running in a Docker container.

Feedback