Registering a remote Docker host
You must register the remote Docker host with HCL OneTest™ Server before you add the remote Docker host to your project in a team space, which contains the test assets that you want to run on the remote Docker host.
Before you begin
Depending on the mode of connection with HCL OneTest™ Server, you must have set up the remote Docker host computer either for a secured mode or for an unsecured mode of connection.
Procedure
-
Log in to HCL OneTest™ Server.
The team space that contains your project is displayed.
-
Click
in the navigation pane.
The Agents and Intercepts page is displayed.
You can view the agents, intercepts or Dockers that are registered with HCL OneTest™ Server.
-
Click
.
The New docker host dialog is displayed.
-
Enter the host name and the port of the
remote Docker host in the format <host name or
IP_address>:<port> in the Remote Docker
Host field.
If you do not provide the port that you configured for the remote Docker host, then the default port that is used is as follows:
- Port 2375 for the unsecured mode
- Port 2376 for the secured mode
-
Choose from any of the following authentication modes to establish the
connection between HCL OneTest™ Server
and the remote Docker host computer:
- For the secured mode, which is the default mode and the checkbox is
displayed as selected. Perform the following steps:
- Select Secure mode, if it is not selected.
- Click the action labels to browse and select the .pem files that correspond to ca_certificate.pem, client_certificate.pem, and client_key.pem.
Note: You must have generated the .pem files on the remote Docker host computer and copied the files to your local drive. - For the unsecured mode, the Secure mode
checkbox must not be selected. Perform the following step:
- Clear the Secure mode checkbox, if selected.
- For the secured mode, which is the default mode and the checkbox is
displayed as selected.
-
Click Test connection to test if a connection is
established between HCL OneTest™ Server and the remote host computer.
Any of the following events occur when Test connection is clicked:
- On a successful connection, a message is displayed.
- On a failure to connect to the remote host computer, an error message is displayed. You must resolve the error and reattempt to establish a successful connection.
Important: The remote Docker host computer must be connected successfully before you register the remote Docker host with HCL OneTest™ Server. -
Click Register.
The remote Docker host that you registered is displayed.Important: The remote Docker host must be registered successfully with HCL OneTest™ Server in the team space before you add the remote Docker host to your project in that team space.
- Click Close to exit.
Results
You have registered the remote Docker host in your team space with HCL OneTest™ Server.
What to do next
You can view the Docker hosts in your team space that are registered with HCL OneTest™ Server. See Viewing remote Docker hosts that are registered with HCL OneTest Server.
You must add the registered remote Docker host to your project in your team space before you use the remote Docker host as a location to run tests in your project. See Adding a remote Docker host to the project for running tests.